Readiness messages
Each line in the list starts with the words below. Errors block publishing. Only Add a Persona also stops a Playground call from starting; with any other error the call starts without the part that is broken. Warnings block nothing, but the agent will be missing something. One exception: a missing provider key also blocks starting a Playground call. In Simple, each step lists the items that belong to it. Fix an item in the field its step shows; for anything else, Change in Advanced next to the item opens that node in Advanced, which is what “select” means in the table below.| The list says | Error or warning | What to do |
|---|---|---|
| Ready to test | Neither | Nothing is missing. Open the Playground. |
| Needs attention (N) | Pill | N items. Click the pill, or open the Playground or Publish, to read them. |
| Add a Persona. Every agent starts with one | Error | Open Components and click Persona. |
| This agent has N Personas but only one can run | Warning | Delete the extra Persona. Only the first one runs. |
| The Persona needs a name / a personality / a name and a personality | Warning | Fill in Name and Personality and instructions: in Simple’s Who step, or in Advanced by selecting the Persona. |
| Add a Skill and connect it to the Persona | Warning | Open Components, click Skill, and connect the Persona to it. |
| Skill “name” has no instruction | Warning | Fill in Instruction, the first field: in Simple, open the Skill in What it does; in Advanced, select the Skill. |
| Skill “name” is not connected | Warning | Connect it from the Persona, another Skill, If/Else or Categorize, or delete it. |
| Skill “name” has a time or round limit but nothing comes after it | Warning | Connect a next step after it, or set the limit back to 0. When the limit is reached with nothing connected, the call hangs up. |
| Skill “name” has Can Transfer To Human on, but no SIP Transfer tool with a phone number is connected | Warning | Connect a SIP Transfer tool with a number to the Skill or the Persona, or turn Can Transfer To Human off under More settings. |
| Skill “name” hangs up the call when it finishes | Warning | The Skill has the older End After This Skill setting on. If the call should continue, select the Skill in Advanced (in Simple, Change in Advanced next to the warning opens it), open More settings and turn it off, then connect an End node where the call should finish. |
| Calendar “name” has no Event Type ID | Error | Enter the Cal.com event type number, or delete the tool and take booking out of the Instruction. |
| Calendar “name” has an Event Type ID but no Cal.com API key | Warning | Paste the key in Settings, or ask your workspace admin to set it. |
| Pinecone “name” has no index name | Error | Select the Pinecone tool and enter Index Name. |
| MCP “name” has no server URL | Warning | Enter the Server URL or delete the tool. |
| SIP Transfer “name” has no phone numbers | Warning | Add at least one number or delete the tool. |
| ”name” is not connected to the Persona or a Skill | Warning | Drag a line from the tool to the Tools dot of the Persona or a Skill. |
| ”name” has no URL, so nothing will be sent after the call | Warning | Enter the address on the Webhook node. |
| ”name” has no categories | Warning | Add the categories you want to route on. Until then it uses Sales and Support. |
| ”name” is a simulated action | Warning | Fine for testing. Replace the Simulated action with a real tool before you publish. |
| Only one X tool runs per agent, so “name” is ignored | Warning | Applies to Human Handoff and SIP Transfer. Keep one of each per agent. Delete or merge the duplicate. |
| The voice “x” belongs to Soniox, but the Persona uses Y / Y needs a Voice ID | Warning | Open the Persona’s Voice (TTS) section and pick a voice from the selected provider. |
| The Persona speaks X but its voice is set to Y | Warning | Callers hear the voice language. Open the Persona’s Voice (TTS) section and click Clear on the line that says the voice language is set, so the voice follows the Persona’s language. |
| The avatar is set to X but has no ID | Warning | Add the avatar’s ID, or turn the avatar off under More settings. |
| ”name” is ignored because this agent also has a Persona | Warning | An agent runs either a Persona or a speech-to-speech agent (Realtime Agent). Delete one. |
| ”name” is an old node type that no longer runs | Warning | Delete it and rebuild that part with a Persona and Skills. |
| ”name” is missing X. Fill it in before going live. | Warning | Select the node and fill in the named field. The field is marked required in the editor. |
| Add your X API key in Settings | Warning | Blocks Start conversation in the Playground until the key is entered, but does not block publishing. Open Settings and paste the key, or ask your workspace admin. See Keys. |
| X is not set up on this workspace. Ask your workspace admin to add it. | Warning | Email, text messages, AWS and Azure Speech are set up for the whole workspace and have no field in Settings. Ask your workspace admin. |
| A connection points to a node that no longer exists / cannot connect to the “slot” of | Warning | Delete the connection. The message lists which dots accept what. |
| Published | Pill | The canvas matches the live version. Nothing to do. |
| Changed since publish | Pill | You edited the agent after publishing. Callers still get the old version. Test, then Publish this version again. |
Playground problems
| You see | What to do |
|---|---|
| Connecting to your voice agent… or Waking the agent… attempt N of M for more than a minute | Click Cancel and start again. If it repeats, your workspace may be at capacity. Wait a minute and retry, or ask your workspace admin. |
| You already have the maximum number of active voice sessions. | An earlier call is still holding a slot. End it from Dashboard → Live, or wait a few seconds and try again. |
| The agent did not join the call. Try again in a moment. | The voice service did not pick up the call within a few seconds. Retry once. If it repeats on a hosted workspace, contact your workspace admin. Show details has the technical reason. |
| Could not connect to the call. Check your internet connection and try again. | Your browser could not reach the voice service. Check your network, VPN or firewall, then try again. |
| Failed to start session with a reason | Read the reason. A missing key or a provider rejecting the key is the usual cause. Fix it in Settings and start again. |
| The agent connects but says nothing | The voice provider could not speak. Check the TTS key in Settings, or switch the Persona to a provider your workspace covers. Try Text only mode to confirm the rest works. |
| The agent cannot hear you | Allow the microphone in the browser, and make sure the right microphone is selected in your system settings. Try Type → Voice to confirm the agent itself is fine. |
| Tap to enable audio | The browser blocked sound until you interact. Click the button. |
| The agent talks about booking but never books | The Calendar tool was dropped or is not connected to this Skill. Check the readiness list and the tool’s connection. |
| The agent ignores a branch | Make the Condition, or the How to sort text and Categories, more concrete, and make sure each output is connected. Watch the canvas during the call to see where it goes. |
| The call never ends | Every path needs an End node. Add one after the last Skill. |
| Draft and Live behave differently | Live is the last published version. Publish again after testing Draft. |
AI builder problems
| You see | What to do |
|---|---|
| An error with Try again | Click it. Your description is kept. If it fails again, shorten the description or remove attachments. |
| It keeps asking questions | Click Build it with what you have. It stops asking and builds from what it knows. |
| The result is not what you meant | Describe the difference in the composer, for example “The billing path should end after opening a ticket, not transfer to a person.” Each change is a version you can restore. |
| It takes a long time | Builds take about a minute. Cancel while it is thinking if you want to change your description. |
Publishing and sharing
| You see | What to do |
|---|---|
| Publish this version is disabled | There are readiness errors. Fix them. Warnings do not block publishing. |
| Share is greyed out | Publish once first. Share needs a published version. |
| A share link stopped working | The call page says why: it expired, was turned off, or has been used for all the calls it allows. Make a new one in Share. |
| A caller on a share link is told to try again | The link is already in as many calls as it can take, or the service is busy. The refused call does not count against the link. |
| The embedded call panel is blank or refused on a site | The site is not in the link’s Embed on websites list, or the list names http:// where the site is https:// (or the reverse). Make a link that lists the site exactly, including www. if the site uses it. |
| Callers on a share link hear an old version | A link keeps the version that was published when the link was made. Publish, then make a new link. Phone numbers move to the new version automatically when you publish. |