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 and Destination.

([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 (e.g. vo3000.voipoffice.org)
• DID/Channel (start)
• Trunk
• Destination
• E-mail/Extension/Value

All other fields also must be defined in the CSV file, but they can contain empty values.

• Download CSV Template

This option will allow you to download the CSV template that already contains the necessary headers which should help you create the CSV file that can be used to upload a large number of DID entries at once.

NOTE: In VoIPOffice v6.7.4 we added the option to upload the DID name using a CSV file.

The DID template now includes the 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

Displays the DID number

(E.g. 4420100200)

(Display)

• Name (v6.6 onwards)

Displays the name of a DID for easier navigation
(E.g. Tech Support)
(Display)

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 to the status of the DID

(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'.

EXAMPLE: In case a user adds a DID, its status will be displayed as 'Active' which means that the calls will go through. In case a user changes settings and the status changes to 'Inactive', this action will make it unable for calls to go through.

 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, the 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 (v6.6 onwards)

Displays the name of a DID for easier navigation

(E.g. Tech Support)

(Display)

• DID/Channel (start)

Provide a DID number here

(E.g. 55510205).

([0-9])

• Destination

VoIPOffice destination that the DID will transfer all calls to.

(E.g. Dial Group)

(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.

Advanced Options

Clicking 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 utilise a range of DIDs and point it to one or many Endpoints. Users may then enter their desired DID (start) and DID (end) which gives them an opportunity to limit the beginning of the Range and its end.

(Option buttons)

• DID/Channel (end)

Set whether this DID should be used to transfer a range of numbers to some VoIPOffice 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)

• Main Number (v7.3 onwards)

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.

• Greeting

The greeting which is played when calling this DID.

(To add a Greeting, Dial *301 from your extension. At the tone, speak your message and hang up. Save and re-open the DID configuration, go to Advanced Options > Greeting. The greetings are automatically named and contain the time and date of the recording.).

(Select box)

• 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 '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 phone is registered, you could set a Custom Ringtone with which the phone will ring.

(E.g.)

([a-z][0-9])

• 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

This feature allows you to enable automatic fax detection on a DID and forward incoming fax calls to an extension number different from the main destination configured on the DID.

• Fax Destination

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 DID number in the E.164 format 'INTERNATIONAL PREFIX + AREA CODE + PHONE NUMBER' (e.g. 1 212 555 9876). If the '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 the 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 VoIPOffice destinations.

Buttons

• CSV Upload

Click on this button to upload Operation Times configuration from a CSV file

(Button)

• CSV Download

Click on this button to download Operation Times configuration to a CSV file

(Button)

• Download CSV Template

The Download CSV Template button will present you with a file that already contains the necessary headers which should help you create the CSV file more easily

(Button)

• Enable Operation Times

Enable operation times

(E.g. Yes, No, Inherit)

(Option buttons)

Default Destination

• Default Destination

VoIPOffice extension to which all calls are redirected during the closed hours

(E.g. 1000)

([0-9])

• Is Voicemail

Choose if the Default Destination is a voicemail box

(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 VoIPOffice 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 the '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 the number 063456789 then send that call to extension 4444 etc...

Once you click on the CLI Validation & Routing button on the Edit DID page, a new window with the following options will be shown:

• CSV Upload

Click on this button to upload the CLI Validation & Routing configuration from a CSV file

(Button)

• CSV Download

Click on this button to download the CLI Validation & Routing configuration to a CSV file

(Button)

• Download CSV Template

Download CSV Template button will present you with a file that already contains the necessary headers which should help you create a CSV file easily

(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’ the words ‘Explicit Match’ will be displayed. If we set this option to ‘No’ or ‘Not Set’ the words ‘Begins With’ will be displayed.)

(Display)

•  Edit

Edits the CLI Validation & Routing configuration

(Button)

•  Delete

Deletes the 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 the Caller ID explicitly or treat all calls that begin with it?

(E.g. Yes, No, Not Set)

(Option buttons)