DocsReference
Tools the assistant can use
Every tool, who can use it, what it needs switched on, and what it will never do.
By the Callaroo team. Updated November 2026
A tool is the only way the assistant changes the business records your team works from. It cannot edit an order, book a table or send a text by improvising: it has to call a named tool, and that tool checks the workspace before it writes anything. The catalog below is the real one. It lists 16 tools today.
Two families, one catalog
- Caller tools
- 10, used during a call with a customer
- Staff tools
- 6, used from the signed-in staff workspace
- Total
- 16 tools
- Scope
- One workspace per tool call
Caller tools shape the conversation: they look things up, save drafts, take bookings and hand the caller to a person. Staff tools work on the other side of the call: they read order history, count sales, move a ticket through the kitchen and queue follow-up work.
Web search is separate from this catalog. It is a outside search that the voice service can run for current public information, it is not counted among the 16, and it never reads your menu, orders or reservations.
The 10 caller tools
- create_order
- Save a draft order with a snapshot of the menu
- update_order
- Change a draft using its current version
- confirm_order
- Confirm only after the read back and the caller agrees
- create_callback_request
- Queue a callback for staff; it does not dial the customer
- check_availability
- Offer only the reservation slots your schedule returns
- book_appointment
- Save a booking after the caller agrees
- cancel_appointment
- Cancel a booking the caller owns
- send_sms_confirmation
- Request a text only when messaging is approved and connected
- transfer_to_staff
- Dial the transfer number saved in Agent settings
- end_call
- Hang up through the phone company, politely
Ordering tools
Three tools build a pickup order: create a draft, update it when needed, and confirm it. They are described in full on the Order tools page, including line limits, version checks, the review queue and the short code a confirmed order receives.
- Order tools validate the available item and stored price against your saved menu.
- create_order saves a draft with a menu snapshot, so a later price change does not rewrite history.
- update_order applies add, remove, quantity, note and pickup-time changes against the draft's current version.
- confirm_order succeeds only after the order has been read back at the same version and the caller has agreed.
Booking and callback tools
- check_availability asks the reservation service for real openings. The assistant can only offer the slots it receives.
- book_appointment saves a reservation after a trusted agreement on the offered slot, party size and name.
- cancel_appointment cancels a booking the caller owns; it does not cancel an arbitrary reservation by number.
- create_callback_request records the reason, name, optional preferred time and the verified caller number as work for staff. It does not place an outbound call.
Messages, transfer and hang-up
- send_sms_confirmation can reference an order or a reservation. Success means the phone company accepted the message, not that the handset displayed it.
- transfer_to_staff asks the phone company to dial your saved transfer destination. It only reports a transfer when the phone company acknowledges it; otherwise the call stays open.
- end_call asks the phone company to end the call. Whether it is available depends on the phone connection, not only on a dashboard setting.
The 6 staff tools
- get_recent_orders
- Read a bounded slice of order history
- get_order_details
- Read one order by ID or active short code
- count_item_sales
- Count an item's sales over a time window
- update_order_status
- Apply one allowed status transition
- queue_customer_callback
- Queue staff follow-up for an order
- block_number
- Add a number to the workspace blocklist
Staff tools run with the signed-in membership, so one business cannot read or change another business's orders. Cancelling an order, approving a review order, queueing a follow-up and blocking a number use a preview and a trusted confirmation before they write. The Staff order tools page covers the arguments, the status path and the confirmation rules.
What has to be switched on
- Ordering needs a published menu with available items, prices and any modifiers.
- Reservation tools need the reservations capability and a weekly schedule with opening windows.
- send_sms_confirmation needs messaging enabled, an active messaging state, an approved number and a connected message service.
- transfer_to_staff needs a saved transfer number; without one transfer is unavailable, and a caller can ask for a callback.
- end_call and transfer also depend on a phone connection that can end or hand off a call.
- Staff tools need a signed-in member of the workspace. A visitor or a member of another workspace cannot use them.
Rules every tool follows
- The workspace comes from signed-in workspace, never from a number the assistant supplies.
- Arguments are validated on the server before any read or write.
- Menu items, prices, slots and order state come from stored data, not from the its own guess.
- A tool that writes a record logs the request and the result against the call, so a repeated request does not create a second record.
- Order changes use version checks, so an old read back cannot overwrite a newer draft.
- A failure is returned as an error the assistant can explain. It is never reported to the caller as success.
- Cancelling an order, approving a review order, queueing a follow-up and blocking a number require a preview and a trusted confirmation tied to the exact action.
What the tools never do
- Take a card payment or process a caller's card details.
- Invent an item, price, opening time, table or pickup slot.
- Call a customer on their own, or run a marketing campaign.
- Read another workspace's orders, conversations or callers.
- Let the assistant approve its own cancellation, refund or block.
- Turn a failed transfer or text into a success message.
Where each result appears
- Menu
- The items and prices available to order
- Orders
- Drafts, confirmed orders, review flags and short codes
- Reservations
- Bookings and cancellations created by calls
- Callbacks
- Callback requests and staff follow-ups
- Messages
- The delivery state the phone company reported
- Conversations
- Transcript, summary, outcome and tool activity
- Blocked numbers
- Numbers on the blocklist; verify inbound filtering on a real call
If a page describes a tool you cannot see in your workspace, the capability behind it has not been enabled for your business yet. Ordering works from your menu; reservations, messaging and transfers each need their own setup.