VICIfast

Where your phone lines live in VICIdial admin

Why VICIdial's Carriers screen is empty on VICIfast, where your phone lines are managed instead, and how to tell which line a campaign uses.

Advanced · 3 min read

Where your phone lines live in VICIdial admin

If you open VICIdial admin, go to Admin > Carriers and find no VICIfast phone lines there, nothing is broken. VICIfast manages your phone lines (trunks) from the dashboard and writes them into its own settings files on the server, not into VICIdial's Carriers screen. This page shows where to find and change them, and how to tell which line a campaign uses.

Why the Carriers list is empty

VICIdial's Carriers screen was made for servers that someone looks after by hand. On VICIfast, the dashboard is the one place your lines are kept. Every time you add, change or pause a line on the Trunks tab, we rewrite two files on your server from what the dashboard holds: /etc/asterisk/vicifast-trunks.conf for the line settings and /etc/asterisk/vicifast-trunks-dialplan.conf for how calls are routed. Keeping one copy means the dashboard and the server can't drift apart.

VICIdial admin, Carriers: no VICIfast lines here, by design
VICIdial admin, Carriers: no VICIfast lines here, by design

Where to manage your lines instead

  • Add, change, pause or delete a line: My Servers > your server > Trunks tab. Click a line's row to open it. See Connect your own SIP carrier.
  • Choose which campaigns use a line: open the line, then Routing & campaigns.
  • Try several lines in order: the Failover routes button at the top of the Trunks tab. See Failover routes.
  • TCPA scrubbing per line: open the line, then Compliance (TCPA). See TCPA compliance.
Routing & campaigns: the campaigns that call through this line
Routing & campaigns: the campaigns that call through this line

Which line does a campaign use?

Each line has a 4-digit dial prefix, shown on its row as "prefix" and a number. When you link a campaign to a line, we put that prefix in the campaign's dial prefix setting in VICIdial. So the dial prefix you see on a campaign in VICIdial admin tells you the line:

  • 9000 to 9499: one of your own lines.
  • 9500 to 9999: a failover route.
  • 8000: the VICIfast Voice line.
Each line shows its dial prefix on the Trunks tab
Each line shows its dial prefix on the Trunks tab
If you change a campaign's dial prefix by hand in VICIdial admin, the campaign no longer goes through the line the dashboard shows. Link campaigns from Routing & campaigns instead.

If you edit the files by hand

You can, with root access, but both files are rewritten end to end every time anything changes on the Trunks tab, so hand edits are lost. For your own dialplan lines that survive, open the line, click Dialplan & advanced and use Custom dialplan (advanced). Tick the box that says you understand it can break dialing for that line. Your text is stored with the line and written again on every save. If a save breaks the reload, it rolls back to the previous working version. Lines that do not use a ready-made carrier template (the Generic ones, and Manual SIP trunk (Advanced)) also get Custom PJSIP template (advanced).

Dialplan & advanced: your own dialplan, kept with the line
Dialplan & advanced: your own dialplan, kept with the line
Writing your own dialplan needs the owner, or a team member with SSH and terminal. The VICIfast Voice line's settings are locked while your VICIfast Voice account is open.

If something goes wrong

Frequently asked

› Can I still add a carrier in VICIdial admin?
It can work, but the dashboard won't know about it: it isn't on the Trunks tab, in Diagnostics or in failover routes, and its addresses only get through your firewall while Auto-whitelist carriers is on in the firewall's Settings tab. Add carriers on the Trunks tab instead.
› My hand edits to vicifast-trunks.conf disappeared.
Both managed files are rewritten on every change from the Trunks tab. Put your lines in Custom dialplan (advanced) on the line instead.
› A campaign's dial prefix doesn't match any line.
It was probably set by hand. Open the line you want, click Routing & campaigns, tick the campaign and click Apply routing.
› My server is old and the lines are in pjsip.conf.
Very early servers kept lines in a different file. Chat with support and we will move them to the managed files for you.

Tags: trunks, carriers, vicidial, faq