Skip to content

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.

  1. VICIdial dials the person. They answer.
  2. VICIdial sends the call to the remote agent. The remote agent dials your agent line over a SIP trunk.
  3. Your agent answers and runs the call. The leg to the agent carries the customer’s number as its caller ID.
  4. Your agent tells Vodial the call started and, later, how it ended and what it found.
  5. 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.

  1. 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.
  2. Add the SIP trunk to your agent in Asterisk.
  3. Add the remote agent.
  4. Add the closer in-group and the number that reaches it. Enter that number in the Closers step.
  5. Press Apply to your agent.
  6. Run the pilot.
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=peer
host=1pv316az391.sip.livekit.cloud
port=5060
transport=tcp
disallow=all
allow=ulaw
allow=alaw
allow=opus ; drop this line if your Asterisk has no Opus codec
; no register line: the agent does not register your server

Example, pjsip.conf. Check against your VICIdial version.

[transport-tcp]
type=transport
protocol=tcp
bind=0.0.0.0
[voiceagent]
type=endpoint
transport=transport-tcp
aors=voiceagent
disallow=all
allow=ulaw,alaw,opus
[voiceagent]
type=aor
contact=sip:1pv316az391.sip.livekit.cloud:5060\;transport=tcp

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/+15551234567

Replace 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.

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.

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.

  1. 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.
  2. In Recent calls, check that the caller’s last four digits are the person’s, and the lead is matched.
  3. In VICIdial, open the lead. Check the status and the comments.
  4. Widen only when those calls are clean.

See test and troubleshoot when one is not.