DocsHelp
Troubleshooting
Start with the saved setting, then the connection, then the phone company.
By the Callaroo team. Updated November 2026
Most problems are one of three things: the setting was not saved, the tool or capability is not set up, or the call never reached the assistant. Check them in that order before changing several things at once.
Quick checks
| Symptom | Check first | Then |
|---|---|---|
| The assistant does not use a new instruction | Was Save settings selected? Try it live uses saved settings only. | Make a new call. A call in progress keeps its old settings. |
| It cannot find an item | Is the item saved and Available on the Menu page? | Add the item or turn availability back on, then test again. |
| It quotes an old price | Is the price current in Menu? | Existing orders keep their saved price; new orders use the new one. |
| An order was not saved | Did the caller explicitly agree to the read back? | Try it live cannot save an order. Use a real call. |
| A transfer does not happen | Is a staff transfer number saved in Agent settings? | Transfer also needs a live phone connection. Offer a callback if not. |
| A text is not sent | Is messaging enabled and the registration approved? | A text also needs the message service connected. Check Messages and Billing. |
| No reservation times are offered | Is Reservations enabled with a weekly schedule? | Check party size, date and the saved booking window. |
| Try it live will not open | Are you an owner or manager? | Check microphone permission and whether the browser test is enabled for the workspace. |
| A saved chat is missing | Is the correct workspace selected? | Saved chats appear under Conversations; check the period and your role. |
| A blocked number still gets through | Is the number saved with a verified caller ID? | Inbound filtering is not verified until a real blocked call is rejected. |
| No recording is available | Was recording enabled at the phone company? | Storage must also be configured. The transcript is separate. |
Try it live will not start
- Only owners and managers can open Try it live. A staff member should ask an owner.
- Save the agent first. The panel uses the last saved settings.
- The browser needs microphone permission for voice. Typed chat still opens the line, so a message can fail for a different reason than the microphone.
- The line closes after a reply, on Pause or Stop, and after a muted stretch. Start it again for another turn.
- If the panel opens but no reply arrives, the dashboard server may be missing its voice service key or the live test may be disabled. Contact support; do not put a key in the browser.
A real call fails but the browser test works
The browser test uses the same saved settings and voice service, but not the phone company. A real call also needs an active number, forwarding or a direct dial to that number, and a working voice transport.
Check the number status on the workspace or billing page. Pending or failed means the call cannot arrive yet.
If you forward your own line, confirm the forwarding is still active with your phone company.
Check the transfer number if the call needs a person. A missing number disables transfer.
Check messaging separately; a text can fail while voice works.
Make one call, then open the conversation. If no conversation exists, the call did not reach Callaroo.
Settings do not seem to apply
- Select Save settings. The button is disabled when there is nothing new to save.
- Start a new call or a new Try it live line. An existing call keeps the settings it began with.
- Check the correct workspace. A user can belong to more than one, and each has its own agent.
- If a control shows a settings update notice, the workspace has not received that change. Ask support.
Saved chats and conversations
Try it live chats are saved as workspace conversations with a Try it live label. They include the text turns and the line duration, not audio and not phone minutes. If a chat is missing, check the workspace selector, the reporting period and whether the save returned an error. Staff can read saved chats; only owners and managers can start the test.
What to send support
- The workspace name and the page you were on.
- The time of the call in UTC, and the conversation link if one exists.
- What you expected, what happened, and whether it was a browser test or a real call.
- The number's last four digits, not the full number, and never a card number or password.
- A screenshot of the error, with any customer name or phone number covered.
Do not change several settings at once before testing. It becomes impossible to tell which change fixed the problem, and a working setup can be lost.