Test and troubleshoot
Test your voice agent
Section titled “Test your voice agent”A test call talks to your real, published voice agent from the browser, with your microphone. It runs nothing but that agent.
- Open Setup, then Integrations. On the Voice agent card, press Test it.
- Press the start button and talk. The transcript fills in as you speak, and “What the bot did” lists the tools your agent used.
- Press End the test, or close the drawer or leave the page. Each of these ends the call.
- Wait a few seconds. “What the agent recorded” shows each analysis field with the agent’s reason, and the criteria results. The test does not play back a recording: the recording of a real call is stored with the call under Recent calls.
What to know:
- A test opens no journey and writes nothing to VICIdial.
- After the call, Vodial asks for the analysis every 3 seconds for up to 90 seconds. A test is never sent by webhook, so it works before you press Apply to your agent.
- Platform operators can run the same test from the platform console: in Test a bot, choose the engine Voice agent (hosted). It runs the company’s own voice agent, and the test shows in the company’s Recent calls as a test call. The option is greyed out, with the reason, when the company has no voice agent connection and the platform has no key.
Recent calls
Section titled “Recent calls”Under the Voice agent card, Recent calls lists every call your agent took: the time, the caller’s last four digits, where it came from, the lead, the outcome, and one chip for each step. Open a row to see the agent’s analysis, the call’s timeline and any error, for support.
| Step | Done means |
|---|---|
| Facts | The analysis fields are on the person’s record. |
| Disposition | The result (the disposition) is set from the outcome. |
| VICIdial | The status and comment are written to the lead. Only on the VICIdial way. |
| Recording | The agent’s recording is stored in Vodial. |
A step is done, waiting or failed. A call that reached your agent always has a row, even when every later step fails. That is how you see a gap instead of silence.
What each failure means
Section titled “What each failure means”| You see | It means | Do this |
|---|---|---|
| Line: Not set up, Being set up or Has a problem | There is no line yet. Your agent has no phone number that names it, or the line was refused. | Check the line number looks like +15551234567 and the allowed addresses are right. Press Apply to your agent again. |
| Your agent tells Vodial how each call went: Not in place | Your agent is not sending events to Vodial’s current addresses. Calls still happen, but results do not arrive. | Press Apply to your agent. Check that the webhook address on your domain is open to the internet. |
| “Your agent has unpublished edits” | Apply to your agent stopped. Your team has edits in the draft that are not published. | Publish and apply again, or confirm to publish them with Vodial’s settings. |
| “The voice platform account is out of credit” | The test could not start because the account has no credit. | Add credit on your voice platform. If live calls stop reaching the agent, check the balance first. |
| Recording: done, but shorter than the call | The audio for one side ended early. Vodial keeps what it could read, and marks the file as cut short on its side. The screens do not show that mark yet. | Compare the recording’s length with the call’s length. Ask support if it happens often. |
| Recording: waiting | The audio is still being processed. | Wait. Vodial tries again for up to 2 hours, then marks it unavailable. The call keeps its transcript, facts and result. |
| “An apply is already running for this connection” | Another Apply on the same connection has not finished. | Wait, press Check again, then Apply to your agent if needed. |
compliance_notice_failed on a call |
On Vodial’s own lines your rules need a notice and Vodial could not play it, so it did not hand the call to your agent. | Check the text-to-speech service, then try again. |
| “Agent unreachable” on a call | On Vodial’s own lines, your agent did not answer within 15 seconds. | Check the line is active, the allowed address is Vodial’s public address, and the voice platform account has credit. |
If a webhook is lost, a call is not lost. Vodial asks your voice platform about any call that is still not analysed 10 minutes after it ended, and fills in the rest.
A call shows no lead
Section titled “A call shows no lead”Vodial finds the lead by the caller’s number, so start with the caller ID.
- In Recent calls, look at the last four digits of the caller. They should be the customer’s, not yours.
- On your VICIdial, the leg to your agent carries the customer’s number by itself. If you see another number, something in your Asterisk replaced it. Look for a caller ID forced on the trunk to your agent, such as a
callerid=line on the peer or a dialplan line that sets the caller ID, and remove it. - If the customer’s number is there but no lead matches, the lead may be missing from both systems. The call is still kept: Vodial files it on a new person made from the caller number, and the lead column says so.
- Vodial writes a status to VICIdial only when VICIdial’s own search finds the lead by that number. Otherwise the result is kept in Vodial and nothing is written to the wrong lead.