DocsHow-to
Take pickup orders
The assistant builds the order item by item and confirms it only after the caller agrees.
By the Callaroo team. Updated November 2026
The menu is the source
Orders come from the menu saved for this workspace. Item names and prices are read from stored data, so the assistant cannot offer something you do not sell or quote a price you did not set. If an item is marked unavailable, it is not offered.
The current Menu page edits name, price and availability. Categories, aliases and modifiers are not editable there. If your menu was imported with those details, the assistant can use them; if it was not, a modifier is a note for the kitchen rather than a priced choice.
Swipe the diagram sideways to see the full flow.
A draft is read back and confirmed. A large order may go to review before staff approve it.
What a caller is asked
- Which items and how many. An order can have 1 to 30 lines, with 1 to 50 of each item.
- Any saved choice that belongs to the item, or a note such as no onion. A line note can be up to 200 characters.
- A pickup time, if the caller wants one. The assistant repeats the time; it does not calculate kitchen capacity.
- A name for the order, up to 60 characters. It should ask once and keep the name.
Read-back and confirmation
The assistant repeats the current order, including quantities, notes and pickup time.
The caller agrees out loud and corrects anything that is wrong.
The assistant confirms the same version it read back. A change after the read back needs a new read back.
The confirmed order appears in Orders with a four-digit short code.
An order above the review threshold is saved as needs_review instead of confirmed. Staff must approve it. Check Orders before the caller arrives.
What gets saved
- A snapshot of the items and prices at the time of the order, so a later menu change does not rewrite it.
- The customer name, pickup time, notes and the conversation it came from.
- The status and a short code that is unique among active orders.
- The tool activity, so you can see what the assistant looked up and what it wrote.
Order statuses
| Status | Meaning | Allowed next |
|---|---|---|
| Draft | Being built. It is not ready for the kitchen. | Needs review or confirmed after the read back and the caller agrees. |
| Needs review | Saved for staff attention, for example above the quantity threshold. | Confirmed or cancelled by staff. |
| Confirmed | Saved for the restaurant to prepare. | Preparing or cancelled. |
| Preparing | The kitchen is working on it. | Ready or cancelled. |
| Ready | Waiting for pickup. | Completed. |
| Completed | Handed over. Terminal. | No further change. |
| Cancelled | Cancelled. Terminal. | No further change. |
Cancelling an order and approving a needs-review order require a preview and a second, explicit staff confirmation on the Orders page. The page shows up to 100 active orders.
The review threshold
By default, an item quantity above 20 puts the order into review. The workspace can also have a total-value threshold; if it is set, an order above it goes to review. Review is not a failure: the order is saved and a person decides whether to approve it.
Payment and modifiers
- The assistant does not take payment. Collect payment the way you already do at pickup or collection.
- It has no payment tool. If a caller offers card details, stop them and explain how you take payment.
- Modifiers are read from stored menu data. If the item has none, use a line note for a kitchen instruction.
- Allergy questions need a person. Take the detail and confirm the order before it is prepared.
Test an order
Use Try it live to check the wording and the menu lookup. It cannot save an order.
Make a small real call and ask for two items, one note and a pickup time.
Change one item before confirming. The assistant should read the whole order back again.
Open Orders and check the items, note, name, pickup time, status and short code.
Open the linked conversation and compare what was said with what was saved.
Order tools explains the four caller order tools, their limits and the errors they can return. Staff order tools covers the six workspace tools, including status changes, callbacks and blocking a number.