VICIdial dials, your agent answers
Your VICIdial keeps dialing your list. When a person answers, VICIdial hands the call to a remote agent. That remote agent is your voice agent. Vodial is not on the voice path. It listens for what your agent reports, files the result, and writes the status back to your VICIdial.
How a call travels
Section titled “How a call travels”- VICIdial dials the person. They answer.
- VICIdial sends the call to the remote agent. The remote agent dials your agent line over a SIP trunk.
- Your agent answers and runs the call. The leg to the agent carries the customer’s number as its caller ID.
- Your agent tells Vodial the call started and, later, how it ended and what it found.
- Vodial finds the lead by that number, files the result, and sets the status and a comment on the lead in VICIdial.
The leg to your agent carries the customer’s number, and that is how Vodial finds the lead. VICIdial’s own source sets the remote agent’s caller ID to the customer’s phone number, so you do not need to add anything. If your set-up replaces it with your own caller ID, Vodial cannot find the lead.
Do this
Section titled “Do this”- In the wizard, choose your VICIdial. Enter your agent line number, and your VICIdial’s public IP as the allowed address. See connect your voice agent.
- Add the SIP trunk to your agent in Asterisk.
- Add the remote agent.
- Add the closer in-group and the number that reaches it. Enter that number in the Closers step.
- Press Apply to your agent.
- Run the pilot.
The SIP trunk to your agent
Section titled “The SIP trunk to your agent”| Setting | Value |
|---|---|
| Host | 1pv316az391.sip.livekit.cloud |
| Port | 5060 |
| Transport | TCP |
| Codecs | ulaw, alaw, opus |
| Registration | None. Do not add a register line. |
| Who is allowed | Your agent accepts calls from the addresses you gave the wizard. |
Example, sip.conf. Check against your VICIdial version.
[general]tcpenable=yes
[voiceagent]type=peerhost=1pv316az391.sip.livekit.cloudport=5060transport=tcpdisallow=allallow=ulawallow=alawallow=opus ; drop this line if your Asterisk has no Opus codec; no register line: the agent does not register your serverExample, pjsip.conf. Check against your VICIdial version.
[transport-tcp]type=transportprotocol=tcpbind=0.0.0.0
[voiceagent]type=endpointtransport=transport-tcpaors=voiceagentdisallow=allallow=ulaw,alaw,opus
[voiceagent]type=aorcontact=sip:1pv316az391.sip.livekit.cloud:5060\;transport=tcpThe remote agent
Section titled “The remote agent”In VICIdial, add a remote agent to the campaign it dials. Leave it on-hook, since nobody sits at a phone. Set its external extension so that it dials the agent line through the trunk. Set the number of lines to how many calls your agent should take at once.
SIP/voiceagent/+15551234567Replace the number with your agent line. With pjsip it is PJSIP/+15551234567@voiceagent. If your VICIdial does not take a dial string in that field, point the extension at a short dialplan entry that dials the same thing. Ask whoever runs your Asterisk.
Closers
Section titled “Closers”Make an in-group for your closers and a number that reaches it, such as a DID into VICIdial. Enter that number in the Closers step. The agent’s transfer tool then rings it.
Cold is the default. Your agent asks your Asterisk to pass the caller on, and Asterisk can do that. Warm also needs the host in “Termination host”, and a peer in Asterisk that accepts the agent’s call. The voice platform does not publish a fixed list of addresses it calls from, so cold is simpler.
What Vodial writes back
Section titled “What Vodial writes back”When your agent reports the analysis, Vodial sets the result (see your voice agent), then sets the VICIdial status through your connection’s status map. The built-in map is in connect your VICIdial. Each status must already exist in VICIdial.
Agent outcome |
VICIdial status |
|---|---|
transferred |
XFER |
qualified_not_transferred, callback |
CALLBK |
not_qualified, not_interested, abusive |
NI |
do_not_call |
DNC |
hung_up |
DROP |
wrong_number |
DC |
Vodial also sets the lead’s comments to a block labelled Voice agent: the summary your agent wrote, then the facts. VICIdial keeps 255 characters, so Vodial keeps the summary and as many whole facts as fit. VICIdial replaces what was in comments before.
If two VICIdial leads share the number, Vodial uses the newest lead and marks the call ambiguous in Recent calls.
Run a pilot
Section titled “Run a pilot”- Use a small list of numbers you control, in a campaign of its own. Place a few calls. Let some qualify and one hand over.
- In Recent calls, check that the caller’s last four digits are the person’s, and the lead is matched.
- In VICIdial, open the lead. Check the status and the comments.
- Widen only when those calls are clean.
See test and troubleshoot when one is not.