How to connect Plivo to VICIdial

To connect Plivo to VICIdial you create a Plivo Zentrunk (their SIP trunking product), choose an IP Access Control List or credentials, then add a matching SIP SIP trunk carrier entry in VICIdial. A static-IP server lets you use the IP-ACL path and skip the register line.

Get the trunk from Plivo

In the Plivo console, open Zentrunk and create an outbound trunk. Plivo authenticates either with an IP Access Control List (whitelist your server IP) or a Credentials List (a SIP username and password). Plivo shows you the termination SIP domain to dial out to. For inbound, create an inbound trunk and bind a DID (direct inward dialing) to it, pointing the origination at your server.

• Copy the Plivo termination SIP domain off the trunk page.
• Add your server's public IP to the IP Access Control List, or create a Credentials List.
• Set the inbound trunk origination URI to sip:<your-server-ip>.

Add the carrier in VICIdial

Open Admin then Carriers then Add New Carrier. If you used the IP-ACL, leave the Registration string blank and pin the host. If you used a Credentials List, set register => user:pass@<plivo-sip-domain>.

Account Entry:

• [plivo] / disallow=all / allow=ulaw / type=friend / context=trunkinbound
• host=<your Plivo SIP domain> / dtmfmode=rfc2833

Set Protocol to SIP. Plivo accepts E.164, so dial the +1 number. With campaign dial prefix 9, strip the 9 and prepend +1:

• exten => _91NXXNXXXXXX,1,AGI(agi://127.0.0.1:4577/call_log)
• exten => _91NXXNXXXXXX,2,Dial(SIP/plivo/+${EXTEN:1},,tTor)

Set Server IP, set Active to Y, save, and give it about a minute to regenerate the conf files.

Outbound and inbound are two trunks

The one thing that trips people up with Zentrunk is that outbound and inbound are configured separately. The outbound trunk decides whether Plivo accepts the INVITEs your server sends; the inbound trunk decides where Plivo sends calls for your numbers. A working outbound trunk does not give you inbound for free. For inbound, the context=trunkinbound line on your Account Entry passes the call into VICIdial's DID (direct inward dialing) handling, and the dialed digits Plivo sends must match a DID you have created under Admin then Inbound then DIDs.

Caller ID on outbound is set per campaign in VICIdial; Plivo will only present a number you actually own on the account, so make sure your campaign caller ID is a DID (direct inward dialing) you have purchased. Pinning allow=ulaw keeps the Codec negotiation simple — plain G.711 in both directions means no transcoding and predictable audio.

The call path

flowchart LR
  A[VICIdial Carrier plivo] -->|outbound trunk| B[Plivo Zentrunk]
  B --> C[PSTN]
  C -->|inbound DID| D[Plivo inbound trunk]
  D -->|origination URI| E[trunkinbound]
  E --> F[Ingroup]

Verify it

Run sip show peers on the Asterisk CLI; the plivo peer should read reachable (IP-ACL) or Registered (credentials). Place a single test call from Campaign Detail and confirm clean two-way audio plus correct caller ID. Then map the DID (direct inward dialing) to an Ingroup for inbound under Admin then Inbound then DIDs.

The complete field-by-field reference lives in our VICIdial carrier integration guide, and the exact dialplan strip/prefix syntax is in the carrier dialplan entry guide.

A VICIfast box ships with a static public IP for Plivo's IP-ACL and is live in under 40 seconds. See pricing and connect your Zentrunk.