Skip to content

Add a DID (Inbound Number)

A DID is a phone number provisioned on a carrier trunk that routes inbound calls to UnifiedBX. Adding a DID in UnifiedBX = creating an Inbound Route that matches that number.

There's no separate "DIDs list" — DIDs are managed via Inbound Routes.

Before You Start

  • The carrier has assigned the DID to your trunk (verify with the carrier).
  • The destination (IVR, queue, time condition, extension) for the DID exists.

Steps

  1. Go to Trunk Attributes → Inbound Routes.
  2. Click + Add Inbound Route.
  3. General Tab:
    • Description — e.g. Sales Line.
    • DID Number — the inbound number, formatted as the carrier sends it. Common formats:
      • 12075551234 (most US carriers, 11-digit)
      • 2075551234 (some carriers strip the 1)
      • +12075551234 (E.164 with plus)
      • Match exactly what the carrier sends or no inbound route will trigger.
    • CallerID Number — leave blank unless you want a route matching only specific callers.
    • CID Priority Route — leave unchecked.
    • Alert Info — optional SIP header for distinctive ring on phones that support it.
    • CID Lookup Source — pick a CIDLookup config to enrich caller ID before routing.
    • Pin Set — optional, prompts the caller for a PIN before continuing.
  4. Other → Privacy Manager — No (set to Yes if you want to challenge anonymous callers).
  5. Other → Call Recording — Force to always record, Don't Care (default).
  6. Other → Music On Hold — pick a MoH class for parked/held calls on this DID.
  7. Set Destination at the bottom — pick where the call goes (IVR, Queue, Extension, Time Condition, etc.).
  8. Click Submit.
  9. Click Apply Config.

Verify

Call the DID from an outside line. The call should follow the destination. Watch Asterisk:

asterisk -rvvvv

You should see the inbound channel match the route and execute the destination.

Common Issues

  • DID format mismatch. The carrier sends +12075551234 but the route is set to 12075551234 — no match, falls through to catch-all (or drops). Check the inbound channel log to see the exact arriving DID, then update the route.
  • Multiple routes match the same DID. Asterisk uses the first match. If you have a catch-all (Any DID/Any CID) above your specific DID, the catch-all wins. Re-order: catch-all should be at the bottom or removed.
  • Call rings but no audio. Trunk-side codec mismatch or NAT issue, not a route problem. See Add a SIP Trunk common issues.
  • No call comes in at all. The carrier isn't actually routing the DID to you. Place a test call and ask the carrier to confirm they see the call leaving their side.