ToolBox -

General Settings

    • Go to your selected domain in the web interface.

  • Click on General Settings under Advanced as shown above.
  • Here you can configure the settings.


  • Name of the Domain: This field allows you to give the domain a descriptive name. The name can contain special characters and spaces and may include upper and lowercase characters. The name will be used by the system when sending emails with call data records for the domain. This name is independent from the domain name that is set by the system administrator.
  • Default Dial Plan: This dial plan will be used by the domain, but users can override this with their own dial plan based on need. Most of the accounts in a domain will use the default dial plan. If you do not set a default dial plan, you will likely have problems placing outbound calls. Therefore, it is strongly recommended to choose a default dial plan.
  • Default IVR Language: This setting can be configured by the administrator and is not needed on the domain level in single-domain environments.
  • Tone Language: This setting can be configured by the administrator and is not needed on the domain level in single-domain environments.
  • Default Web Language: This setting can be configured by the administrator and is not needed on the domain level in single-domain environments.
  • Music on Hold Source: You can select the source of music that will be used when a call is put on hold. The party who is on hold hears the music that is chosen here. See also Chapter 21, “Music on Hold.”
  • Timezone: The system can handle multiple time zones simultaneously, making it possible for users to select a time zone that corresponds with their geographic location. This setting influences the time on mailbox messages and the telephone display. Before the system can apply the time zone to the user’s extension, it needs a time zone configuration file (timezones.xml). The name of the time zones is reflected in the lang_xx.xml file, where xx is replaced by the respective language.
  • Country Code: The country code plays a major role in interpreting telephone numbers. Three modes are available for this setting.
  • As Is: If this setting is left empty, the system does not change telephone numbers. In this case, you must make sure that users, PSTN gateways, and service providers use the same method of representing a number (for example, 10 or 11 digits in the United States). Choose this mode when the other modes are causing problems. [Leave this field empty]
  • NANPA: If you enter a 1 into the Country Code field, the system will interpret telephone numbers according to the NANPA scheme (North American Numbering Plan Administration), which means that international numbers will start with 011 and numbers that have 10 digits will be written in the (xxx)xxx-xxxx scheme (JavaScript takes care of this in the web interface). This scheme also applies to countries other than the United States, like Canada. Apart from the readability of numbers, this scheme has the added benefit of automatically converting differently represented numbers (11-digit or 10-digit) into a global format. The area code must be 3 digits and is used for numbers that have only 7 digits. [Use a 1 in this field.]
  • ROW: If you enter another country code into this field (for example, 33 for France), the system will interpret numbers according to a “rest of world” scheme, which means that international numbers start with 00 and national numbers start with 0. The area code is used to determine whether the short number format can be used or not (local call). [Use any country code, e.g., 33.]
  • Area Code: This is the telephone area code for the domain. This is generally NPA in the NPA-NXX-XXXX number (e.g., 978, 212, etc.). If you put a “-” there, it means that the area code is explicitly set to null; this is neccessary in some countries that don’t use 0 as the domestic calling prefix.
  • Default ANI: Using this setting, you can configure each domain with a default ANI (Automatic Number Identification). ANI is a service that tells the recipient of a telephone call which telephone number made the call. In most cases, the ANI is used in the From field in the SIP packets or the caller-ID.
  • Trust Caller-ID: This setting is used to specify whether the caller-ID should be used to authenticate, rather than asking users to enter their PIN numbers.
  • Emergency Numbers: This setting allows you to establish which numbers will be considered “emergency numbers” on the domain. Once the user dials an emergency number, the system sends an email alert to the configured extension if an alert has been configured for this type of system event. The system also dials the local police station number that was entered into the user’s Emergency Destination Number setting. To set the callback number for the user, see the EPIDsetting. A general callback number for all users across the domain can also be set using the ANI for emergency setting.
If you have more than one emergency number, use a space between the numbers (e.g., 911 199). By default, this setting is blank (i.e., it is not set to 911).
  • Use last 7 digits when cellphone matching: In some cases, the admin might have saved only last 7 digits of the cell phone in the PBX database. This setting comes in handy to force the PBX to perform a search based on the last 7 digits of the received number.
  • Send welcome email when an extension is created: If this setting is checked, new users will automatically receive a welcome email.
  • Delete all aliases when deleting the primary account: Aliases will be deleted when primary accounts are deleted.

From/To Headers

  • Change names in To/From-headers: Usually it is okay if the system changes the names in the To/From headers in the SIP packets. For example, this makes sense when the address book matches the caller-ID and the system should present the address book entry. However, if the system is used as a SIP device in an operator environment, you may want to make sure that the system does not change headers. In such cases, this setting should be set to No.

CDR Settings

  • CDR URL: The CDR URL field controls where CDRs are written. The system can write CDRs to a CSV file, an email address, a server address, or to a SOAP destination. To populate the CDR URL field, use the syntax shown below. CDRs can be viewed only after they have been collected and organized through an external call accounting application.
Export Type Syntax for CDR URL Options
CSV (see note below) file:$c/$m/$d/$h.csv $c = cdr, $m = domain name, $d = date, $h = hour
Simple TCP cdr:<server IP:port>
JSON json(s):server:port/resource Store the CDR in JSON format
SOAP/XML http://<your SOAP server URL>https://<your SOAP server URL> Store the CDR in SOAP/XML format
Note: You can also configure the CDR URL setting so that CDRs are sent to a mapped drive. To do this, enterfile:f:/cdrs/$d.txt into the CDR URL field, where “f” is the letter assigned to the drive.

The following fields are included with all CDRs. The default separator for the values is a comma; however, it can be changed by modifying the cdr_field_separator parameter. (Simple TCP CDRs can be customized to include fewer or additional fields.)

Field Example
primary call id 0080-1008-25C105DA-0@D141DFC50C7AA2248
call id 0080-1008-25C105DA-0@D141DFC50C7AA2248
from “00432638316014” <;user=phone>
to “Steve Fuller” <>
direction I
type attendant
start time 20100310095708
connect time 20100310095710
end time 20100310095720
trunk number
local user 411
remote user
record location
CMC 6877
IP address
connected extension
account id

Billing Settings

  • CMC authentication for outbound calls: This setting works in tandem with the “C” checkbox located in the dial plan. When the “C” is checked on a particular trunk in the dial plan, this domain setting will be used to generate the CMC for the CDR when that trunk is used for an outbound call; otherwise, it will be ignored. The following indicates how the CMC will be generated for the CDR:
Use address book: The system will automatically take the CMC from the address book record.
These next options apply to CMC codes that have been generated by the third-party software that is being used to do the billing. If the CMC codes are 4 digits, choose the “4 digit” option; if they are 5 digits, choose the “5 digit” option, etc. If they are a combination of digits, then use the “Terminate CMC with #” option. This will enable the caller to enter CMC codes are varying lengths, followed by the # sign.
Terminate CMC with #
4 digits
5 digits
6 digits
7 digits
8 digits
9 digits
10 digits
  • Billing Tones: This field allows you to configure whether domain users will hear a beep during the call when using the pre-pay feature of the system.
No tones
Beep for every charge unit
Beep only for last charge unit
  • Credit for outbound calls: This setting allows you to place a limit on outbound calling for the entire domain. Once the extensions as a group have reached the maximum, outbound calls can no longer be placed.

Recording Default for this Domain

This section allows you to define domain-level call recording settings. Recorded calls will be saved in the recordings directory.

  • Record incoming calls from hunt group: This setting controls the recording on an extension (applies to calls coming from the hunt group for the entire domain).
  • Record incoming calls from agent group: This setting controls the recording on an extension (applies to calls coming from the agent group for the entire domain).
  • Record incoming calls from extension: This setting controls the recording on an extension (applies to calls coming from another extension for the entire domain).
  • Record outgoing calls to internal numbers: This setting controls the recording on an extension (applies to calls going to another extension for the entire domain).
  • Record outgoing calls to external numbers: This setting controls the recording on an extension (applies to calls going to external numbers for the entire domain).
  • Record outgoing calls to emergency numbers: This setting controls the recording on an extension (applies to calls going to an emergency number).

Midnight Events

At midnight, the system can perform several maintenance tasks, including the generation and sending of CDR reports.

  • Send daily CDR report to: The system sends daily CDR reports to the email addresses listed in this field. Use semicolons between multiple email addresses, since email addresses may contain spaces (e.g., Fred Feuerstein <>; Carl Clements <>). To test this feature, click the Try button once you’ve entered an email address rather than waiting until midnight. Keep in mind that this is just a link, and you may have to save your list before clicking the link.
  • Reset DND Flags: DND is a major problem if users forget that they’ve set their extensions to DND and then open a trouble ticket next morning because they’ve stopped receiving calls! This setting can prevent that. When the Reset DND Flags has been enabled, the system resets all DND flags on the domain each day at midnight.
  • Reset Hot Desking: Forgetting to deactivate a Hot Desking situation has similar consequences to forgetting to turn off DND, so use this setting if you want the system to reset hot desking each day at midnight.
  • Reset Block CID: As with the previous two settings, this is another setting that is beneficial to reset each day at midnight.
  • Send emails to CDR email address for domain level blacklisted calls: When someone calls into the auto attendant, hunt group, or agent group and is put onto the blacklist, the system will notify the person who receives the CDR report. The report will be sent daily at midnight.
  • Log out agents from all ACDs: When this setting is enabled, all agents will be logged out of all agent groups each day at midnight.

Provisioning Parameters

When the system automatically generates files for the configuration of extensions, it needs a few settings from the domain.

  • Default PnP Dialplan Scheme: This setting allows you to set auto-dial and configure timeout-based dialing. These settings are used by the phone and not the system . The PnP Dialplan Scheme setting allows you to tell the system how many numbers your extensions contain (either 2, 3, or 4 digits). This will initiate automatic dialing once the required number of digits has been entered. If your extensions are all 3 digits long and include only digits 2 through 7, you should choose 3-digit extensions [2-7]xx. Then if a user dials 201, the system will identify that an extension has been dialed and will not wait for more digits. If NA is set and Country Code 1 is used, then anytime someone dials 1, the system will know to dial that country. For this reason, extensions should not begin with a 1.
User must press enter: When this scheme is selected, the user of the extension will be required to press the confirm button on the phone before the dialing will begin. This behavior is similar to cell phones, where users are required to press the green send button. This scheme can prevent problems because it is difficult to predict how many digits the phone must collect before it has enough digits for a complete number.
When the user is located in the North America area (, the length of the number is predictable for national calls and calls of other extensions in the domain. However, calls to international destinations or star codes are difficult to predict, so users will be required to press the confirm button to start the call.
For other countries, the “Europe” scheme might be appropriate. As with the rest of the world outside of NANPA, the length of a telephone number is practically unpredictable and users will be required to press the confirm button to start the call. The “Europe” scheme will dial automatically only if the destination is another extension.
Note: If you want to create a customized dial plan, you can do this from either the snom phone or through the binary files of the system. In the case of the latter, you will need to request the appropriate file from snom and place it into the snom/snomONE/html directory (you may need to create the html directory). After you have modified the file, save it and reboot both the phone and the system.
Example: In the event you want to exclude numbers higher than 5 from the default of [2-7]xx so that users will not be required to enter a 1 when dialing local numbers beginning with 604 or 778, you need to replace [2-7] with [2-5] in the file named snom_3xx_dialplan_usa3.xml (assuming you are using a snom phone).
  • Authentication User/Password: This setting makes it easier to carry out domain level settings of phones. Using this setting, the administrator can create identical user names and passwords for all devices in a domain. This password will bypass users passwords. However, an extension@domain is still required. The default user name is admin, and the default password is password.
  • Authentication PIN: This setting allows you to override the user’s PIN, which is used on the phone itself. Administrative access to the phone allows you to reset the phone.

When logging into the phone you will see a pop up of user/pass. You will use the credentials you have entered into the Provisioning Parameters section.

In most cases administrators overlook this setting but it should be the 1st setting you configure on the system if you plan to plug and play snom devices so that you can enter your phone’s web interface.

If you want to use admin mode on the phone you will have to enter the Authentication pin.