dialplan
30 posts.
How to Block Agents From Dialing Out With the agent-nodial Phone Context
Use the Phone Context field on Bulk Phone Insert to point agent phones at a non-existent dialplan context so they cannot place calls outside VICIdial.
Read postHow to Write a Custom AGI Script for VICIdial
AGI scripts let you run any external program during a live call to look up data, change routing, or set variables — here is how to write one from scratch for VICIdial.
Read postHow to Use the CID_change.agi Script to Change Caller ID
CID_change.agi swaps the outbound caller ID on any call that passes through it, letting you pick a fixed number or pull from a CID group that matches the destination area code.
Read postHow to Use the cm_lookup.agi Call Menu Script
cm_lookup.agi searches your vicidial_list records from inside a Call Menu and routes the call based on whether a match is found.
Read postThe VICIdial 8168 Record-Prompt Extension Explained
Extension 8168 is VICIdial's built-in phone-based audio recorder — here is exactly what it does, how the dialplan context works, and when to use it.
Read postHow to Use the cm_fpg.agi Call Menu Script
cm_fpg.agi inserts a caller's phone number into a VICIdial Filter Phone Group from within a Call Menu, blocking future outbound dials to that number.
Read postHow to test a Remote Agent's External Extension before going live
Before flipping a Remote Agent to ACTIVE, dial its External Extension from the server. This one test catches most forwarding failures.
Read postWhat VICIdial Extension Groups are
VICIdial Extension Groups let you distribute calls going to a Remote Agent across several dialplan extensions in a defined rank order.
Read postWhy a Remote Agent takes up to a minute to deactivate
You set a VICIdial remote agent to INACTIVE but calls keep coming for another minute. This is normal — here is why it happens and what to expect.
Read postHow to set the External Extension on a Remote Agent
Step-by-step instructions for setting the External Extension field on a VICIdial remote agent, including how to find the right number and test it before going live.
Read postHow to create a VICIdial Extension Group
Extension Groups let you distribute calls to a Remote Agent across multiple dialplan extensions. Here is how to create one step by step.
Read postWhat the External Extension field on a Remote Agent does
The External Extension field tells VICIdial which number to forward calls to for a remote agent. Get this wrong and calls go nowhere — here is what to put in it.
Read postWhat the Status (ACTIVE / INACTIVE) field on a Remote Agent does
The Status field on a VICIdial remote agent is the on/off switch that controls whether the dialer sends calls to it. Here is exactly what each value means.
Read postHow to round-robin calls to Remote Agents
VICIdial can round-robin inbound calls across several dialplan extensions for a Remote Agent using an Extension Group. Here is the full setup.
Read postWhat the Rank field on an Extension Group entry does
The Rank field on a VICIdial Extension Group entry sets the order in which the system tries each dialplan extension. Here is what that means in practice.
Read postWhat the Server IP field on a Remote Agent does
The Server IP field ties a remote agent record to one specific VICIdial server. Here is why that matters and what happens if it is wrong.
Read postWhat is the VICIdial dialplan number?
The VICIdial Dial Plan number is the number you dial to make a phone ring. It is defined in Asterisk's extensions.conf. Here is how it works.
Read postFix the Reserved Dialplan Number warning
The VICIdial Reserved Dialplan Number warning means the number you picked cannot be dialed. Here are the reserved ranges and how to choose another.
Read postWhat the NVA_recording AGI does for non-screen agents
The NVA_recording AGI gives VICIdial recording and call-logging to agents who never open a browser screen — with 16 parameters covering logging, lead lookup, and NVA list insertion.
Read postHow to record agents who don't use the VICIdial agent screen
Step-by-step guide to using agi-NVA_recording to capture calls from agents on plain phones or third-party softphones, with correct dialplan placement and parameter choices.
Read postReading the 3-way press-1 special extension (49907, dial prefix, phone code, number)
That long 49907... string an agent dials to start a press-1 call is not random. Here is how to read each piece so you can build and debug it.
Read postagi-VDADfixCXFER.agi: fixing the agent record after a consultative transfer
When a fronter releases a consultative transfer, the live-agent record can go stale. This small script lands as the call arrives and sets it straight.
Read postMaking sure your caller ID reaches the carrier
How VICIdial sends caller ID to your carrier, why it sometimes gets stripped or overwritten, and how to confirm the number you set is the one that goes out.
Read postStripping or Adding Digits Before the Carrier Sees Them
VICIdial almost never sends the carrier exactly what was dialed. Here is how the dialplan strips and adds digits so your trunk gets the format it expects.
Read postUsing a Dial Prefix to Pick a Carrier in VICIdial
A dial prefix is a routing digit VICIdial adds in front of a number. Used well, it lets each campaign choose which carrier its calls go out.
Read postHow Outbound Calls Find the Right Carrier in VICIdial
When an agent dials, Asterisk matches the number against dialplan patterns to pick a trunk. Here's how that routing actually works.
Read postVICIdial Carrier Global String: What That Field Actually Does
The Global String field on a VICIdial carrier defines a dialplan variable for the trunk. Here is when you need it and when to leave it blank.
Read postVICIdial Dialplan Entry: Routing Outbound Calls to a Carrier
How the VICIdial Dialplan Entry matches an outbound number, strips the prefix, and dials it out the right carrier — with a worked example.
Read postConnecting a SIP Carrier to VICIdial: The Complete Guide
Everything you need to wire a SIP carrier into VICIdial: trunks, registration vs IP auth, dialplan routing, failover, least-cost routing, and STIR/SHAKEN.
Read postDID Extension Context explained
What the Extension and Extension Context fields do on a VICIdial DID, when you need them, and the one setting that trips up voicemail routing.
Read post