DID Instruction


This article introduces what is DID and how to use DID in Yeastar S-Series VoIP PBX.

Scope of application

Product model: S-Series VoIP PBX

Software version: Any

Hardware version: Any

What is DID?

Assuming that a SIP trunk or other trunks has three numbers 5503301,5503302,5503303, and there is coming call from this trunk. You want to accomplish the routing that when client calls the number 5503301, the extension of PBX 101 will be ring; when he calls the number 5503302 , the extension 102 will be ring; when he calls the number 5503303, the extension 103 will be ring. Those numbers 5503301,5503302,5503303 are so-called DID number.

The explanation from the Internet of the DID is simple: call directly. On the PBX, DID can also be explained like this: select the corresponding destination through the DID number provided by the trunk provider.

How to use DID?

1. How to Get DID

1) In the SIP trunk, you can get the INVITE packet of the incoming calls by capturing the SIP PCAP package. The number of INVITE field is the DID number we need (Normally the number of the INVITE header and TO header are the same). After getting the DID number, we can match the DID number on the Inbound Route.

You can configure the DID number capture globally in the menu: PBX> General> SIP> Advanced> Get DID From.

On SIP trunk edit page, you can also select the way to get the DID number: follow the global setting like above or just use other headers to get the DID number.

2) In the IAX trunk, you can get the NEW packet by capturing the PCAP package. You can see that the CALLED NUMBER is the DID number you need. The NEW packet is equal to the SIP INVITE packet which initiates the call. 

3) In the BRI/E1 trunk, you can learn where to get the DID number by capturing the  PRI log (we take the PRI signaling for example). Below is the SETUP packet of a incoming call, which is equal to  the INVITE packet of the SIP trunk.

You can see that the number behind the Called Number header is the DID number you need (At the left of per line, the symbol "<" means inbound , the ">" means outbound)

2. The mode of DID configuration: one to one mode, multiple to multiple mode

1) One to one mode:

The mode means one DID number is binded to one destination of inbound route. As shown below, you can see that the  DID number is 5503301, the destination of the inbound route is an extension 10. You can also select other options as the destination like IVR, Ring Group, Queue, Outbound Route and so on.

2) Multiple to multiple mode

The mode means multiple DID numbers are bound to multiple extensions. You can configure the DID Pattern with the DID range 5503301-5503309, and set the destination of the inbound route with the Extension range 101-109. After completing such setting, you can realize this feature: when you call the number 5503301, the call will reach the extension 101;when you call the number 5503302 , the call will reach the extension 102 and so on.

Please note that the numbers of  DID pattern and Extension Range should be consecutive. And the amounts of DID pattern and Extension Range should be equal. E.g: DID pattern is 5503301-5503309, its amount is 9; Extension Range is 101-109,  the amount is also 9.

Scope of the DID Feature

DID can be used in such lines which the provider sends the DID number informaiton to the PBX like SIP trunk, E1 trunk, BRI trunk, IAX trunk. However, in the FXO trunk or GSM trunk, it does not include the DID number. So you don't need to configure DID Pattern for FXO and GSM trunk.

Have more questions? Submit a request


  • 0

    bonjour, y a t-il un moyen  d'empêcher l'untilisateur d'appeler certains numéros exterieur?

    exemple: je ne veux pas que le N°101 appel un numéros international  +22554216889

  • 0


    Vous pouvez bloquer les numeros internationaux soit sur l'ensemble du PBX soit sur l'extention en question.

  • 0


    I am setting DiDs for a client. DiD number given to me is 22215203, the incoming call to this number should ring at extension 1003 but for some strange reason it does not ring at all. I have followed the above procedure.

Please sign in to leave a comment.