¶ DIDs
DIDs are used to point all incoming calls (that come over trunks) to specific system destinations.
- Search
Search Filter
In search section you can find your DIDs by DID number, Destination, Country, State, City and Area Code.
([a-z][0-9])
- CSV Upload/Download
Here you can create multiple DIDs on the fly by uploading a .csv file with DID details, or you can download the CSV for current DIDs and review or edit them.
To upload, click on the 'Browse' button, select a .csv file from your computer, click 'Open', then the 'CSV Upload' button.
The CSV file must be in the following format:
server,nr1,nr2,dest,ext,replace_cid,trunk,status,strip_N_digits,q_priority,codec,E164nr1,E164nr2,area_code,did_name
Required fields:
- Server name
- DID/Channel (start)
- Trunk
- Destination
- E-mail/Extension/Value
All other fields also must be defined in CSV, but they can contain empty values.
- Download CSV Template
This option will allow you to download the CSV template that already contains necessary headers which should help you create CSV file that can be used to upload a large number of DID entries at once.
NOTE: In PBXware v6.7.4 we added the option to upload the DID name using a CSV file.
The DID template now includes did_name field. To download the updated DID template navigate to the DID section and click on the Download CSV Template button.
¶ DIDs Main Screen
This screen lists all system DIDs with the following details.
- DID/Channel
Displays the DID number or a PSTN channel slot number
(E.g. 1000/1)
(Display)
- Name (6.6)
Displays the name of a DID for easier navigation
(E.g. Tech Support)
(Display)
NOTE: Please note that this feature is part of the beta release and is only visible to beta testers. Once the stable version is released, it will be available for general use.
- Provider
Displays the Provider's name
(E.g. Generic SIP)
(Display)
- Trunk
Displays the Trunk used by a DID
(E.g. Trunk1)
(Display)
- Destination
Displays the Destination and network number
(E.g. Extension - Alfred H. (5000))
(Display)
NOTE: If an Extension is set as a Destination, the name will be displayed together with the network number.
- Status
Refers both to the status of DID and SMS service
(E.g. Active/Inactive)
(Display)
NOTE: Please take a look at the table for further explanation of what happens when the status is either 'Active' or 'Inactive'.
| Active | Calls and SMS messages both go through . |
| Inactive | Calls do not go through, but SMS messages still go through. |
EXAMPLE: In case a user adds a DID, and following this, enables SMS for this DID on Slave Tenant, the number will be added to the list of SMS numbers and its status will be displayed as 'Active' which means that both the calls and SMS messages will go through. In case a user changes settings on Master Tenant, and the status changes to 'Inactive', this action will make it unable for calls to go through, however, SMS messages will still go through since the number stays on the list of SMS numbers regardless of the status change.
Click to edit the DID configuration
(Button)
Click to delete a DID from the system
(Button)
¶ Add/Edit DID
Clicking on 'Add/Edit' will open the standard DID options.
¶ General
- Trunk
Select which trunk the DID will pick up calls from.
(E.g. If you select '2554433' for example, DID will wait for any incoming calls over that trunk and then will pass the call further based on the settings below).
(Select box)
- Name (6.6)
Displays the name of a DID for easier navigation
(E.g. Tech Support)
(Display)
NOTE: Please note that this feature is part of the beta release and is only visible to beta testers. Once the stable version is released, it will be available for general use.
- DID/Channel (start)
Provide a DID number here
(E.g. 55510205).
([0-9])
- Destination
PBXware destination that the DID will transfer all calls to.
(E.g. Multi User)
(Select box)
- Value
Destination value all DID calls will be transferred to.
(E.g. If 'Destination'='Extension', set the extension number here(e.g. 1002). In case 'Destination'='IVR', set the IVR extension number here).
([0-9])
TIP: If using 'Fax to email', set the 'Value' field to an email address (email@domain.com) or extension number (1002). If an extension number is used, the fax will go to an email address associated with the extension. The email which arrives to the specified address will contain both TIFF and PDF versions of the Fax.
- Service Plan
This option is used so you can bill inbound calls to IVRs, Conferences, Queues, and Voicemail. If these are selected as the Destination, they will be billed as 'Local destinations' from the Service Plan.
If Extension/Multi-User is selected, the call will be billed as per the incoming price set for E.164 number in DID. The balance on the Extension could be set as a + or - value so you can decrease or increase the balance for that extension when it receives the call.
For other Destination Types, Service Plan is disabled.
(E.g. National Service Plan)
(Select box)
- Call Rating Extension
The extension which is charged for inbound call rating set on the DID.
- E.164 Number (start)
A DID number in E.164 format 'INTERNATIONAL PREFIX + AREA CODE + PHONE NUMBER' ( 1 212 555 9876 ). If provided here, this number will be used by 'PBXware MT: Networks' and will be dialed over the Internet rather than the PSTN trunk. If the 'Range' field is set to 'Yes', provide the DID/Channel (start) number in E.164 format here
(E.g. If your DID number = 5559876, and you live in NewYork/USA, your E.164 number is 12125559876)
([0-9])
¶ Advanced Options
Click on the 'Advanced Options' button will open more detailed DID options.
¶ General
- Status
Set the DID status on the network.
(E.g. Rather than deleting the DID, you can deactivate it by selecting 'Not Assigned,' and later restore it with 'Active').
(Select box)
- Range
If enabled, users may utilize a range of DIDs and point it to one or many Endpoints. Users may then enter their desired DID/Channel (start) and DID/Channel (end) and/or E.164 number (start) and E.164 number (end) which gives them an opportunity to limit the beginning of the Range and its end. If this feature is not enabled, users may enter only DID/Channel (start) and/or E.164 number (start) meaning that there will be no range, but only one standard DID.
(Option buttons)
- DID/Channel (end)
Some providers offer a range of numbers over a single trunk. Set whether this DID should be used to transfer a range of numbers to some PBXware destination.
(E.g. John has bought 10 DID numbers from a provider (55510205 - 55510215) and wants all calls coming from these to be transferred to lobby queue. He needs to set 'Range'='Yes'. Set 55510205 to (start) and 55510215 to this field. Set 'Destination'='Queues' and 'Value'=Queue number(e.g. 1000)).
(E.g. 55510222).
([0-9])
- Operation Times
Set the DID operation time.
(Button)
- CLI Validation & Routing
Configure Validation & Routing
(Button)
- SMS Enabled
Enable the SMS service for this DID
(E.g. Yes/No)
(Options button)
NOTE:
1. First Case Scenario: If this option needs to be enabled and editable, then the Destination must be set to 'Extension' and a certain 'Value' has to be provided. Otherwise, if any other Destination is set, this field will be uneditable. Also, a number has to be in a valid E.164 format. Please refer to the table.
2. Second Case Scenario: Please note that if 'DID Range' is enabled on Master Tenant, the 'SMS Enabled' button will be disabled. Please refer to the table.
| Editable Field (Extension) | Uneditable Field (Other Destination) |
|---|---|
 |
 |
For more on how to successfully complete the SMS configuration, please refer to the Add SMS Number page.
- Main Number (7.3)
This option allows you to indicate that the DID number is assigned as the main number and mark it in green on the DID page for easier navigation. If more than one DID is configured as a "Main Number" these DIDs will be displayed at the top of the DID list and sorted by number in descending order.
By default, the "Main Number" option is set to No.
Once the 'Main Number' is set to 'Yes' and changes are saved, the DID list will display the number marked in green color.
- Greeting
The greeting which is played when calling this DID.
(E.g. When uploading a greeting for the DID, the name of the sound file must start with 'greeting-did-').
(Select box)
- Strip N Digits
If you are directing calls to a trunk, here you can set the number of digits which will be stripped from the beginning of the incoming call.
(E.g. 3)
([0-9])
- Replace Caller ID
Replaces the caller id with the custom data provided here. This is used when you want all incoming DID calls to have this value displayed as a caller id information. Along with the custom data, you can use the '%CALLERID%' variable, which displays the calling party phone number.
NOTE: Please make sure you enter this information as it is written down, otherwise, it will not work properly.
(E.g. Providing a 'USDID' here, will display 'USDID' on your phone display, for all calls coming through this DID. Providing 'USDID %CALLERID%', will display 'USDID 55510205' on your phone display, where 55510205 is calling party phone number).
([a-z][0-9] [%CALLERID%])
- Queue Priority
Set the Queue priority
(E.g. If this DID redirects all calls to the queue, set '1' here to give the highest queue priority to all calls over this trunk ).
([a-z][0-9])
- Force Codec
Force a codec to all calls going over this DID.
(E.g. Select G.711 ulaw from the list to force all calls going over this DID to this codec).
([a-z][0-9])
- Custom Ringtone
If you are directing calls to an extension on which a supported UAD is registered, you could set a Custom Ringtone with which the phone will ring. More on this can be read at Custom Ring Tones
(E.g.)
([a-z][0-9])
- Record Call
If this option is turned on, incoming calls on this DID will be recorded.
(E.g. When this option is turned on, the complete call will be recorded wherever it goes or whatever happens to it).
(Option buttons)
- Notify on Not Answer
If set to ‘Yes’ - any calls that are not answered on this DID will be logged for the next notification e-mail.
(Option buttons)
- Auto Fax Detection (v6.7.1)
This feature allows you to enable automatic fax detection on DID, and forward incoming fax calls to an extension number different from the main destination configured on DID.
- Fax Destination (v6.7.1)
Extension number incoming fax calls will be forwarded to when a fax call is detected. This field will be inactive unless Auto Fax Detection is enabled.
- E.164 Number (end)
A A DID number in the E.164 format 'INTERNATIONAL PREFIX + AREA CODE + PHONE NUMBER' (e.g. 1 212 555 9876). If 'Range' field is set to 'Yes', provide the DID/Channel end number in the E.164 format here.
(E.g. If your DID number is in range 5559876 - 559885, and you live in NewYork/USA, your E.164 end number is 12125559885).
([0-9])
- Country
Select a country that this DID number belongs to.
(E.g. If the DID number is in USA format (e.g. 1212****), select USA here).
([a-z][0-9])
- County
State/County that the DID number belongs to.
(E.g. If the DID number is in USA format (e.g. 1212****), 212 is for New York, so type NY here).
([a-z][0-9])
- City
City that the DID number belongs to.
(E.g. If the DID number is in USA format (e.g. 1212****), 212 is for New York so type New York here).
([a-z][0-9])
- Area Code
Area code the DID number belongs to.
(E.g. If the DID number is in USA format (e.g. 1212****), type 212 for that is the area code for New York).
([0-9])
¶ Operation Times
Set the system open/closed times. Depending on the time when the call is received, the call can be redirected to different PBXware MT destinations.
¶ Buttons
- CSV Upload
Click on this button to upload Operation Times configuration from csv file
(Button)
- CSV Download
Click on this button to download Operation Times configuration to csv file
(Button)
- Download CSV Template
Download CSV Template button will present you with a file that already contains necessary headers which should help you create CSV file easier
(Button)
- Enable Operation Times
Enable operation times
(E.g. Yes, No, Inherit)
(Option buttons)
¶ Default Destination
- Default Destination
PBXware MT extension to which all calls are redirected during the closed time hours
(E.g. 1000)
([0-9])
- Is Voicemail
Choose if Default Destination is voicemail
(Checkbox)
¶ Greeting
- Greeting:
Greeting sound file played to callers during the closed times
(E.g. greeting-***)
(Select box)
¶ Options
- Closed dates Sets the specific date/s when all calls are redirected to the 'Default Destination'. If the 'Destination' field in the Closed dates is set, calls will not go to the 'Default Destination' but to this number.
- Custom Destinations: Redirects all calls received during non-working hours (e.g. weekend) to the PBXware MT extension provided here.
- Open dates: Sets the working hours during which the DID is to redirect calls as set in the DID Add/Edit window. If any call is received during the hours not set here the call is redirected to 'Default Destination'.
¶ CLI Validation & Routing
This option is used to fine tune the functionality of the DID by adding rules which send the calls to different destinations based on Caller IDs. For example, if the caller's ID begins with 203, you can send all those calls to the IVR, if the CallerID is specifically number 063456789 then send that call to extension 4444 etc...
Once you click on CLI Validation & Routing button on Edit DID page, new window with following option will be shown:
- CSV Upload
Click on this button to upload CLI Validation & Routing configuration from csv file
(Button)
- CSV Download
Click on this button to download CLI Validation & Routing configuration to csv file
(Button)
- Download CSV Template
Download CSV Template button will present you with a file that already contains necessary headers which should help you create CSV file easier
(Button)
- Caller ID
The Caller ID which is matched in the rule.
(E.g. 063456789)
(Display)
- Destination
The type of destination to which the call will be directed.
(E.g. IVR)
(Display)
- Extension
Extension of the destination or selection where the call should go.
(E.g. 2222)
(Display)
- Match Type
How the Caller ID is matched.
(E.g. If we set Match explicitly to ‘yes’ here will be written ‘Explicit Match’. If we set this option to ‘No’ or ‘Not Set’ here will be written ‘Begins With’.)
(Display)
- Edit
Edits the CLI Validation & Routing configuration
(Button)
- Delete
Deletes CLI Validation & Routing Rule from the system
(Button)
¶ Add/Edit CLI Validation & Routing Rule
- Caller ID
The Caller ID which is matched in the rule.
(E.g. 063456789)
([a-z][0-9])
- Destination
The type of destination to which the call will be directed.
(E.g. Queue)
(Select box)
- Extension
Value of the destination or selection where the call should go.
(Select box)
- Match Explicitly
Should the system match Caller ID explicitly or treat all calls that begin with it.
(E.g. Yes, No, Not Set)
(Option buttons)