Advanced Provisioner Device Settings

The Devices page displays a list of devices assigned to your account. You can sort/search by device name to find the model that you want to provision. Customize the user experience through device-specific settings.

Provisioning devices

  1. Go to Advanced Provisioner > Devices.
  2. Click the settings icon on the device that you want to configure, and click Configure from the dropdown.

    ap_configuration

  3. Provision each section as required and per the tables below.

    ap_device_settings.png

Lines

Select which line you are applying the settings for and update the fields in each section as described in the table.

Type Setting Description
Basic Enable Is the line enabled or disabled. "Inherit" uses the setting that was applied at account level
Display name Indicates the name that is displayed on the device.
Transport Indicates the transport layer for the device. See Transport Layer for more information.
Expire time Indicates the default expiration time (in seconds) of each phone registration. If the registration time expires due to the phone being turned off or if it doesn't reregister automatically, the phone is considered offline unless it registers again. IP Telecom recommends leaving this value at the default 360 seconds (6 minutes).
Voicemail number Enter a custom shortcode to access voicemail. This value should always match the "Check Voicemail" shortcode that is set up in your account feature codes.
SIP Do not modify Default values are always recommended here and changing these values might cause your phone to stop working with our service.
Advanced Show Missed Calls Indicates if the phone should display missed calls.
RTP Encryption (SRTP) Indicates if voice encryption is enabled on this phone. This only works if the PBX is also enabled for this feature. See Voice Encryption.
RPort Indicates that the server sends responses back to the source IP. IP Telecom recommends leaving this setting "Enabled". CAUTION: If this is disabled, the server responds to the first IP address in the header which might cause the packets to be dropped by an intermediate service, or servers can't respond and the phone might stop working.
UDP Keep Alive Indicates if keep-alive data packets are sent through the device to keep communication open. IP Telecom recommends leaving this setting at the default "Enabled".
Keep Alive Interval Indicates the timeout limit (in seconds) on keep-alive packets. If you are using UDP as the transport layer, the you should set to to a value that is less than the "UDP Keep Alive".

IMPORTANT:

  • The "Advanced" settings should be set to the defaults that are already configured. Changing any of "Advanced" settings (except "Show Missed Calls") might cause your phone to stop working.
  • SRTP must be enabled if the device on the SmartPBX or Callflows is set to use Encrypted Voice/Encrypted RTP (See Voice Encryption).

Transport Layer

  • SRV/NAPTR - IP Telecom recommends using SRV/NAPTR because it uses dynamic records from DNS to determine where it needs to connect the phone to. During a failover, this setting allows for a quick and seamless transition of the SIP connection making sure that the endpoint stays connected.
  • UDP - uses the configured port or the default SIP port to connect to our servers. If your phone is behind a firewall that has limited settings for UDP timeouts, then you can configure the "Keep Alive Interval" setting under "Advanced" to a value that is less than the "UDP Keep Alive" timeout. NOTE: This only applies to the SIP negotiations, so RTP (voice data) is still carried over UDP.
  • TLS - If you want to use Secure SIP Messaging then transport should be set to TLS.
  • TCP - is not recommended because it adds to the size of the data packets being transmitted.

Voice Encryption

If you provision voice encryption in the Advanced Provisioner app, you must also make sure it is enabled on the device settings in the Smart PBX app.

Advanced Provisioner > Devices Settings > Lines > Advanced > RTP Encryption (SRTP)

encryption

Smart PBX > Devices > Edit > Advanced > Miscellaneous > Encrypt the audio

encryption_pbx

Codecs

Select which line you are applying the audio settings for. A codec compresses audio data during phone calls and determines how your voice is transmitted. Codecs can vary in how much bandwidth they use.

Type Setting Description
Audio Primary Codec Indicates the primary codec for this device. The primary codec supports audio playback. These settings are inherited from the Smart PBX, if you add or change a codec here, you must also change it in the Smart PBX under Devices.
Secondary Codec Supports playback.
Tertiary Codec Supports capture only.
Quarternary codec Supports both playback and capture.

Date and Time

Provision the date and time settings for the device.

Type Setting Description
Time Format Indicates the time format to display on the device.
Timezone Indicates the timezone for the device. NOTE: This timezone only influences the device itself, the UI retains UI settings or detected settings from the browser.
DHCP Offset If DHCP time offset is enabled, it specifies the offset of the account timezone in seconds from Coordinated Universal Time (UTC).
Daylight Savings Summer Time Indicates if DST should be automatically updated on the device.
Network Time Protocol Primary Server Indicates the server used for network timezones.
Secondary Server Indicates the secondary server used for network timezones.
Date Format Indicate the date format to display on the device.

Settings

Provision general phone settings.

Type Setting Description
HTTP HTTP Allows user access to the web UI of the phone using HTTP.
HTTPS Allows user to access the web UI of the phone using HTTPS.
Admin Password Specifies the password for admin login to the phone. NOTE: If the default password is incorrect, then verify that the password in Advanced Provisioner > Account Settings is set to xxxx there; if not, update it. Then click Save and Yes to rebuild all files. If you only hit save on the device itself it will use the existing defaults.
Username Specifies the username for admin login to the phone.
Factory Reset Password Indicates if password is required for factory reset.
DHCP Option IP Telecom recommends leaving this as default setting "Disabled". After a phone is configured, the provisioning URL changes to a device specific URL. If this option is enabled, the phone will always request the original provisioning URL from DHCP. This should only be enabled when a custom URL is used on location.
White Labeling URLS Provisioning URL IP Telecom recommends leaving this as default URL. This URL ensures that phones can connect with their account specific username/password. This setting is only changed if a customer or partner uses their own proxy.
Dialplan Area Code The dialplan defines an area code rule for the device to allow local dialling. For example, if your local area has a 2-digit area code plus a 7-digit number, when you dial the 7-digit number only, the area code is automatically added.
Minimum length The minimum number of digits that the caller must dial to invoke the area code rule. This is typically the number of digits in your local area phone numbers. If your local numbers have 6 digits, then enter 6.
Maximum length The maximum number of digits that the caller can dial to invoke the area code rule. If your local number is 6 digits, then enter 7 as the maximum. After you dial more than 7 numbers, the device does not trigger the area code rule and simply dials the number that you enter.
Lines Enter the lines that you want to apply the area code rule to, separated by commas.
Dialplan Digitmap (V81+ firmware Only) Enabled IP Telecom recommends leaving this as default "Disabled". The dialplan digitmap is a more advanced method of handling dialplans. Use the instructions provided by the device manufacturer to configure if required.
Hotline Number Enter a number that the phone dials automatically upon picking up the receiver.
Delay Enter the delay (in seconds) that should occur before the phone dials the hotline number.
Use User Settings Enabled Indicates if the user settings on the phone should be preserved during auto provisioning. If you disable this feature, then autoprovisioning might override what the user has set on the phone itself.
Logo Mode Configures the logo for the LCD screen of the device.
URL Configure the access URL for the custom logo file.
Firmware Select Firmware Version Firmware version.
Remote Call Directory Enabled Enables the company directory on the device.
Call Directory Name Name of the phonebook.
Call Directory URL URL of the remote phonebook.
Configuration Settings Custom Config File URL (V81+firmware only) Enter a URL to upload a customer configuration file to overwrite provisioner settings.

Network

IP Telecom recommends using the default network settings. These settings should only be modified by advanced users.

Type Setting Description
IP Configuration IP Address Mode Specifies static or DHCP IP address mode.
IP Address If IP mode is static, this setting indicates the IPV4 or IPV6 address.
Netmask If IP mode is static, this setting indicates the IPV4 or IPV6 subnet mask.
Gateway If IP mode is static, this setting indicates the IPV4 or IPV6 default gateway.
DNS Primary server If IP mode is static, this setting indicates the primary DNS server.
Backup server If IP mode is static, this setting indicates the secondary DNS server.
Static DNS If enabled, the manually configured (static) DNS server overrides any DNS servers provided by DHCP.
TTL Enable Enables or disables the phone to use time-to-live (TTL) in the A record. Time-to-live (TTL) is a value in an IP packet that tells a network router whether or not the packet has been in the network too long and should be discarded. The A record is a basic DNS record used to point a domain or subdomain to an IP address.
VLAN VOIP VLAN Enabled Enables or disables VLAN for the internet.
VOIP VLAN ID VLAN ID, value between 1 and 1094.
PC VLAN Enabled Enables or disables VLAN for the PC.
PC VLAN ID VLAN ID for the PC port, value between 1 and 1094.
VLAN Priority Configures VLAN priority for the internet.
PC Port Priority Configures VLAN priority for the PC.
LLDP Enable Enables or disables the phone to use LLDP.
LLDP Interval Configures how often the phone sends LLDP requests (in seconds). Min = 1, Max = 3600
CDP Enable Enables or disables the phone to use CDP
CDP Interval Configures how often the phone sends CDP requests (in seconds). Min = 1, Max = 3600
General MTU The maximum transmission unit of the network, between 128 and 1500.
Ports PC Port Enables or disables the PC (LAN) port.
RTP Ports Minimum The minimum local RTP port. Value between 1042 and 65535.
Maximum The maximum local RTP port. Value between 1042 and 65535.
DSCP The quality of service DSCP (differentiated service code point) for voice packets.

Combo Keys

Provision a "hotkey" or combo key on your device. Select which line the combo key should apply to and configure the values.

Type Setting Description
Key Type Specify which combo key to use.
Account The account on the phone that should be used to dial to value
Value Enter the destination number; this might be a starcode, extension or phone number for example
Label What label you want the phone to display

Combo key example

Set up a combo key for John Doe at extension 100. When you press the BLF field, it will call John Doe at extension 100.

  • Type: BLF
  • Account: 1
  • Value: 100
  • Label: John

Preferences

Provision general calling preferences for the device.

Type Setting Description
Caller ID Format Indicates how the caller ID is displayed during a call
Voicemail Alert Play Tone Indicates if an alert tone should be played when voicemail is received
Hold Alert Play Tone Specifies if the phone plays a tone to indicate that there is a call on hold
Delay The interval (in seconds) between hold tones being played
Intercom Allow Indicates if and incoming intercom call should be automatically answered
Play Tone Indicates if a warning tone should play when there is an incoming intercom call
Answer Muted Indicates if microphone should be muted when an intercom call is received
Barge Indicates if an intercom call can interrupt an ongoing call
Call Waiting Allow Enable or disable call waiting
Play Tone Indicates if a warning tone plays when a call is waiting
Distinctive Ringtone Internal Ringtone Custom ringtone for internal incoming calls. For more steps see Yealink - Internal and External Ringtone.
External Ringtone Custom ringtone for external incoming calls
Voice Send Gain Speaker Indicates the loudness of the speaker
Handset Indicates the volume on the handset
Headset Indicates the volume on the headset

Block out Rules

This rule prevents the user from dialling the blocked number.

Type Setting Description
Rule Number Enter the number that you want to block.
Lines Enter the lines this rule should apply to, separated by commas

Dialnow and Replace Rules

Dialnow and replace rules allow you to program certain numbers to dial when you press keys. Any pattern that the user dials that match these settings are automatically dialled.

For example if you set the Prefix as 0 and Replace as 0086 (Chinese country code), when you dial 0 out, the number will be replaced by 0086 automatically.

Type Setting Description
Dialnow Rule Enter which keys to dial automatically
Lines Enter each line this should apply to, separated by commas
Replace Prefix Enter the keys that should be replaced
Replacement Enter the keys that they should be replaced with
Lines Enter which lines the replace rules applies to, separated by commas

Sidecars

The Sidecar is an attachment to your telephone, which allows you to speed-dial internal and external phone lines with the press of a single button. The phone numbers programmed into the sidecar should be the most frequently used numbers used throughout the day.

NOTE: Configuration for sidecars is provided on Yealink devices that support sidecars.

Type Setting Description
Key Type Enter the type of speed dial sidecar is being configured
Account Enter which account this sidecar will be used for
Value Enter the key to press for the speed dial
Label Freetext field to describe the type of speed-dial setting