DocsHow-to
Set up the assistant
The Agent page is where you decide what the assistant knows, what it may do and how it sounds.
By the Callaroo team. Updated November 2026
Open Dashboard → Agent. The page has two tabs: Configuration for what the assistant knows and may do, and Speech for how it sounds. Owners and managers can change settings; staff can read the page but cannot save changes.
A change is not live until you select Save settings at the top of the page. New calls use the saved version. A call already in progress keeps the settings it started with, and Try it live uses the last saved version, not unsaved edits.
Configuration tab
Welcome message
The welcome message is the first line a caller hears. It is on by default. Keep it short: the business name, a greeting, and any recording or transcription notice your jurisdiction requires. The greeting can be up to 500 characters. If the welcome is off, the assistant waits for the caller to speak.
Shop notes
Shop notes are your directions to the assistant. Write them the way you would explain the job to a new hire: facts, policies and the practical details that are not in the menu or the schedule. The field holds up to 8,000 characters.
- Address, parking, directions and the pickup entrance.
- Ready time, large-order policy, allergen caution and anything callers ask every day.
- What to do when a person is needed: transfer when staff are available and a number is saved; otherwise ask the caller whether they want a callback.
- Holiday exceptions and temporary changes. Put normal opening hours in the reservation schedule, not only here.
- Do not paste a script. The notes are private directions, and the assistant is told not to read them aloud or repeat example sentences.
Guardrails
Guardrails are short rules that come before shop notes and tool results. They are the right place for privacy, tone, when to stop and what never to do. Each rule has a name, a description and an on/off switch. A workspace can hold up to 12 rules.
Read Write guardrails for the default rules, how to add one and examples. Privacy is handled by a built-in instruction as well as any guardrail you add, so the assistant does not share shop totals or other customers' information.
Tools
The Tools list shows every caller tool with an on/off state and a short rule for when it may be used. Select a row to edit its Use only when text, or open the menu to turn it off. Each tool has a fixed ID that cannot be renamed.
- A tool can be on and still need setup. Transfer needs a saved staff number. Text needs messaging. Reservations need a schedule.
- Web search is off by default. Turning it on requires a specific public-information reason; the default text is not accepted.
- Staff tools are not shown as caller switches. They run only through a signed-in staff account.
- Save changes in the tool dialog, then Save settings on the page. The dialog alone does not apply the change.
Read Choose when tools run for the default rule behind every tool and the difference between a description and a permission.
Call behaviour
| Setting | What it does |
|---|---|
| Caller can interrupt | On: the caller can talk over the assistant. Off: the assistant finishes its line. On by default. |
| Know caller's phone number | On: a new call can use the verified number for an agreed order, booking or text. Off by default. The number is not shown on the Agent page. |
| Staff transfer number | The number a caller is sent to when a transfer is requested. Use international format, for example +12125551234. Transfer also needs a working phone connection. |
The transfer number is not a general outbound number. The assistant does not cold-call customers. A callback request goes into the Callbacks queue for a person to ring back.
Speech tab
| Setting | Options |
|---|---|
| Voice | Ara, Eve, Leo, Rex or Sal. Eve is the default. |
| Language | Automatic, or a specific language: English, Spanish (Mexico or Spain), French, German, Italian, Portuguese (Brazil or Portugal), Arabic (Egypt, Saudi Arabia or UAE), Hindi, Bengali, Chinese, Japanese, Korean, Indonesian, Turkish, Russian or Vietnamese. |
| Speaking speed | 0.7×, 0.8×, 1.0×, 1.2× or 1.5×. |
| Follow-up after silence | After the assistant finishes, wait 1 to 60 seconds, then ask once if the caller still needs help. Default 8 seconds, on by default. |
| End call after silence | Hang up after another quiet stretch. Off by default. If follow-up is on, the question happens first. |
Voice, language, speed and silence handling are saved for the next call. A real call still needs the call service and a connected number; a browser test can use the same saved settings without a phone line.
What applies when
- Save settings applies the change to the next call.
- A call already in progress keeps the settings it began with.
- Try it live uses the last saved settings. Unsaved edits are not part of the test.
- A workspace that has no saved schedule is told not to invent opening hours.
What these settings do not do
- They do not train an outside service on your business. They are instructions read at call time.
- They do not give the assistant a way to take a payment.
- They do not let a caller hear shop totals, sales or another customer's information.
- They do not override a capability that is switched off. A disabled tool stays unavailable.
Limits
- Greeting
- 500 characters
- Shop notes
- 8,000 characters
- Guardrails
- 12 rules; name 80 characters; description 600 characters
- Tool description
- 600 characters; up to 20 saved descriptions
- Silence
- 1 to 60 seconds; default 8
- Speed
- 0.7× to 1.5×
If Guardrails, tool descriptions or individual switches show a database-update notice, the workspace has not received that settings update yet. Keep using the existing settings and ask support. Do not edit the database directly.