DID (Direct Inward Dialing) Setup

DID (Direct Inward Dialing) numbers are phone numbers that route incoming calls from the public telephone network (PSTN) to your Vicidial server. Your SIP carrier provides these numbers and forwards calls to your server via SIP trunks.

Each DID can be independently routed to different destinations: an inbound group (queue) for agent distribution, an IVR menu for self-service, a specific phone, voicemail, or an Asterisk dialplan extension.

1. DID Extension — The phone number exactly as received by Asterisk (e.g., 12125551234 with country code).
2. DID Description — Descriptive label (e.g., "Main Office Line", "Sales DID").
3. DID Route — Select the destination type (IN_GROUP, PHONE, VOICEMAIL, EXTENSION, IVR, AGENT, or CALLMENU).
4. Route Value — The specific destination (e.g., the in-group ID, phone extension, or IVR name).
5. Active — Set to Y to activate the DID routing.
6. CID Group — Optionally assign a CID group for filtering or dynamic routing based on caller ID.

Vicidial supports routing DIDs differently based on time of day, day of week, and caller ID:

• Call Time Routes — Define business hours vs. after-hours routing. During business hours, route to an in-group; after hours, route to voicemail or IVR.
• DID Filter — Route differently based on the Caller ID of the incoming call. Match specific numbers or number patterns.
• CID Group Filtering — Create groups of CID patterns for VIP routing, blocklisting, or priority queue placement.
• Holiday Routing — Set alternate routing for specific dates (holidays, maintenance windows).

Your SIP provider must be configured to send incoming calls for your DIDs to your Vicidial server:

1. In your provider's portal, set the DID destination to your Vicidial server's public IP address.
2. Ensure the carrier entry in Vicidial has the correct context=trunkinbound setting.
3. The DID number in Vicidial must match exactly how the provider sends it (with or without country code).
4. Test with asterisk -rx 'sip set debug on' and make a test inbound call to verify the DID number format received.

Vicidial automatically manages DID routing through its database, but in some cases you may need to modify the Asterisk dialplan directly: