Page 3
Do not dispose of WEEE as unsorted municipal waste and have to collect such WEEE separately. We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and comments to DocsFeedback@yealink.com.
Page 4
Yealink IP phone firmware contains third-party software under the GNU General Public License (GPL). Yealink uses software under the specific terms of the GPL. Please refer to the GPL for the exact terms and conditions of the license. The original GPL license, source code of components licensed under GPL and used in Yealink products can be downloaded from Yealink web site: http://www.yealink.com/GPLOpenSource.aspx?BaseInfoCateId=293&NewsCateId=293&CateId=293.
how to configure BroadSoft features on the BroadWorks web portal and IP phones. For support or service, please contact your Yealink reseller or go to Yealink Technical Support online: http://www.yealink.com/Support.aspx. The information detailed in this guide is applicable to firmware version 80 or higher. The firmware format is like x.x.x.x.rom.
Page 6
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones advanced features on IP phones. Chapter 5, “Configuring Audio Features” describes how to configure the audio features on IP phones. Chapter 6, “Configuring Security Features” describes how to configure the security ...
Table of Contents About This Guide ..............v Documentations ..........................v In This Guide ............................ v Table of Contents ..............vii Product Overview ..............1 VoIP Principle ............................ 1 SIP Components..........................2 SIP IP Phone Models ........................3 Physical Features of IP Phones ....................4 Key Features of IP Phones ......................
Page 8
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Power Indicator LED ........................46 Notification Popups ........................51 Contrast ............................53 Backlight ............................55 Call Display ............................ 56 Web Server Type..........................59 User Password ..........................62 Administrator Password ........................ 64 Keypad Lock ..........................
Table of Contents Call Hold ............................177 Call Forward ..........................181 Call Transfer ..........................199 Network Conference ........................202 Feature Key Synchronization ...................... 204 Transfer on Conference Hang Up ....................206 Directed Call Pickup ........................207 Group Call Pickup ........................213 Dialog Info Call Pickup ........................
Page 10
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones VPN ..............................366 Voice Quality Monitoring ......................369 Quality of Service ........................369 Network Address Translation ..................... 372 802.1X Authentication ......................... 377 TR-069 Device Management ...................... 388 IPv6 Support ..........................393 Configuring Audio Features ..........402 Headset Prior ..........................
Page 11
Table of Contents Troubleshooting Solutions ......................460 Why is the LCD screen blank? ..................... 460 Why doesn’t the IP phone get an IP address? ..............460 Why does the IP phone display “No Service”? ..............461 How do I find the basic information of the IP phone? ............461 Why doesn’t the IP phone upgrade firmware successfully? ..........
Page 12
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Call Conference ........................522 Index ..................528...
Product Overview This chapter contains the following information about IP phones: VoIP Principle SIP Components SIP IP Phone Models VoIP VoIP (Voice over Internet Protocol) is a technology using the Internet Protocol instead of traditional Public Switch Telephone Network (PSTN) technology for voice communications.
Page 14
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones SIP provides capabilities to: Determine the location of the target endpoint -- SIP supports address resolution, name mapping, and call redirection. Determine media capabilities of the target endpoint -- Via Session Description ...
Page 15
IP phones comply with the SIP standard (RFC 3261), and they can only be used within a network that supports this model of phone. For a list of key features available on Yealink IP phones running the latest firmware, refer Key Features of IP Phones...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones In order to operate as SIP endpoints in your network successfully, IP phones must meet the following requirements: A working IP network is established. VoIP gateways are configured for SIP . ...
Page 17
Product Overview In addition to physical features introduced above, IP phones also support the following key features when running the latest firmware: Phone Features Call Options: emergency call, call waiting, call hold, call mute, call forward, call transfer, call pickup, conference. Basic Features: DND, phone lock, auto redial, live dialpad, dial plan, hotline, caller identity, auto answer.
Page 18
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones SRTP (RFC3711) Transport Layer Security (TLS) VLAN (802.1q), QoS Digest authentication using MD5/MD5-sess Secure configuration file via AES encryption Phone lock for personal privacy protection Admin/User configuration mode...
Getting Started This chapter provides basic information and installation instructions of IP phones. This chapter provides the following sections: Connecting the IP Phones Initialization Process Overview Verifying Startup Reading Icons Configuration Methods Provisioning Server Configuring Basic Network Parameters ...
Page 20
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Attach the stand: Connect the handset and optional headset: Connect the network and power: AC power (Optional) Power over Ethernet (PoE) Note PoE is not applicable to the SIP-T23 IP phone. A power adapter should be purchased separately to power it on.
Page 21
Getting Started Connect the included or a standard Ethernet cable between the Internet port on the IP phone and the one on the wall or switch/hub device port. Power over Ethernet With the included or a regular Ethernet cable, IP phones can be powered from a PoE-compliant switch or hub.
Page 22
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones The initialization process of the IP phone is responsible for network connectivity and operation of the IP phone in your local network. Once you connect your IP phone to the network and to an electrical supply, the IP phone begins its initialization process.
Page 23
Getting Started firmware file differs from that of the image stored in the flash memory, the IP phone will perform a firmware update. Downloading the resource files In addition to configuration file(s), the IP phone may require resource files before it can deliver service.
Page 24
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Icon Description Hands-free speakerphone mode Handset mode Headset mode Voice Mail Text Message Auto Answer Do Not Disturb Call Forward/Forwarded Calls Call Hold Call Mute Ringer volume is 0 Phone Lock Received Calls Placed Calls Missed Calls...
Access to specific features is restricted to the administrator. The default password is “admin“(case-sensitive). Not all features are available on phone user interface. For more information, refer to Yealink phone-specific user guide, available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. An administrator or a user can configure IP phones via web user interface. The default user name and password for the administrator to log into the web user interface are both “admin”...
Page 26
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones MAC-Oriented CFG file MAC-local CFG file Common CFG file A Common CFG file contains parameters that affect the basic operation of the IP phone, such as language and volume. It will be effectual for all IP phones of the same model. The common CFG file has a fixed name for each IP phone model.
Page 28
= programablekey.X.history_type = programablekey.X.label = The MAC-local CFG file enables the phone to protect personalized settings. For more information on how to protect personalized settings, refer to Yealink IP Phones Auto Provisioning Guide, available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. Central Provisioning IP phones can be centrally provisioned from a provisioning server using the configuration files (<y0000000000xx>.cfg and <MAC>.cfg).
The provisioning server can be on the local LAN or anywhere on the Internet. Use the following procedure as a recommendation if this is your first provisioning server setup. For more information on how to set up a provisioning server, refer to Yealink IP Phones Auto Provisioning Guide.
MAC-oriented configuration file will override the same one in the common configuration file. Yealink supplies configuration files for each phone model, which is delivered with the phone firmware. The configuration files, supplied with each firmware release, must be used with that release.
Static: You can manually configure the server address via phone user interface or web user interface. For more information on the above methods, refer to Yealink IP Phones Auto Provisioning Guide, available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. In order to get your IP phones running, you must perform basic network setup, such as IP address and subnet mask configuration.
Page 32
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones options field of the DHCP message. The data items themselves are also called options. DHCP can be initiated by simply connecting the IP phone with the network. IP phones broadcast DISCOVER messages to request the network information carried in DHCP options, and the DHCP server responds with specific values in corresponding options.
Page 33
Getting Started For more information on DHCP options, refer to http://www.ietf.org/rfc/rfc2131.txt?number=2131 http://www.ietf.org/rfc/rfc2132.txt?number=2132. If you do not have the ability to configure the DHCP options for discovering the provisioning server on the DHCP server, an alternate method of automatically discovering the provisioning server address is required. Connecting to the secondary DHCP server that responds to DHCP INFORM queries with a requested provisioning server address is one possibility.
Page 34
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default 1-PPPoE 2-Static IP Address Note: If you change this parameter, the IP phone will reboot to make the change take effect. Web User Interface: Network->Basic->IPv4 Config Phone User Interface: Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN Port->IPv4...
Page 35
Getting Started Parameters Permitted Values Default Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN Port->IPv4->DHCP IPv4 Client->Static DNS (Enabled) ->IPv4 Pri DNS network.secondary_dns IPv4 Address Blank Description: Configures the secondary IPv4 DNS server when the static IPv4 DNS is enabled. Example: network.secondary_dns = 202.101.103.54 Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 36
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones In the IPv4 Config block, mark the DHCP radio box. Mark the Static DNS radio box. Enter the desired values in the Primary DNS and Secondary DNS fields. Click Confirm to accept the change. A dialog box pops up to prompt that settings will take effect after a reboot.
Page 37
Getting Started Procedure Network parameters can be configured manually using the configuration files or locally. Configure network parameters of the IP phone manually. Parameters: network.internet_port.type network.ip_address_mode Configuration File <y0000000000xx>.cfg network.internet_port.ip network.internet_port.mask network.internet_port.gateway network.primary_dns network.secondary_dns Configure network parameters of the IP phone manually. Web User Interface Navigate to: Local...
Page 38
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default 0, 1 or 2 network.ip_address_mode Description: Configures the IP address mode. 0-IPv4 1-IPv6 2-IPv4&IPv6 Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 39
Getting Started Parameters Permitted Values Default Description: Configures the IPv4 subnet mask when the IP address mode is configured as IPv4 or IPv4&IPv6, and the Internet (WAN) port type for IPv4 is configured as Static IP Address. Example: network.internet_port.mask = 255.255.255.0 Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 40
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the primary IPv4 DNS server when the IP address mode is configured as IPv4 or IPv4&IPv6, and the Internet (WAN) port type for IPv4 is configured as Static IP Address.
Page 41
Getting Started Select desired value from the pull-down list of Mode (IPv4/IPv6). Click Confirm to accept the change. A dialog box pops up to prompt that settings will take effect after a reboot. Click OK to reboot the phone. To configure a static IPv4 address via web user interface: Click on Network->Basic.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure the IP address mode via phone user interface: Press Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN Port. Press to select IPv4, IPv6 or IPv4&IPv6 from the IP Mode field. Press the Save soft key to accept the change.
Page 43
Getting Started Details of Configuration Parameters: Parameters Permitted Values Default network.internet_port.type 0, 1 or 2 Description: Configures the Internet (WAN) port type for IPv4 when the IP address mode is configured as IPv4 or IPv4&IPv6. 0-DHCP 1-PPPoE 2-Static IP Address Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 44
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the password for PPPoE connection when the IP address mode is configured as IPv4 or IPv4&IPv6, and the Internet port type is configured as PPPoE. Example: network.pppoe.password = yealink123 Note: If you change this parameter, the IP phone will reboot to make the change take...
Page 45
Getting Started To configure PPPoE via phone user interface: Press Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN Port->IPv4->PPPoE IP Client. Enter the user name and password in corresponding fields. Press the Save soft key to accept the change. The IP phone reboots automatically to make settings effective after a period of time.
Page 46
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Full-duplex Full-duplex transmission refers to transmitting voice or data in both directions at the same time; this means one device can send data on the line while receiving data. You can configure the full-duplex transmission on both Internet port and PC port for the IP phone to transmit in 10Mbps or 100Mbps or 1000Mbps (only applicable to SIP-T23G IP phones).
Page 47
Getting Started Parameters Permitted Values Default 0-Auto negotiate 1-Full duplex, 10Mbps 2-Full duplex, 100Mbps 3-Half duplex, 10Mbps 4-Half duplex, 100Mbps 5-Full duplex, 1000Mbps Note: We recommend that you do not change this parameter. If you change this parameter, the IP phone will reboot to make the change take effect. Web User Interface: Network->Advanced->Port Link->WAN Port Link Note: It cannot be configured via web user interface and 1000Mbps is only...
Page 48
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired value from the pull-down list of PC Port Link. Click Confirm to accept the change. The PC port on the back of the IP phone is used to connect a PC. You can enable or disable the PC (LAN) port on the IP phones via web user interface or using configuration files.
Page 49
Getting Started Details of Configuration Parameters: Parameters Permitted Values Default network.PC_port.enable 0 or 1 Description: Enables or disables the PC (LAN) port. 0-Disabled 1-Auto Negotiation Note: If you change this parameter, the IP phone will reboot to make the change take effect.
(X is replaced by the actual firmware version). IP Phone Model Associated Firmware Name Firmware Name Example SIP-T23 (P/G) 44.x.x.x.rom 44.80.0.5.rom Note You can download the latest firmware online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. Do not unplug the network and power cables when the IP phone is upgrading firmware.
Page 51
Getting Started Upgrade via Web User Interface To manually upgrade firmware via web user interface, you need to store firmware to your local system in advance. To upgrade firmware manually via web user interface: Click on Settings->Upgrade. Click Browse. Select firmware from the local system. Click Upgrade.
Page 52
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Configuration changes can be performed using the configuration files or locally. Configure the way for the IP phone to check for configuration files. Parameters: auto_provision.power_on auto_provision.repeat.enable auto_provision.repeat.minutes Configuration auto_provision.weekly.enable <y0000000000xx>.cfg File auto_provision.weekly.begin_time...
Page 53
Getting Started Parameters Permitted Values Default Description: Enables or disables the IP phone to perform an auto provisioning process repeatedly. 0-Disabled 1-Enabled Web User Interface: Settings->Auto provision->Repeatedly Phone User Interface: None auto_provision.repeat.minutes Integer from 1 to 43200 1440 Description: Configures the interval (in minutes) for the IP phone to perform an auto provisioning process repeatedly.
Page 54
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the begin time of the day for the IP phone to perform an auto provisioning process weekly. Note: It works only if the parameter “auto_provision.weekly.enable” is set to 1(Enabled).
Page 55
Getting Started Parameters Permitted Values Default Note: It works only if the parameter “auto_provision.weekly.enable” is set to 1(Enabled). Web User Interface: Settings->Auto provision->Day of Week Phone User Interface: None firmware.url URL within 511 characters Blank Description: Configures the access URL of the firmware file. Example:...
Page 56
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure the way for the IP phone to check for configuration files via web user interface: Click on Settings->Auto Provision. Make the desired change. Click Confirm to accept the change. When the “Power On”...
Configuring Basic Features This chapter provides information for making configuration changes for the following basic features: Power Indicator LED Notification Popups Contrast Backlight Call Display Web Server Type User Password Administrator Password Keypad Lock ...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Do Not Disturb Busy Tone Delay Return Code When Refuse Early Media 180 Ring Workaround Use Outbound Proxy in Dialog SIP Session Timer Session Timer ...
Page 59
Configuring Basic Features is determined by the option “Common Power Light On”. Voice/Text Mail Power Light Flash Voice/Text Mail Power Light Flash allows the power indicator LED to flash when the IP phone receives a voice mail or a text message. If this option is disabled, the status of the power indicator LED is determined by the option “Common Power Light On”.
Page 60
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones p=features-powerled&q=load Details of Configuration Parameters: Permitted Parameters Default Values phone_setting.common_power_led_enable 0 or 1 Description: Enables or disables the power indicator LED to be turned on. 0-Disabled (power indicator LED is off) 1-Enabled (power indicator LED is solid red) Web User Interface: Features->Power LED->Common Power Light On...
Page 61
Configuring Basic Features Permitted Parameters Default Values Web User Interface: Features->Power LED->Voice/Text Mail Power Light Flash Phone User Interface: None phone_setting.mute_power_led_flash_enable 0 or 1 Description: Enables or disables the power indicator LED to flash when a call is mute. 0-Disabled (power indicator LED does not flash) 1-Enabled (power indicator LED fast flashes (300ms) red) If it is set to 0, the status of the power indicator LED is determined by the value of the parameter “phone_setting.common_power_led_enable”.
Page 62
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Permitted Parameters Default Values Description: Enables or disables the power indicator LED to be turned on when the IP phone is busy. 0-Disabled (power indicator LED is off) 1-Enabled (power indicator LED is solid red) If it is set to 0, the status of the power indicator LED is determined by the value of the parameter “phone_setting.common_power_led_enable”.
Configuring Basic Features Notification popups feature allows the IP phone to display the pop-up message when it misses a call, forwards an incoming call to other party or receives a new voice mail or a new text message. Procedure Notification popups can be configured using the configuration files or locally. Configure notification popups.
Page 64
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Permitted Parameters Default Values Description: Enables or disables the IP phone to display the pop-up message box when it misses a call. 0-Disabled 1-Enabled Web User Interface: Features->Notification Popups->Display Missed Call Popup Phone User Interface: None features.forward_call_popup.enable...
Configuring Basic Features To configure the notification popups via web user interface: Click on Features->Notification Popups. Select the desired value from the pull-down list of Display Voice Mail Popup. Select the desired value from the pull-down list of Display Missed Call Popup. Select the desired value from the pull-down list of Display Forward Call Popup.
Page 66
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones ?p=settings-preference&q=load Configure the contrast of the LCD Phone User Interface screen. Details of the Configuration Parameter: Parameter Permitted Values Default phone_setting.contrast Integer from 1 to 10 Description: Configures the contrast of the LCD screen. Note: We recommend that you set the contrast of the LCD screen to 6 as a more comfortable level.
Configuring Basic Features Backlight determines the brightness of the LCD screen display, allowing users to read easily in dark environments. Backlight time specifies the delay time to turn off the backlight when the IP phone is inactive. Backlight turns off quickly if a short backlight time is configured, this may not give users enough time to read messages.
Page 68
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones 0-Always on 15-15s 30-30s 60-60s 120-120s 300-300s 600-600s 1800-1800s If it is set to 60 (60s), the LCD backlight is turned off when the IP phone is inactive for 60 seconds. Web User Interface: Settings->Preference->BackLight Time (seconds) Phone User Interface:...
Configuring Basic Features The following figure shows an example of screen display when Display Called Party Information feature is enabled on the phone. You can customize the call information to be displayed on the IP phone as required. IP phones support five call information display methods: Number+Name, Name, Name+Number, Number and Full Contact Info (display name<sip:xxx@domain.com>).
Page 70
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of Configuration Parameters: Parameters Permitted Values Default phone_setting.called_party_info_display.enable 0 or 1 Description: Enables or disables the IP phone to display the called account information when receiving an incoming call. Web User Interface: Settings->Call Display->Display Called Party Information Phone User Interface:...
Configuring Basic Features The default value is Name+Number. Click Confirm to accept the change. Web server type determines access protocol of the IP phone’s web user interface. IP phones support both HTTP and HTTPS protocols for accessing the web user interface. HTTP is an application protocol that runs on top of the TCP/IP suite of protocols.
Page 72
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of Configuration Parameters: Parameters Permitted Values Default wui.http_enable 0 or 1 Description: Enables or disables the user to access web user interface of the IP phone using HTTP protocol. 0-Disabled 1-Enabled Note: If you change this parameter, the IP phone will reboot to make the change take...
Page 73
Configuring Basic Features Parameters Permitted Values Default Description: Enables or disables the user to access web user interface of the IP phone using HTTPS protocol. 0-Disabled 1-Enabled Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones The default HTTPS port number is 443. Click Confirm to accept the change. A dialog box pops up to prompt that settings will take effect after a reboot. Click OK to reboot the phone. To configure web server type via phone user interface: Press Menu->Settings->Advanced Settings (default password: admin) ->Network->Webserver Type.
Page 75
Configuring Basic Features password as soon as possible. Procedure User password can be changed using the configuration files or locally. Change the user password of the IP phone. Configuration File <y0000000000xx>.cfg Parameter: security.user_password Change the user password of the IP phone. Local Web User Interface Navigate to:...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Valid characters are ASCII characters 32-126(0x20-0x7E) except 58(3A). Click Confirm to accept the change. Note If logging into the web user interface of the phone with the user credential, you need to enter the old user password in the Old Password field.
Page 77
Configuring Basic Features Details of the Configuration Parameter: Parameter Permitted Values Default security.user_password String within 32 characters admin Description: Configures the password of the administrator for web server access. The IP phone uses “admin” as the default administrator password. Example: security.user_password = admin:123 means setting the password of administrator (current user name is “admin”) to password 123.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Valid characters are ASCII characters 32-126(0x20-0x7E). Press the Save soft key to accept the change. Keypad lock is used to lock the IP phone to prevent it from unauthorized use. Once the IP phone is locked, a user must enter the password to unlock it.
Page 79
Configuring Basic Features Assign a keypad lock key. Navigate to: http://<phoneIPAddress>/servlet?p=dsskey &q=load&model=0 Configure the phone lock type. Phone User Change the unlock PIN. Interface Assign a keypad lock key. Details of Configuration Parameters: Parameters Permitted Values Default phone_setting.phone_lock.enable 0 or 1 Description: Enables or disables phone lock feature.
Page 80
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Features->Phone Lock->Keypad Lock Type Phone User Interface: Menu->Settings->Advanced Settings(default password: admin) ->Keypad Lock->Lock type phone_setting.phone_lock.unlock_pin characters within 15 digits Description: Configures the password for unlocking the keypad. Web User Interface: Features->Phone Lock->Phone Unlock PIN (0~15 Digit) Phone User Interface:...
Page 81
Configuring Basic Features Parameter Permitted Values Default Description: Configures a DSS key as a keypad lock key on the IP phone. The digit 50 stands for the key type Keypad Lock. For line keys: X ranges from 1 to 3. For programable keys: X=1-10, 14 Default:...
Page 82
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the desired time in the Phone Lock Time Out (0~3600s) field. Click Confirm to accept the change. To configure a keypad lock key via web user interface: Click on DSSKey->Line Key (Programable Key). In the desired DSS key field, select Keypad Lock from the pull-down list of Type.
Configuring Basic Features To configure a keypad lock key via phone user interface: Press Menu->Features->DSS Keys->Line Keys. Select the desired DSS key and then press Enter soft key. Press , or the Switch soft key to select Keypad Lock from the Type field. (Optional.) Enter the string that will appear on the LCD screen in the Label field.
Page 84
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Option Configuration Methods Phone User Interface Web User Interface Date Phone User Interface Configuration Files Date Format Web User Interface Phone User Interface Configuration Files Daylight Saving Time Web User Interface Procedure Configuration changes can be performed using the configuration files or locally.
Page 85
Configuring Basic Features local_time.time_format local_time.date_format Configure NTP by DHCP priority feature. Configure the NTP server, time zone and DST. Configure the time and date Web User Interface manually. Configure the time and date formats. Navigate to: Local http://<phoneIPAddress>/servlet ?p=settings-datetime&q=load Configure the NTP server and time zone.
Page 86
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default the DHCP server. 0-Disabled 1-Enabled Note: It is only available to offset from GMT 0. Web User Interface: Settings->Time & Date->DHCP Time Phone User Interface: Menu->Settings->Basic Settings->Time & Date->DHCP Time IP Address or Domain local_time.ntp_server1 cn.pool.ntp.org...
Page 87
Configuring Basic Features Parameters Permitted Values Default Description: Configures the interval (in seconds) to update time and date from the NTP server. Example: local_time.interval = 1000 Web User Interface: Settings->Time & Date->Synchronism (15~86400s) Phone User Interface: None local_time.time_zone -11 to +14 Description: Configures the time zone.
Page 88
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default local_time.summer_time 0, 1 or 2 Description: Configures Daylight Saving Time (DST) feature. 0-Disabled 1-Enabled 2-Automatic Web User Interface: Settings->Time & Date->Daylight Saving Time Phone User Interface: Menu->Settings->Basic Settingss->Time &...
Page 89
Configuring Basic Features Parameters Permitted Values Default Month: 1=Jan, 2=Feb,…, 12=Dec Week of Month: 1=the first week in a month,…, 5=the last week in a month Day of Week: 1=Mon, 2=Tues,…, 7=Sun Hour of Day: 0=0am, 1=1am,…, 23=11pm Note: It works only if the parameter “local_time.summer_time” is set to 1 (Enabled). Web User Interface: For DST By Date: Settings->Time &...
Page 90
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Week Last in Month/Stop Hour of Day Phone User Interface: None local_time.offset_time Integer from -300 to 300 Blank Description: Configures the offset time (in minutes) of DST. Note: It works only if the parameter “local_time.summer_time”...
Page 91
Configuring Basic Features Parameters Permitted Values Default Menu->Settings->Basic Settings->Time & Date->Time & Date Format->Hour Clock Refer to the local_time.date_format following content Description: Configures the date format. Valid values are: 0-WWW MMM DD 1-DD-MMM-YY 2-YYYY-MM-DD 3-DD/MM/YYYY 4-MM/DD/YY 5-DD MMM YYYY 6-WWW DD MMM Note: “WWW”...
Page 92
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired value from the pull-down list of NTP by DHCP Priority. Click Confirm to accept the change. To configure the NTP server, time zone and DST via web user interface: Click on Settings->Time &...
Page 93
Configuring Basic Features Enter the end time in the End Date field. Mark the DST By Week radio box in the Fixed Type field. Select the desired values from the pull-down lists of DST Start Month, DST Start Day of Week, DST Start Day of Week Last in Month, DST Stop Month, DST Stop Day of Week and DST Stop Day of Week Last in Month.
Page 94
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select Enabled from the pull-down list of Manual Time. Enter the time and date in the corresponding fields. Click Confirm to accept the change. To configure the time and date format via web user interface: Click on Settings->Time &...
Configuring Basic Features To configure the time and date manually via phone user interface: Press Menu->Settings->Basic Settings->Time & Date->Manual Settings. Enter the date in the Date field. Enter the time in the Time field. Press the Save soft key to accept the change. To configure the time and date formats via phone user interface: Press Menu->Settings->Basic Settings->Time &...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones the phone user interface and web user interface by loading language packs to the IP phone. Language packs can only be loaded using configuration files. The following table lists the available languages and associated language packs for the phone user interface: Associated Language Pack Available Language...
Page 97
Configuring Basic Features The following shows a portion of the language pack “000.GUI.English.lang” for the phone user interface: The following table lists available languages and associated language packs for the web user interface: Associated Note Available Language Associated Language Pack Language Pack English 1.English.js...
Page 98
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Associated Note Available Language Associated Language Pack Language Pack Russian 11.Russian.js 11.Russian_note.xml When adding a new language pack for the web user interface, the language pack must be formatted as “Y.name.js” (Y starts from 12, “name” is replaced with the language name).
Page 99
Configuring Basic Features The following shows a portion of the note language pack “1.English_note.xml” for the web user interface: The new added language must be supported by the font library on the IP phone. If the Note characters in the custom language file are not supported by the phone, the IP phone will display “?”...
Page 100
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Delete customized language packs and note language packs of the web user interface. Parameter: wui_lang.delete Details of the Configuration Parameter: Parameter Permitted Values Default gui_lang.url URL within 511 characters Blank Description: Configures the access URL of the language pack for the phone user interface.
Page 101
Configuring Basic Features Parameter Permitted Values Default 001.GUI.Chinese_S.lang) gui_lang.delete = http://localhost/001.GUI.Chinese_S.lang Note: If you change this parameter, the IP phone will reboot to make the change take effect. Web User Interface: None Phone User Interface: None wui_lang.url URL within 511 characters Blank Description: Configures the access URL of the language pack for the web user interface.
Page 102
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameter Permitted Values Default can configure as following: wui_lang.url = http://192.168.10.25/1.English_note.xml wui_lang.url = http://192.168.10.25/11.Russian_note.xml Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 103
Configuring Basic Features Procedure Specify the language for the phone user interface or the web user interface using the configuration files or locally. Specify the languages for the phone user interface and the web user interface. Configuration File <y0000000000xx>.cfg Parameters: lang.gui lang.wui Specify the language for the web...
Press the Save soft key to accept the change. Input method customization allows users to customize the existing input method on IP phones. You can first customize the Yealink-supplied input method file “ime.txt” or “Russian_ime.txt”, and then download it to the IP phone. If you choose Russian...
Page 105
Configuring Basic Features language for the phone, the input method file will be “Russian_ime.txt”. If you choose other languages for the phone, the default input method file is “ime.txt”. IP phones support 5 input methods: 2aB, abc, Abc, 123, ABC. The following shows a portion of the input method file “ime.txt”:...
Page 106
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones The following shows a portion of the input method file “Russian_ime.txt”:...
Page 107
Configuring Basic Features You can add new characters or adjust the character order of the existing input method. The following show an example of adding some German characters for the input method “abc”. Note When adding new characters for the existing input method, ensure that the added characters are supported by IP phones.
Page 108
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameter: directory.edit_default_input_meth Specify the default input method when searching for contacts. Parameter: directory.search_default_input_m ethod Details of Configuration Parameters: Parameters Permitted Values Default gui_input_method.url Blank URL within 511 characters Description: Configures the access URL of the custom input method file. Example: The following example uses HTTP to download the custom input method file (ime.txt or Russian_ime.txt) from the provisioning server 192.168.10.25.
Configuring Basic Features Parameters Permitted Values Default Web User Interface: None Phone User Interface: None directory.edit_default_input_method Abc, 2aB, 123, abc or ABC Description: Specify the default input method when editing contacts. Example: directory.edit_default_input_method = abc Web User Interface: None Phone User Interface: None Abc, 2aB, 123, abc or ABC directory.search_default_input_method...
Page 110
<=132*64 2 gray scale <=100KB Before uploading your custom logo to IP phones, ensure your logo file is correctly Note formatted. For more information on customizing a logo file, refer to Yealink IP Phones Auto Provisioning Guide, available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. Procedure The logo shown on the idle screen can be configured using the configuration files or locally.
Page 111
Configuring Basic Features Parameters Permitted Values Default If it is set to 1 (System logo), the LCD screen will display the system logo. If it is set to 2 (Custom logo), the LCD screen will display the custom logo (you need to upload a custom logo file to the IP phone).
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select Custom logo from the pull-down list of Use Logo. Click Browse to select the logo file from your local system. Click Upload to upload the file. Click Confirm to accept the change. The image logo screen and the idle screen are displayed alternately.
Page 113
Configuring Basic Features Call State Default Soft Keys Optional Soft Keys Silence Reject Empty Empty Empty Switch Connecting Empty EndCall Connecting Transfer Empty Empty Switch SemiAttendTrans Empty EndCall Send Empty History Delete Switch Dialing EndCall Line Favorite GPickup DPickup Empty Empty Empty Switch...
Page 114
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Call State Default Soft Keys Optional Soft Keys NewCall Answer EndCall Reject Empty Empty Empty Switch Held Empty Answer EndCall Reject NewCall Transfer Empty Directory PreTrans Delete Switch End Call Send Empty Empty...
Page 115
Configuring Basic Features Details of Configuration Parameters: Parameters Permitted Values Default custom_softkey_call_failed.url URL within 511 characters Blank Description: Configures the access URL of the custom file for the soft key presented on the LCD screen when in the Call Failed state. Example: The following example uses HTTP to download the CallFailed state file from the “XMLfiles”...
Page 116
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default custom_softkey_connecting.url = http://10.2.8.16:8080/XMLfiles/Connecting.xml Web User Interface: None Phone User Interface: None custom_softkey_dialing.url URL within 511 characters Blank Description: Configures the access URL of the custom file for the soft key presented on the LCD screen when in the Dialing state.
Page 117
Configuring Basic Features Parameters Permitted Values Default Description: Configures the access URL of the custom file for the soft key presented on the LCD screen when in the Talking state. Example: The following example uses HTTP to download the Talking state file from the “XMLfiles”...
Page 118
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones The LCD screen displays the soft keys in the adjusted order. Click Confirm to accept the change. Key as send allows assigning the pound key or asterisk key as a send key. Send sound allows the IP phone to play a key tone when a user presses the send key.
Page 119
Configuring Basic Features tone. Navigate to: http://<phoneIPAddress>/servlet ?p=features-audio&q=load Configure the send key. Phone User Interface Configure a key tone. Details of Configuration Parameters: Parameters Permitted Values Default features.key_as_send 0, 1 or 2 Description: Configures the "#" or "*" key as the send key. 0-Disabled 1-# key 2-* key...
Page 120
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default features.send_key_tone 0 or 1 Description: Enables or disables the IP phone to play a tone when a user presses a send key. 0-Disabled 1-Enabled If it is set to 1 (Enabled), the IP phone will play a tone when a user presses a send key.
Configuring Basic Features To configure a send sound and key tone via web user interface: Click on Features->Audio. Select the desired value from the pull-down list of Key Sound. Select the desired value from the pull-down list of Send Sound. Click Confirm to accept the change.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Area Code Block Out You need to know the following basic regular expression syntax when creating dial plan: The dot “.” can be used as a placeholder or multiple placeholders for any string.
Page 123
Configuring Basic Features Procedure Replace rule can be created using the configuration files or locally. Create the replace rule for the IP phone. Parameters: dialplan.replace.prefix.X dialplan.replace.replace.X Configuration File <y0000000000xx>.cfg dialplan.replace.line_id.X Configure the access URL of the replace rule template. Parameter: dialplan_replace_rule.url Create the replace rule for the IP phone.
Page 124
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the alternate number to replace the entered number. Example: dialplan.replace.replace.1 = 123456 Web User Interface: Settings->Dial Plan->Replace Rule->Replace Phone User Interface: None dialplan.replace.line_id.X Blank (for 0 to 3 all lines) (X ranges from 1 to 100)
Configuring Basic Features Enter the string in the Replace field. Enter the desired line ID in the Account field or leave it blank. If you leave this field blank or enter 0, the replace rule will apply to all accounts on the IP phone.
Page 126
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Dial-now rule can be created using the configuration files or locally. Create the dial-now rule for the IP phone. Parameters: dialplan.dialnow.rule.X dialplan.dialnow.line_id.X Configuration File <y0000000000xx>.cfg Configure the delay time for the dial-now rule and the access URL of the dial-now template.
Page 127
Configuring Basic Features Parameters Permitted Values Default Settings->Dial Plan->Dial-now->Rule Phone User Interface: None dialplan.dialnow.line_id.X Blank (for Integer from 0 to 3 all lines) (X ranges from 1 to 100) Description: Configures the desired line to apply the dial-now rule. The digit 0 stands for all lines. If it is left blank, the dial-now rule will apply to all lines on the IP phone.
Page 128
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default None To create a dial-now rule via web user interface: Click on Settings->Dial Plan->Dial-now. Enter the desired value in the Rule field. Enter the desired line ID in the Account field or leave it blank. If you leave this field blank or enter 0, the dial-now rule will apply to all accounts on the IP phone.
Configuring Basic Features Enter the desired time within 1-14 (in seconds) in the Time-Out for Dial-Now Rule field. Click Confirm to accept the change. Area codes are also known as Numbering Plan Areas (NPAs). They usually indicate geographical areas in one country. When entered numbers match the predefined area code rule, the IP phone will automatically add the area code before the numbers when dialing out them.
Page 130
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Navigate to: http://<phoneIPAddress>/servlet ?p=settings-areacode&q=load Details of Configuration Parameters: Parameters Permitted Values Default dialplan.area_code.code String within 16 characters Blank Description: Configures the area code to be added before the entered numbers when dialing out.
Page 131
Configuring Basic Features Parameters Permitted Values Default None Blank (for dialplan.area_code.line_id Interger from 0 to 3 all lines) Description: Configures the desired line to apply the area code rule. The digit 0 stands for all lines. If it is left blank, the area code rule will apply to all lines on the IP phone. Example: dialplan.area_code.line_id = 1,2 Note: Multiple line IDs are separated by commas.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Block out rule prevents users from dialing out specific numbers. When entered numbers match the predefined block out rule, the LCD screen prompts “Forbidden Number”. IP phones support up to 10 block out rules. Procedure Block out rule can be created using the configuration files or locally.
Configuring Basic Features Parameters Permitted Values Default Example: dialplan.block_out.line_id.1 = 1,2,3 Note: Multiple line IDs are separated by commas. Web User Interface: Settings->Dial Plan->Block Out->Account Phone User Interface: None To create a block out rule via web user interface: Click on Settings->Dial Plan->Block Out. Enter the desired value in the BlockOut NumberX field.
Page 134
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Hotline can be configured using the configuration files or locally. Configure the hotline number. Parameter: features.hotline_number Specify the time (in seconds) the Configuration File <y0000000000xx>.cfg IP phone waits before automatically dialing out the hotline number.
Page 135
Configuring Basic Features Parameter Permitted Values Default Phone User Interface: Menu->Features->Hot Line->Hot Number features.hotline_delay Integer from 0 to 10 Description: Configures the waiting time (in seconds) for the IP phone to automatically dial out the hotline number. If it is set to 0 (0s), the IP phone will immediately dial out the preconfigured hotline number when you lift the handset, press the speakerphone key or press the line key.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure hotline via phone user interface: Press Menu->Features->Hot Line. Enter the hotline number in the Hot Number field. Enter the waiting time (in seconds) in the Hot Line Delay field. Press the Save soft key to accept the change.
Configuring Basic Features Parameter Permitted Values Default Description: Enables or disables the IP phone to first dial out a pre-configured number when a user places a call or goes off hook using account X. 0-Disabled 1-Enabled If it is set to 1(Enabled), the phone will first dial out the pre-configured number (configured by the parameter “account.X.auto_dial_num”) when a user places a call or goes off hook using account X.
Page 138
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Directory can be configured using the configuration files or locally. Specify the access URL of the Directory file. Configuration File <y0000000000xx>.cfg Parameter: directory_setting.url Configure the Directory. Navigate to: Local Web User Interface http://<phoneIPAddress>/servlet ?p=contacts-favorite&q=load...
Page 139
Configuring Basic Features To adjust the display order of list, select the desired list and then click Click Confirm to accept the change. The IP phone LCD screen will display the enabled list(s) in the adjusted order. Search source list in dialing allows the IP phone to automatically search entries from the search source list based on the entered string, and display results on the pre-dialing screen.
Page 140
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of the Configuration Parameter: Parameter Permitted Values Default super_search.url URL within 511 characters Blank Description: Configures the access URL of the super search template. Web User Interface: Directory->Setting->Search Source List In Dialing Phone User Interface: None To configure search source list in dialing via web user interface:...
Configuring Basic Features Call log contains call information such as remote party identification, time and date, and call duration. It can be used to redial previous outgoing calls, return incoming calls, and save contact information from call log lists to the contact directory. IP phones maintain a local call log.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure call log feature via web user interface: Click on Features->General Information. Select the desired value from the pull-down list of Save Call Log. Click Confirm to accept the change. To configure call log feature via phone user interface: Press Menu->Features->History Setting.
Page 143
Configuring Basic Features Procedure Missed call log can be configured using the configuration files or locally. Configure missed call log feature. Configuration File <MAC>.cfg Parameter: account.X.missed_calllog Configure missed call log feature. Navigate to: Local Web User Interface http://<phoneIPAddress>/servlet ?p=account-basic&q=load&acc Details of the Configuration Parameter: Parameter Permitted Values Default...
Contacts and groups can be added either one by one or in batch using a local contact file. Yealink IP phones support both *.xml and *.csv format contact files. For more information on how to customize a contact file (*.xml), refer to Local Contact File page 445.
Page 145
Configuring Basic Features local directory. Details of the Configuration Parameter: Parameter Permitted Values Default local_contact.data.url URL within 511 characters Blank Description: Configures the access URL of the local contact file (*.xml). Example: local_contact.data.url = http://192.168.10.25/contact.xml Web User Interface: Directory->Local Directory->Import Local Directory File Phone User Interface: None To add a group to the local directory via web user interface:...
Page 146
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones In the Directory block, enter the name and the office, mobile or other numbers in the corresponding fields. Select the desired ring tone from the pull-down list of Ring Tone. Select the desired group from the pull-down list of Group.
Page 147
Configuring Basic Features Click Browse to locate a contact list file (the file format must be *.xml) from your local system. Click Import XML to import the contact list. The web user interface prompts "The original contact will be covered, Continue?". Click OK to complete importing the contact list.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones At least one row information should be selected to be imported into the local directory. Click Import to complete importing the contact list. To export a contact list via web user interface: Click on Directory->Local Directory.
Page 149
Configuring Basic Features Procedure Live dialpad can be configured using the configuration files or locally. Configure live dialpad. Parameters: Configuration File <y0000000000xx>.cfg phone_setting.predial_autodial phone_setting.inter_digit_time Configure live dialpad. Navigate to: Local Web User Interface http://<phoneIPAddress>/servlet ?p=settings-preference&q=load Details of Configuration Parameters: Parameters Permitted Values Default phone_setting.predial_autodial...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure live dialpad via web user interface: Click on Settings->Preference. Select the desired value from the pull-down list of Live Dialpad. Enter the desired delay time in the Inter Digit Time (1~14s) field. Click Confirm to accept the change.
Page 151
Configuring Basic Features Navigate to: http://<phoneIPAddress>/servlet ?p=features-general&q=load Configure call waiting tone. Navigate to: http://<phoneIPAddress>/servlet ?p=features-audio&q=load Configure call waiting and call Phone User Interface waiting tone. Details of Configuration Parameters: Parameters Permitted Values Default call_waiting.enable 0 or 1 Description: Enables or disables call waiting feature. 0-Disabled 1-Enabled If it is set to 0 (Disabled), a new incoming call is automatically rejected by the IP...
Page 152
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Features->Audio->Call Waiting Tone Phone User Interface: Menu->Features->Call Waiting->Play Tone call_waiting.on_code String within 32 characters Blank Description: Configures the call waiting on code to activate the server-side call waiting feature. The IP phone will send the call waiting on code to the server when you activate call waiting feature on the IP phone.
Page 153
Configuring Basic Features (Optional.) Enter the call waiting off code in the Call Waiting Off Code field. Click Confirm to accept the change. To configure call waiting tone via web user interface: Click on Features->Audio. Select the desired value from the pull-down list of Call Waiting Tone. Click Confirm to accept the change.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Press the Save soft key to accept the change. Auto redial allows IP phones to redial a busy number after the first attempt. Both the number of attempts and waiting time between redials are configurable. Procedure Auto redial can be configured using the configuration files or locally.
Page 155
Configuring Basic Features Parameters Permitted Values Default Description: Configures the interval (in seconds) for the IP phone to wait between redials. The IP phone redials the dialed number at regular intervals till the callee answers the call. Web User Interface: Features->General Information->Auto Redial Interval (1~300s) Phone User Interface: Menu->Features->Auto Redial->Redial Interval...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones The default value is 10. Click Confirm to accept the change. To configure auto redial via phone user interface: Press Menu->Features->Auto Redial. Press , or the Switch soft key to select the desired value from the Auto Redial field.
Page 157
Configuring Basic Features features.auto_answer_delay Configure auto answer. Navigate to: http://<phoneIPAddress>/servlet ?p=account-basic&q=load&acc Web User Interface Specify a period of delay time for Local auto answer. Navigate to: http://<phoneIPAddress>servlet? p=features-general&q=load Phone User Interface Configure auto answer. Details of Configuration Parameters: Parameters Permitted Values Default account.X.auto_answer 0 or 1...
Page 158
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Phone User Interface: None To configure auto answer via web user interface: Click on Account. Select the desired account from the pull-down list of Account. Click on Basic. Select the desired value from the pull-down list of Auto Answer.
Configuring Basic Features Enter the desired time in the Auto-Answer Delay (1~4s) field. Click Confirm to accept the change. To configure auto answer via phone user interface: Press Menu->Settings->Advanced Settings (default password: admin) ->Accounts. Select the desired account and then press the Enter soft key. Press , or the Switch soft key to select the desired value from the Auto Answer field.
Page 160
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Call completion can be configured using the configuration files or locally. Configure call completion. Configuration File <y0000000000xx>.cfg Parameter: features.call_completion_enable Configure call completion. Navigate to: Web User Interface http://<phoneIPAddress>/servlet Local ?p=features-general&q=load Phone User Interface Configure call completion.
Configuring Basic Features Select the desired value from the pull-down list of Call Completion. Click Confirm to accept the change. To configure call completion via phone user interface: Press Menu->Features->Call Completion. Press , or the Switch soft key to select the desired value from the Call Completion field.
Page 162
Contact: <sip:1009@10.3.20.10:5060> Content-Type: application/sdp Allow: INVITE, INFO, PRACK, ACK, BYE, CANCEL, OPTIONS, NOTIFY, REGISTER, SUBSCRIBE, REFER, PUBLISH, UPDATE, MESSAGE Max-Forwards: 70 User-Agent: Yealink SIP-T23 44.80.208.62 line=0 Allow-Events: talk,hold,conference,refer,check-sync P-Preferred-Identity: <sip:1009@10.3.5.199> Privacy: id Content-Length: 302 The anonymous call on code and anonymous call off code configured on IP phones are used to activate/deactivate the server-side anonymous call feature.
Page 163
Configuring Basic Features Details of Configuration Parameters: Parameters Permitted Values Default account.X.anonymous_call 0 or 1 (X ranges from 1 to 3) Description: Enables or disables anonymous call feature for account X. 0-Disabled 1-Enabled If it is set to 1 (Enabled), the IP phone will block its identity from showing up to the callee when placing a call.
Page 164
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the anonymous call on code to activate the server-side anonymous call feature for account X. Example: account.1.anonymous_call_oncode = *72 Note: It works only if the parameter “account.X.send_anonymous_code” is set to 1 (On Code).
Configuring Basic Features (Optional.) Enter the anonymous call off code in the Off Code field. Click Confirm to accept the change. To configure the anonymous call via phone user interface: Press Menu->Features->Anonymous Call. Press , or the Switch soft key to select the desired line from the Line ID field.
Page 166
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Anonymous call rejection can be configured using the configuration files or locally. Configure anonymous call rejection. Parameters: account.X.reject_anonymous_call Configuration File <MAC>.cfg account.X.send_anonymous_rejection_c account.X.anonymous_reject_oncode account.X.anonymous_reject_offcode Configure anonymous call rejection. Navigate to: Web User Interface http://<phoneIPAddress>/servlet?p=acc Local...
Page 167
Configuring Basic Features Parameters Permitted Values Default Configures what code sent to the server for account X. 0- off code 1- on code Web User Interface: Account->Basic->Send Anonymous Rejection Code Phone User Interface: Menu->Features->Anonymous Call->Send rejection Code account.X.anonymous_reject_oncode String within 32 Blank characters (X ranges from 1 to 3)
Page 168
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure anonymous call rejection via web user interface: Click on Account. Select the desired account from the pull-down list of Account. Click on Basic. Select the desired value from the pull-down list of Local Anonymous Rejection. Select the desired value from the pull-down list of Send Anonymous Rejection code.
Configuring Basic Features Do Not Disturb (DND) allows IP phones to ignore incoming calls. DND feature can be configured on a phone or a per-line basis depending on the DND mode. Two DND modes: Phone (default): DND feature is effective for the IP phone. ...
Page 170
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones features.dnd.on_code features.dnd.off_code Specify the return code and the reason of the SIP response message when DND is enabled. Parameter: features.dnd_refuse_code Assign a DND key. Navigate to: http://<phoneIPAddress>/servlet? p=dsskey&q=load&model=0 Configure DND. Navigate to: http://<phoneIPAddress>/servlet? Web User Interface...
Page 171
Configuring Basic Features Parameters Permitted Values Default Menu->Features->DND->Account->DND Enable. account.X.dnd.on_code String within 32 characters Blank (X ranges from 1 to 3) Description: Configures the DND on code to activate the server-side DND feature for account X when the DND mode is configured as Custom. The IP phone will send the DND on code to the server when you activate DND feature for account X on the IP phone.
Page 172
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Features->Forward& DND->DND->Mode Phone User Interface: None features.dnd.enable 0 or 1 Description: Enables or disables DND feature when the DND mode is configured as Phone. 0-Disabled 1-Enabled If it is set to 1 (Enabled), the IP phone will reject incoming calls on all accounts.
Page 173
Configuring Basic Features Parameters Permitted Values Default Description: Configures the DND off code to deactivate the server-side DND feature when the DND mode is configured as Phone. The IP phone will send the DND off code to the server when you deactivate DND feature on the IP phone. Example: features.dnd.off_code = *72 Web User Interface:...
Page 174
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameter Permitted Values Default Description: Configures a DSS key as a DND key on the IP phone. The digit 5 stands for the key type DND. For line keys: X ranges from 1 to 3. For programable keys: X=1-10, 14.
Page 175
Configuring Basic Features To configure a DND key via web user interface: Click on DSSKey->Line Key (Programable Key). In the desired DSS key field, select DND from the pull-down list of Type. Click Confirm to accept the change. To configure DND feature via web user interface: Click on Features->Forward &...
Page 176
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones 4) (Optional.) Enter the DND off code in the DND Off Code field. Click Confirm to accept the change. To specify the return code and the reason when DND is enabled via web user interface: Click on Features->General Information.
Configuring Basic Features To configure a DND key via phone user interface: Press Menu->Features->DSS Keys. Select the desired DSS key. Press , or the Switch soft key to select Key Event from the Type field. Press , or the Switch soft key to select DND from the Key Type field. (Optional.) Enter the string that will appear on the LCD screen in the Label field.
Page 178
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of the Configuration Parameter: Parameter Permitted Values Default features.busy_tone_delay 0, 3 or 5 Description: Configures the duration time (in seconds) for the busy tone. When one party releases the call, a busy tone is audible to the other party indicating that the call connection breaks.
Configuring Basic Features Return code when refuse defines the return code and reason of the SIP response message for the refused call. The caller’s phone LCD screen displays the reason according to the received return code. Available return codes and reasons are: 404 (Not found) ...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameter Permitted Values Default Phone User Interface: None To specify the return code and the reason when refusing a call via web user interface: Click on Features->General Information. Select the desired value from the pull-down list of Return Code When Refuse. Click Confirm to accept the change.
Page 181
Configuring Basic Features Procedure 180 ring workaround can be configured using the configuration files or locally. Configure 180 ring workaround. Configuration File <y0000000000xx>.cfg Parameter: phone_setting.is_deal180 Configur 180 ring workaround. Navigate to: Local Web User Interface http://<phoneIPAddress>/servlet ?p=features-general&q=load Details of the Configuration Parameter: Parameter Permitted Values Default...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired value from the pull-down list of 180 Ring Workaround. Click Confirm to accept the change. An outbound proxy server can receive all initiating request messages and route them to the designated destination.
Page 183
Configuring Basic Features Details of the Configuration Parameter: Parameter Permitted Values Default sip.use_out_bound_in_dialog 0 or 1 Description: Enables or disables the IP phone to keep sending SIP requests to the outbound proxy server in a dialog. 0-Disabled 1-Enabled If it is set to 1 (Enabled), all the SIP request messages from the IP phone will be forced to send to the outbound proxy server in a dialog.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones SIP session timers T1, T2 and T4 are SIP transaction layer timers defined in RFC 3261. Timer T1 is an estimate of the Round Trip Time (RTT) of transactions between a SIP client and SIP server.
Page 185
Configuring Basic Features Parameters Permitted Values Default Description: Configures the session timer T2 (in seconds). T2 represents the maximum retransmit interval for non-INVITE requests and INVITE responses. Web User Interface: Settings->SIP->SIP Session Timer T2 (2~40s) Phone User Interface: None Float from 2.5 to sip.timer_t4 Description: Configures the session timer of T4 (in seconds).
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones The default value is 5s. Click Confirm to accept the change. Session timer allows a periodic refresh of SIP sessions through a re-INVITE request, to determine whether a SIP session is still active. Session timer is specified in RFC 4028. IP phones support two refresher modes: UAC and UAS.
Page 187
Configuring Basic Features Details of Configuration Parameters: Parameters Permitted Values Default account.X.session_timer.enable 0 or 1 (X ranges from 1 to 3) Description: Enables or disables the session timer for account X. 0-Disabled 1-Enabled If it is set to 1 (Enabled), IP phone will send periodic re-INVITE requests to refresh the session during a call.
Page 188
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the session timer refresher for account X. 0-UAC 1-UAS If it is set to 0 (UAC), refreshing the session is performed by the IP phone. If it is set to 1 (UAS), refreshing the session is performed by a SIP server.
Configuring Basic Features Call hold provides a service of placing an active call on hold. When a call is placed on hold, the IP phones send an INVITE request with HOLD SDP to request remote parties to stop sending media and to inform them that they are being held. IP phones support two call hold methods, one is RFC 3264, which sets the “a”...
Page 190
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones http://<phoneIPAddress>/servlet ?p=features-general&q=load Configure MoH on a per-line basis. Navigate to: http://<phoneIPAddress>/servlet ?p=account-adv&q=load&acc= Details of Configuration Parameters: Parameters Permitted Values Default features.play_hold_tone.enable 0 or 1 Description: Enables or disables the IP phone to play a tone when there is a call on hold. 0-Disabled 1-Enabled Web User Interface:...
Page 191
(X ranges from 1 to 3) Description: Configures the address of the Music On Hold server for account X. Examples for valid values: <10.1.3.165>, 10.1.3.165, sip:moh@sip.com, <sip:moh@sip.com>, <yealink.com> or yealink.com. Example: account.1.music_server_uri =<10.1.3.165> Note: The DNS query in this parameter only supports A query.
Page 192
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired value from the pull-down list of RFC 2543 Hold. Click Confirm to accept the change. To configure call hold tone and call hold tone delay via web user interface: Click on Features->General Information.
Configuring Basic Features To configure MoH via web user interface: Click on Account. Select the desired account from the pull-down list of Account. Click on Advanced. Enter the SIP URI (e.g., sip:moh@sip.com) in the Music Server URI field. Click Confirm to accept the change. Call forward allows users to redirect an incoming call to a third party.
Page 194
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones answer forward settings. The call forward on code and call forward off code configured on IP phones are used to activate/deactivate the server-side call forward feature. They may vary on different servers.
Page 195
Configuring Basic Features Parameters: forward.always.enable forward.always.target forward.always.on_code forward.always.off_code forward.busy.enable forward.busy.target forward.busy.on_code forward.busy.off_code forward.no_answer.enable forward.no_answer.target forward.no_answer.timeout forward.no_answer.on_code forward.no_answer.off_code Configure diversion/history-info feature. Parameter: features.fwd_diversion_enable Configure forward international. Parameter: forward.international.enable Configure call forward. Navigate to: http://<phoneIPAddress>/servlet?p =features-forward&q=load Web User Configure diversion/history-info Interface feature. Local Configure forward international.
Page 196
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of Configuration Parameters: Parameters Permitted Values Default account.X.always_fwd.enable 0 or 1 (X ranges from 1 to 3) Description: Enables or disables always forward feature for account X when the call forward mode is configured as Custom 0-Disabled 1-Enabled...
Page 197
Configuring Basic Features Parameters Permitted Values Default account.1.always_fwd.on_code = *72 Web User Interface: Features->Forward& DND->Forward->Always Forward->On Code Phone User Interface: Menu->Features->Call Forward->Always Forward->On Code account.X.always_fwd.off_code String within 32 characters Blank (X ranges from 1 to 3) Description: Configures the always forward off code to deactivate the server-side always forward feature for account X .
Page 198
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the destination number of the busy forward for account X when the call forward mode is configured as Custom. Example: account.1.busy_fwd.target = 3602 Web User Interface: Features->Forward&...
Page 199
Configuring Basic Features Parameters Permitted Values Default Phone User Interface: Menu->Features->Call Forward->Busy Forward->Off Code account.X.timeout_fwd.enable 0 or 1 (X ranges from 1 to 3) Description: Enables or disables no answer forward feature for account X when the call forward mode is configured as Custom. 0-Disabled 1-Enabled If it is set to 1 (Enabled), incoming calls to the account X are forwarded to the...
Page 200
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures ring times (N) to wait before forwarding incoming calls for account X when the call forward mode is configured as Custom. Incoming calls will be forwarded when not answered after N*6 seconds. Web User Interface: Features->Forward&...
Page 201
Configuring Basic Features Parameters Permitted Values Default features.fwd_mode 0 or 1 Description: Configures the call forward mode for the IP phone. 0-Phone 1-Custom If it is set to 0 (Phone), call forward feature is effective for the IP phone. If it is set to 1 (Custom), you can configure call forward feature for each account. Web User Interface: Features->Forward&DND->Forward->Forward->Mode Phone User Interface:...
Page 202
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the always forward on code to activate the server-side always forward feature. The IP phone will send the always forward on code and the pre-configured destination number to the server when you activate always forward feature on the IP phone.
Page 203
Configuring Basic Features Parameters Permitted Values Default forward.busy.target String within 32 characters Blank Description: Configures the destination number the IP phone forwards incoming calls to when busy. Example: forward.busy.target = 3602 Web User Interface: Features->Forward &DND->Forward->Busy Forward->Target Phone User Interface: Menu->Features->Call Forward->...
Page 204
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Menu->Features->Call Forward->Busy Forward->Off Code forward.no_answer.enable 0 or 1 Description: Enables or disables no answer forward feature. 0-Disabled 1-Enabled If it is set to 1 (Enabled), incoming calls are forwarded to the destination number after a period of ring time.
Page 205
Configuring Basic Features Parameters Permitted Values Default forward.no_answer.on_code String within 32 characters Blank Description: Configures the no answer forward on code to activate the server-side no answer forward feature. The IP phone will send the no answer forward on code and the pre-configured destination number to the server when you activate no answer forward feature on the IP phone.
Page 206
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default None forward.international.enable 0 or 1 Description: Enables or disables the IP phone to forward incoming calls to international numbers (the prefix is 00). 0-Disabled 1-Enabled Web User Interface: Features->General Information->Fwd International Phone User Interface: Menu->Settings->Advanced Settings (default password: admin)->FWD...
Page 207
Configuring Basic Features 4) Select the ring time to wait before forwarding from the pull-down list of After Ring Time (0~120s) (only for the no answer forward). b) If you mark the Custom radio box: 1) Select the desired account from the pull-down list of Account. 2) Mark the desired radio box in the Always/Busy/No Answer Forward field.
Page 208
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired value from the pull-down list of Diversion/History-Info. Click Confirm to accept the change. To configure forward international via web user interface: Click on Features->General Information. Select the desired value from the pull-down list of Fwd International. Click Confirm to accept the change.
Page 209
Configuring Basic Features To configure call forward in phone mode via phone user interface: Press Menu->Features->Call Forward. Press to select the desired forwarding type, and then press the Enter soft key. Depending on your selection: a) If you select Always Forward: 1) Press , or the Switch soft key to select the desired value from the Always Forward field.
Page 210
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure call forward in custom mode via phone user interface: Press Menu->Features->Call Forward. Press to select the desired account, and then press the Enter soft key. Press to select the desired forwarding type, and then press the Enter soft key.
Configuring Basic Features The default ring time is 12 seconds. 4) (Optional.) Enter the no answer forward on code and off code respectively in the On Code and Off Code fields. You can also configure the no answer forward for all accounts. After the no answer forward was configured for a specific account, do the following: 1) Press to highlight the No Answer Forward field.
Page 212
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Specify whether to complete the transfer through on-hook. Parameters: transfer.blind_tran_on_hook_enable transfer.on_hook_trans_enable Configuration File <y0000000000xx>.cfg Configure semi-attended transfer feature. Parameter: transfer.semi_attend_tran_enable Specify whether to complete the transfer through on-hook. Configure semi-attended transfer feature.
Page 213
Configuring Basic Features Parameters Permitted Values Default Description: Enables or disables the IP phone to complete the semi-attended/attended transfer through on-hook besides pressing the Transfer/Tran soft key or TRAN/TRANSFER key. 0-Disabled 1-Enabled Web User Interface: Features->Transfer->Attend Transfer On Hook Phone User Interface: None transfer.semi_attend_tran_enable 0 or 1...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Network conference, also known as centralized conference, provides users with flexibility of call with multiple participants (more than three). IP phones implement network conference using the REFER method specified in RFC 4579. This feature depends on support from a SIP server.
Page 215
Configuring Basic Features Parameters Permitted Values Default Description: Configures the network conference URI for account X. Example: account.1.conf_uri = conference@example.com Note: It works only if the parameter “account.X.conf_type” is set to 2 (Network Conference). Web User Interface: Account->Advanced->Conference URI Phone User Interface: None...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure the network conference via web user interface: Click on Account. Select the desired account from the pull-down list of Account. Click on Advanced. Select Network Conference from the pull-down list of Conference Type. Enter the conference URI in the Conference URI field.
Page 217
Configuring Basic Features bw.feature_key_sync Configure network conference. Navigate to: Local Web User Interface http://<phoneIPAddress>/servlet ?p=features-general&q=load Details of Configuration Parameter: Parameters Permitted Values Default bw.feature_key_sync 0 or 1 Description: Enables or disables feature key synchronization. 0-Disabled 1-Enabled Web User Interface: Features->General Information->Feature Key Synchronization Phone User Interface: None To configure feature key synchronization via web user interface:...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Click Confirm to accept the change. For a conference call, all parties drop the call when the conference initiator drops the conference call. For local conference, transfer on conference hang up allows the other two parties to remain connected when the conference initiator drops the conference call.
Configuring Basic Features Parameter & Description Permitted Values Default None To configure Transfer on Conference Hang up via web user interface: Click on Features->Transfer. Select the desired value from the pull-down list of Transfer on Conference Hang up. Click Confirm to accept the change. Directed call pickup is used for picking up an incoming call on a specific extension.
Page 220
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones features.pickup.direct_pickup_ enable features.pickup.direct_pickup_c Assign a directed call pickup key. Parameters: linekey.X.type/ programablekey.X.type linekey.X.line/ programablekey.X.line linekey.X.value/ programablekey.X.value Assign a directed call pickup key. Navigate to: http://<phoneIPAddress>/servl et?p=dsskey&q=load&model= Configure directed call pickup feature on a phone basis.
Page 221
Configuring Basic Features Parameters Permitted Values Default Description : Configures the directed call pickup code for account X. Example: account.1.direct_pickup_code = *68 Note: The directed call pickup code configured on a per-line basis takes precedence over that configured on a phone basis. Web User Interface: Account->Advanced->Directed Call Pickup Code Phone User Interface:...
Page 222
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Directed Call Pickup Key For more information on how to configure the DSS Key, refer to Appendix D: Configuring DSS Key on page 471. Parameters Permitted Values Default linekey.X.type/ Refer to the following programablekey.X.type content Description:...
Page 223
Configuring Basic Features Parameters Permitted Values Default linekey.X.line/ 1-6 for lines 1-6, 1 for Integer from 1 to 6 programablekey.X.line programable key Description: Configures the desired line to apply the directed call pickup key. For line keys: X ranges from 1 to 3. For programable keys: X=1-10, 14 Example:...
Page 224
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired line from the pull-down list of Line. Click Confirm to accept the change. To configure directed call pickup feature on a phone basis via web user interface: Click on Features->Call Pickup.
Configuring Basic Features Enter the directed call pickup code in the Directed Call Pickup Code field. Click Confirm to accept the change. To configure a directed pickup key via phone user interface: Press Menu->Features->DSS Keys->Line Keys. Select the desired DSS key and then press Enter soft key. Press , or the Switch soft key to select Key Event from the Type field.
Page 226
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Group call pickup can be configured using the configuration files or locally. Configure the group call pickup feature. Parameters: <MAC>.cfg features.pickup.group_pickup_enable account.X.group_pickup_code features.pickup.group_pickup_code Configuration File Assign a group call pickup key. Parameters: <y0000000000xx>.cf linekey.X.type/ programablekey.X.type...
Page 227
Configuring Basic Features Details of Configuration Parameters: Parameters Permitted Values Default 0 or 1 features.pickup.group_pickup_enable Description: Enables or disables the IP phone to display the GPickup soft key when the IP phone is in the pre-dialing screen. 0-Disabled 1-Enabled Web User Interface: Features->Call Pickup->Group Call Pickup Phone User Interface: None...
Page 228
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Phone User Interface: None Group Call Pickup Key For more information on how to configure the DSS Key, refer to Appendix D: Configuring DSS Key on page 471. Parameters Permitted Values Default...
Page 229
Configuring Basic Features Parameters Permitted Values Default Web User Interface: DSSKey->Line Key / Programable Key->Type Phone User Interface: Menu->Features->DSS Keys->Line Key X->Type 1-6 for lines 1-6, 1 linekey.X.line/ Integer from 1 to 6 for programable programablekey.X.line Description: Configures the desired line to apply the group call pickup key. For line keys: X ranges from 1 to 3.
Page 230
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure a group call pickup key via web user interface: Click on DSSKey->Line Key (or Programable Key). In the desired DSS key field, select Group Pickup from the pull-down list of Type. Enter the group call pickup code in the Value field.
Page 231
Configuring Basic Features Enter the group call pickup code in the Group Call Pickup Code field. Click Confirm to accept the change. To configure a group pickup key via phone user interface: Press Menu->Features->DSS Keys->Line Keys. Select the desired DSS key and then press Enter soft key. Press , or the Switch soft key to select Key Event from the Type field.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Example of the dialog-info message carried in NOTIFY message: <?xml version="1.0"?> <dialog-info xmlns="urn:ietf:params:xml:ns:dialog-info" version="2" state="partial" entity="sip:1009@10.3.5.199"> <dialog id="23" call-id="0_3397097402@10.2.20.10" local-tag="16163367" remote-tag="282082771" direction="initiator"> <state>early</state> <local> <identity>sip:1009@10.3.5.199</identity> <target uri="sip:1009@10.3.5.199"> </local> <remote> <identity>sip:1008@10.3.5.199:5060</identity> <target uri="sip:1008@10.3.5.199:5060">...
Page 233
Configuring Basic Features Details of the Configuration Parameter: Parameter Permitted Values Default account.X.dialoginfo_callpickup 0 or 1 (X ranges from 1 to 3) Description: Enables or disables the IP phone to pick up a call according to the SIP header of dialog-info for account X.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Call return, also known as last call return, allows users to place a call back to the last caller. Call return is implemented on IP phones using a call return key. Procedure Call return key can be configured using the configuration files or locally.
Page 235
Configuring Basic Features Parameter Permitted Values Default When X=1, the default value is 28 (History). When X=2, the default value is 61 (Directory). When X=3, the default value is 5 (DND). When X=4, the default value is 30 (Menu). When X=5, the default value is 28 (History). When X=6, the default value is 61 (Directory).
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Call park allows users to park a call on a special extension and then retrieve it on any other phone in the system. Users can park calls on the extension, known as call park orbit, by pressing a call park key.
Page 237
Configuring Basic Features Parameters Permitted Values Default Menu->Features->DSS Keys->Line Key X->Type linekey.X.line Integer from 1 to 3 1-3 for lines 1-3 (x ranges from 1 to 3) Description: Configures the desired line to apply the call park key. Example: linekey.1.line = 1 Web User Interface: DSSKey->Line key->Line Phone User Interface:...
If the caller already exists in the local directory, the local contact name assigned to the caller should be preferentially displayed and stored in the call log. Calling and For more information on calling line identification presentation, refer to Connected Line Identification Presentation on Yealink IP Phones , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Page 239
Configuring Basic Features Procedure CLIP can be configured using the configuration files or locally. Configure the presentation of the caller identity. Configuration File <MAC>.cfg Parameter: account.X.cid_source Configure the presentation of the caller identity. Navigate to: Local Web User Interface http://<phoneIPAddress>/servl et?p=account-adv&q=load&ac Details of the Configuration Parameter: Parameter...
If the callee already exists in the local directory, the local contact name assigned to the callee should be preferentially displayed. Calling and For more information on connected line identification presentation, refer to Connected Line Identification Presentation on Yealink IP Phones , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Configuring Basic Features Procedure COLP can be configured only using the configuration files. Configure the presentation of the callee’s identity. Configuration File <MAC>.cfg Parameter: account.X.cp_source Details of the Configuration Parameter: Parameter Permitted Values Default account.X.cp_source 0, 1 or 2 (X ranges from 1 to 3) Description: Configures the presentation of the callee’s identity for account X.
Page 242
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones frequency, and each column representing a high frequency. Pressing a digit key (such as '1') will generate a sinusoidal tone for each of two frequencies (697 and 1209 hertz (Hz)). DTMF Keypad Frequencies: 1209 Hz 1336 Hz...
Page 243
Configuring Basic Features Procedure Configuration changes can be performed using the configuration files or locally. Configure the method of transmitting DTMF digit and the payload type. Parameters: <MAC>.cfg account.X.dtmf.type account.X.dtmf.dtmf_payload account.X.dtmf.info_type Configure the number of times Configuration File for the IP phone to send the end RTP Event packet.
Page 244
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of Configuration Parameters: Parameters Permitted Values Default account.X.dtmf.type 0, 1, 2 or 3 (X ranges from 1 to 3) Description: Configures the DTMF type for account X. 0-INBAND 1-RFC 2833 2-SIP INFO 3-AUTO or SIP INFO If it is set to 0 (INBAND), DTMF digits are transmitted in the voice band.
Page 245
Configuring Basic Features Parameters Permitted Values Default 1-DTMF-Relay 2-DTMF 3-Telephone-Event Web User Interface: Account->Advanced->DTMF Info Type Phone User Interface: None features.dtmf.repetition 1, 2 or 3 Description: Configures the repetition times for the IP phone to send the end RTP EVENT packet during an active call.
Page 246
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the desired value in the DTMF Payload Type (96~127) field. Click Confirm to accept the change. To configure the number of times to send the end RTP Event packet via web user interface: Click on Features->General Information.
Configuring Basic Features Suppress DTMF display allows IP phones to suppress the display of DTMF digits. DTMF digits are displayed as “*” on the LCD screen. Suppress DTMF display delay defines whether to display the DTMF digits for a short period of time before displaying as “*”. Procedure Configuration changes can be performed using the configuration files or locally.
Page 248
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Enables or disables the IP phone to display the DTMF digits for a short period before displaying asterisks during an active call. 0-Disabled 1-Enabled Note: It works only if the parameter “features.dtmf.hide” is set to 1 (Enabled). Web User Interface: Features->General Information->Suppress DTMF Display Delay Phone User Interface:...
Configuring Basic Features Call transfer is implemented via DTMF on some traditional servers. The IP phone sends specified DTMF digits to the server for transferring calls to third parties. Procedure Configuration changes can be performed using the configuration files or locally. Configure transfer via DTMF.
Page 250
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the DTMF digits to be transmitted to perform call transfer. Valid values are: 0-9, *, # and A-D. Example: features.dtmf.transfer = 123 Note: It works only if the parameter “features.dtmf.replace_tran” is set to 1 (Enabled).
Configuring Basic Features Intercom allows establishing an audio conversation directly. The IP phone can answer intercom calls automatically. This feature depends on support from a SIP server. Intercom is a useful feature in office environments to quickly connect with an operator or secretary.
Page 252
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures a DSS key as an intercom key. The digit 14 stands for the key type Intercom. Example: linekey.1.type = 14 Web User Interface: DSSKey->Line key->Type Phone User Interface: Menu->Features->DSS Keys->Line Key X->Type linekey.X.line...
Configuring Basic Features Select the desired line from the pull-down list of Line. Click Confirm to accept the change. To configure an intercom key via phone user interface: Press Menu->Features->DSS Keys->Line Keys. Select the desired DSS key and then press Enter soft key. Press , or the Switch soft key to select Intercom from the Type field.
Page 254
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Incoming intercom calls can be configured using the configuration files or locally. Configure incoming intercom call feature. Parameters: features.intercom.allow Configuration File <y0000000000xx>.cfg features.intercom.mute features.intercom.tone features.intercom.barge Configure incoming intercom call feature.
Page 255
Configuring Basic Features Parameters Permitted Values Default Description: Enables or disables the IP phone to mute the microphone when answering an intercom call. 0-Disabled 1-Enabled If it is set to 1 (Enabled), the microphone is muted for intercom calls, and then the other party cannot hear you.
Page 256
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default hold. Note: It works only if the parameter “ ” is set to 1 (Enabled). features.intercom.allow Web User Interface: Features->Intercom->Intercom Barge Phone User Interface: Menu->Features->Intercom->Intercom Barge To configure intercom via web user interface: Click on Features->Intercom.
Configuring Advanced Features This chapter provides information for making configuration changes for the following advanced features: Distinctive Ring Tones Tones Remote Phone Book LDAP Busy Lamp Field BLF List Hide Features Access Code Automatic Call Distribution ...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Distinctive ring tones allows certain incoming calls to trigger IP phones to play distinctive ring tones. The IP phone inspects the INVITE request for an "Alert-Info" header when receiving an incoming call. If the INVITE request contains an "Alert-Info" header, the IP phone strips out the URL or keyword parameter and maps it to the appropriate ring tone.
Page 259
Configuring Advanced Features Minimum Nominal Maximum Bellcore Pattern Pattern Cadence Duration Duration Duration Tone (ms) (ms) (ms) Ringing Long 1025 Silent 2975 4000 4400 Ringing Short Silent Ringing Long 1000 1100 Bellcore-dr4 Silent Ringing Short Silent 2975 4000 4400 Ringing Bellcore-dr5 Note “Bellcore-dr5”...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones When the Alert-Info header contains a remote URL, the IP phone will try to download the WAV ring tone file from the URL and then play the remote ring tone if the parameter “account.X.alert_info_url_enable”...
Page 261
Configuring Advanced Features Configure distinctive ring tones. Navigate to: http://<phoneIPAddress>/servl et?p=account-adv&q=load&ac Local Web User Interface Configure the internal ringer text and internal ringer file. Navigate to: http://<phoneIPAddress>/servl et?p=settings-ring&q=load Details of Configuration Parameters: Parameters Permitted Values Default account.X.alert_info_url_enable 0 or 1 (X ranges from 1 to 3) Description: Enables or disables the IP phone to download the ring tone from the URL contained...
Page 262
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default String within 32 distinctive_ring_tones.alert_info.X.text Blank characters Description: Configures the internal ringer text to map the keywords contained in the Alert-Info header. X ranges from 1 to 10. Example: distinctive_ring_tones.alert_info.1.text = family Web User Interface:...
Page 263
Configuring Advanced Features Select the desired value from the pull-down list of Distinctive Ring Tones. Click Confirm to accept the change. To configure the internal ringer text and internal ringer file via web user interface: Click on Settings->Ring. Enter the keywords in the Internal Ringer Text fields. Select the desired ring tones for each text from the pull-down lists of Internal Ringer File.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones When receiving a message, the IP phone will play a warning tone. You can customize tones or select specialized tone sets (vary from country to country) to indicate different conditions of the IP phone. The default tones used on IP phones are the US tone sets. Available tone sets for IP phones: Australia ...
Page 265
Configuring Advanced Features Configured tones can be heard on IP phones for the following conditions. Condition Description Dial When in the pre-dialing interface Ring Back Ring-back tone Busy When the callee is busy Congestion When the network is congested Call Waiting Call waiting tone Dial Recall When receiving a call back...
Page 266
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of Configuration Parameters: Parameters Permitted Values Default voice.tone.country Refer to the following content Custom Description: Configures the country tone for the IP phone. Permitted Values: Custom, Australia, Austria, Brazil, Belgium, Chile, China, Czech, Czech ETSI, Denmark, Finland, France, Germany, Great Britain, Greece, Hungary, Lithuania, India, Italy, Japan, Mexico, New Zealand, Netherlands, Norway, Portugal, Spain, Switzerland, Sweden, Russia, United States.
Page 267
Configuring Advanced Features Parameters Permitted Values Default None voice.tone.ring String Blank Description: Customizes the ringback tone. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Note: It works only if the parameter “voice.tone.country” is set to Custom. Web User Interface: Settings->Tones->Ring Back Phone User Interface:...
Page 268
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default voice.tone.callwaiting String Blank Description: Customizes the call waiting tone. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Note: It works only if the parameter “voice.tone.country”...
Page 269
Configuring Advanced Features Parameters Permitted Values Default voice.tone.stutter String Blank Description: Customizes the tone when the IP phone receives a voice mail. The value format is Freq/Duration. For more information on the value format, refer to the parameter “voice.tone.dial”. Note: It works only if the parameter “voice.tone.country” is set to Custom. Web User Interface: Settings->Tones->Stutter Phone User Interface:...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure tones via web user interface: Click on Settings->Tones. Select the desired type from the pull-down list of Select Country. If you select Custom, you can customize a tone for each condition of the IP phone. Click Confirm to accept the change.
Page 271
Configuring Advanced Features remote_phonebook.display_name Specify whether to query the entry name from the remote phone book for outgoing/incoming calls. Parameter: features.remote_phonebook.enable Specify how often the IP phone refreshes the local cache of the remote phone book. Parameter: features.remote_phonebook.flash_time Specify whether to refresh the local cache of the remote phone book at a time when accessing the remote phone book.
Page 272
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of Configuration Parameters: Parameters Permitted Values Default URL within 511 remote_phonebook.data.X.url Blank characters (X ranges from 1 to 5) Description: Configures the access URL of the remote phone book. Example: remote_phonebook.data.1.url = http://192.168.1.20/phonebook.xml Web User Interface:...
Page 273
Configuring Advanced Features Parameters Permitted Values Default Description: Enables or disables the IP phone to perform a remote phone book search for an incoming or outgoing call and display the matched call on the LCD screen. 0-Disabled 1-Enabled Web User Interface: Directory->Remote Phone Book->Incoming/Outgoing Call lookup Phone User Interface: None...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To specify access URL of the remote phone book via web user interface: Click on Directory->Remote Phone Book. Enter the access URL in the Remote URL field. Enter the name in the Display Name field. Click Confirm to accept the change To configure Incoming/Outgoing Call lookup and Update Time Interval via web user interface:...
Page 275
Domain component company Company or organization name telephoneNumber Office phone number mobile mobilephoneNumber Mobile or cellular phone number ipPhone IPphoneNumber Home phone number LDAP Phonebook on Yealink IP Phones For more information on LDAP , refer to , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Page 276
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure LDAP can be configured using the configuration files or locally. Configure LDAP . Parameters: ldap.enable ldap.name_filter ldap.number_filter ldap.tls_mode ldap.host ldap.port ldap.base ldap.user ldap.password ldap.max_hits Configuration File <y0000000000xx>.cfg ldap.name_attr ldap.numb_attr ldap.display_name ldap.version ldap.call_in_lookup...
Page 277
Configuring Advanced Features Details of Configuration Parameters: Parameters Permitted Values Default ldap.enable 0 or 1 Description: Enables or disables LDAP feature on the IP phone. 0-Disabled 1-Enabled Web User Interface: Directory->LDAP->Enable LDAP Phone User Interface: None String within 99 ldap.name_filter Blank characters Description:...
Page 278
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Web User Interface: Directory->LDAP->LDAP Number Filter Phone User Interface: None Integer from 0 to ldap.tls_mode Description: Configures the connection mode between the LDAP server and the IP phone. 0-LDAP—LDAP connection between LDAP server and the IP phone.
Page 279
Configures the LDAP search base which corresponds to the location of the LDAP phone book from which the LDAP search request begins. The search base narrows the search scope and decreases directory search time. Example: ldap.base = dc=yealink,dc=cn Web User Interface: Directory->LDAP->Base String within 99 ldap.user...
Page 280
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default This parameter can be left blank in case the server allows anonymous to login. Otherwise you will need to provide the password to login the LDAP server. Example: ldap.password = secret Web User Interface:...
Page 281
Configuring Advanced Features Parameters Permitted Values Default String within 99 ldap.numb_attr Blank characters Description: Configures the number attributes of each record to be returned by the LDAP server. You can configure multiple number attributes separated by spaces. Example: ldap.numb_attr = telephoneNumber Web User Interface: Directory->LDAP->LDAP Number Attributes Phone User Interface:...
Page 282
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Enables or disables the IP phone to perform an LDAP search when receiving an incoming call. 0-Disabled 1-Enabled Web User Interface: Directory->LDAP->LDAP Lookup For Incoming Call Phone User Interface: None ldap.call_out_lookup...
Page 283
Configuring Advanced Features Parameters Permitted Values Default linekey.X.type/ Refer to the programablekey.X.type following content Description: Configures a DSS key as an LDAP key on the IP phone. The digit 38 stands for the key type LDAP. For line keys: X ranges from 1 to 3. For programable keys: X=1-10, 14 Example:...
Page 284
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired values from the corresponding pull-down lists. Click Confirm to accept the change. To configure an LDAP key via web user interface: Click on DSSKey->Line Keys (or Programable Key). In the desired DSS key field, select LDAP from the pull-down list of Type.
Configuring Advanced Features Busy Lamp Field (BLF) is used to monitor a specific user for status changes on IP phones. For example, you can configure a BLF key on a supervisor’s phone to monitor the IP phone user status (busy or idle). When the monitored user places a call, a busy indicator on the supervisor’s phone indicates that the user’s phone is in use.
Page 286
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Line Key LED (configured as a BLF key a BLF List key and BLF LED Mode is set to 1) LED Status Description Fast flashing red (200ms) The monitored user receives an incoming call. The monitored user is dialing.
Page 287
Configuring Advanced Features Procedure BLF can be configured using the configuration files or locally. Specify whether to use visual alert and audio alert for BLF pickup. Parameters: features.pickup.blf_visual_enable features.pickup.blf_audio_enable Assign a BLF key. Parameters: Configuration File y0000000000xx.cfg linekey.X.type linekey.X.line linekey.X.value linekey.X.pickup_value Configure BLF LED mode.
Page 288
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of Configuration Parameters: Parameters Permitted Values Default features.pickup.blf_visual_enable 0 or 1 Description: Enables or disables the IP phone to display a visual alert when the monitored user receives an incoming call. 0-Disabled 1-Enabled Web User Interface:...
Page 289
Configuring Advanced Features BLF Key For more information on how to configure the DSS Key, refer to Appendix D: Configuring DSS Key on page 471. Parameters Permitted Values Default linekey.X.type 15 for line key (x ranges from 1 to 3) Description: Configures a DSS key as a BLF key on the IP phone.
Page 290
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Phone User Interface: Menu->Features->DSS Keys->Line Key X->Value linekey.X.pickup_value String within 256 Blank characters (x ranges from 1 to 3) Description: Configures the pickup code for BLF feature. This parameter only applies to BLF feature.
Page 291
Configuring Advanced Features Select the desired value from the pull-down list of Audio Alert for BLF Pickup. Click Confirm to accept the change. To configure BLF LED mode via web user interface: Click on Features->General Information. Select the desired value from the pull-down list of BLF LED Mode. Click Confirm to accept the change.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the phone number or extension you want to monitor in the Value field. (Optional.) Enter the directed call pickup code in the Extension field. Press the Save soft key to accept the change. Busy Lamp Field (BLF) List allows a list of specific extensions to be monitored for status changes.
Page 293
Configuring Advanced Features Navigate to: http://<phoneIPAddress>/servlet?p=ds skey&q=load&model=0 Phone User Assign a BLF List key. Interface Details of Configuration Parameters: Permitted Parameters Default Values String account.X.blf.blf_list_uri within 256 Blank (X ranges from 1 to 3) characters Description: Configures the BLF List URI to monitor a list of users for account X. Example: account.1.blf.blf_list_uri = blf_test@as.iop1.broadwork.net Web User Interface:...
Page 294
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Permitted Parameters Default Values Example: account.1.blf_list_barge_in_code = *33 Web User Interface: Account->Advanced->BLF List BargeIn Code Phone User Interface: None String account.X.blf_list_retrieve_call_parked_code within 32 Blank (X ranges from 1 to 3) characters Description: Configures the call park retrieve code for account X.
Page 295
Configuring Advanced Features BLF List Key For more information on how to configure the DSS Key, refer to Appendix D: Configuring DSS Key on page 471. Parameters Permitted Values Default linekey.X.type 15 for line key (X ranges from 1 to 3) Description: Configures a DSS key as a BLF List key on the IP phone.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Code field. Click Confirm to accept the change. To configure BLF List keys manually via web user interface: Click on DSSKey->Line Key (or Programable Key). In the desired DSS key field, select BLF List from the pull-down list of Type. Select the desired line from the pull-down list of Line.
Page 297
Configuring Advanced Features active call. The hide feature access codes feature is applicable to the following features: Voice Mail Pick up Group Pick up Barge In Retrieve Call Park Group Park Procedure The hide feature access codes feature can be configured using the configuration files or locally.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To enable hide feature access codes feature via web user interface: Click on Features-> General Information. Select Enabled from the pull-down list of Hide Feature Access Codes. Click Confirm to accept the change. Automatic Call Distribution (ACD) enables organizations to manage a large number of phone calls on an individual basis.
Page 299
Configuring Advanced Features Procedure ACD can be configured using the configuration files or locally. Configure ACD feature for account: Parameters: <MAC>.cfg account.X.acd.enable account.X.acd.available Assign an ACD key. Configuration File Parameters: linekey.X.type <y0000000000xx>.cfg Configure ACD auto available. Parameters: acd.auto_available acd.auto_available_timer Assign an ACD key. Navigate to: http://<phoneIPAddress>/servlet ?p=dsskey&model=1&q=load&li...
Page 300
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Web User Interface: Features->ACD->ACD Auto Available Phone User Interface: None acd.auto_available_timer Integer from 0 to 120 Description: Configures the length of time (in seconds) before the status of the ACD agent is automatically changed to available.
Page 301
Configuring Advanced Features Parameters Permitted Values Default None ACD Key For more information on how to configure the DSS Key, refer to Appendix D: Configuring DSS Key on page 471. Details of Configuration Parameters: Parameters Permitted Values Default linekey.X.type 15 for line key (X range from 1 to 3) Description: Configures a line key to be an ACD key on the IP phone.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure the ACD auto available timer feature via web user interface: Click on Features->ACD. Select the desired value from the pull-down list of ACD Auto Available. Enter the desired timer in the ACD Auto Available Timer (0~120s) field. Click Confirm to accept the change.
Page 303
Configuring Advanced Features Procedure Configuration changes can be performed using the configuration files or locally. Configure subscribe for MWI. Parameters: account.X.subscribe_mwi account.X.subscribe_mwi_expires account.X.subscribe_mwi_to_vm Configure the voice mail number for Configuration File <MAC>.cfg account X. Parameter: voice_mail.number.X Configure the presentation of audio and visual MWI.
Page 304
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Account->Advanced->Subscribe for MWI Phone User Interface: None account.X.subscribe_mwi_expires Integer from 0 to 3600 84600 (X ranges from 1 to 3) Description: Configures MWI subscribe expiry time (in seconds) for account X. The IP phone is able to successfully refresh the SUBSCRIBE for message-summary events before expiration of the SUBSCRIBE dialog.
Page 305
Configuring Advanced Features Parameters Permitted Values Default Note: It works only if the parameter “account.X.subscribe_mwi_to_vm” is set to 1 (Enabled). Web User Interface: Account->Advanced->Voice Mail Phone User Interface: None account.X.display_mwi.enable 0 or 1 (X ranges from 1 to 3) Description: Enables or disables the IP phone to support audio and visual MWI when receiving new voice messages.
Page 306
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the period time in the MWI Subscription Period (Seconds) field. Click Confirm to accept the change. To configure subscribe MWI to voice mail via web user interface: Click on Account. Select the desired account from the pull-down list of Account.
Configuring Advanced Features Select the desired value from the pull-down list of Voice Mail Display. Click Confirm to accept the change. Multicast paging allows IP phones to send/receive Real-time Transport Protocol (RTP) streams to/from the pre-configured multicast address(es) without involving SIP signaling. Up to 10 listening multicast addresses can be specified on the IP phone.
Page 308
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones linekey.X.type linekey.X.value Assign a paging list key. Parameter: linekey.X.type Configure the multicast IP address and port number for a paging list key. Parameter: multicast.paging_address.X.ip_ad dress Configure the multicast paging group name for a paging list key. Parameter: multicast.paging_address.X.label Assign a multicast paging key or a...
Page 309
Configuring Advanced Features Parameters Permitted Values Default Refer to the following multicast.codec G722 content Description: Configures the codec of multicast paging. Permitted Values: PCMU, PCMA, G729, G722, G726-32 Example: multicast.codec = G722 Web User Interface: Features->General Information->Multicast Codec Phone User Interface: None String within 99 multicast.paging_address.X.ip_address...
Page 310
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Phone User Interface: Menu->Features->Paging List->Option->Edit->Label Multicast Paging Key For more information on how to configure the DSS Key, refer to Appendix D: Configuring DSS Key on page 471. Parameters Permitted Values Default...
Page 311
Configuring Advanced Features Parameters Permitted Values Default linekey.X.type 15 for line key (x ranges from 1 to 3) Description: Configures a DSS key as a paging list key on the IP phone. The digit 66 stands for the key type Paging List. Example: linekey.1.type = 66 Web User Interface:...
Page 312
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure a paging list key via web user interface: Click on DSSKey->Line Key. In the desired DSS key field, select Paging List from the pull-down list of Type. Click Confirm to accept the change. To configure a codec for multicast paging via web user interface: Click on Features->General Information.
Page 313
Configuring Advanced Features The label will appear on the LCD screen when sending the RTP multicast. Click Confirm to accept the change. To configure a multicast paging key via phone user interface: Press Menu->Features->DSS Keys->Line Keys. Select the desired DSS key and then press Enter soft key. Press , or the Switch soft key to select Key Event from the Type field.
Page 314
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones IP phones can receive an RTP stream from the pre-configured multicast address(es) without involving SIP signaling, and can handle the incoming multicast paging calls differently depending on the configurations of Paging Barge and Paging Priority Active. Paging Barge This parameter defines the priority of the voice call in progress, and decides how the IP phone handles the incoming multicast paging calls when there is already a voice call in...
Page 315
Configuring Advanced Features Details of Configuration Parameters: Parameters Permitted Values Default multicast.listen_address.X.ip_address IP address: port Blank (X ranges from 1 to 10) Description: Configures the multicast address and port number that the IP phone listens to. Example: multicast.listen_address.1.ip_address = 224.5.6.20:10008 Note: The valid multicast IP addresses range from 224.0.0.0 to 239.255.255.255.
Page 316
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Phone User Interface: None multicast.receive_priority.priority Integer from 0 to 10 Description: Configures the priority of multicast paging calls. 1 is the highest priority, 10 is the lowest priority. If it is set to 0, all incoming multicast paging calls will be automatically ignored.
Configuring Advanced Features To configure paging barge and paging priority active features via web user interface: Click on Directory->Multicast IP. Select the desired value from the pull-down list of Paging Barge. Select the desired value from the pull-down list of Paging Priority Active. Click Confirm to accept the change.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones CSeq: 2 INFO Contact: <sip:1009@10.3.20.10:5060> Max-Forwards: 70 User-Agent: Yealink SIP-T23 44.80.208.62 line=0 Record: on Content-Length: 0 When the user presses the record key for the second time, the IP phone sends a SIP INFO message to the server with the specific header “Record: off”, and then the...
Page 319
Configuring Advanced Features <YealinkIPPhoneText> If the recording fails for some reasons, for example, the recording box is full, the server will respond with a 200 OK message. Example of a 200 OK message: <YealinkIPPhoneText> <Title> </Title> <Text> Probably the recording box is full. </Text>...
Page 320
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Assign a record key and URL Phone User Interface record key. Record Key For more information on how to configure the DSS Key, refer to Appendix D: Configuring DSS Key on page 471.
Page 321
Configuring Advanced Features Parameters Permitted Values Default linekey.X.value String within 99 Blank characters (x ranges from 1 to 3) Description: Configures the URL to record a call. Example: linekey.1.value = http://10.1.2.224/phonerecording.cgi Web User Interface: DSSKey->Line Key->Value Phone User Interface: Menu->Features->DSS Keys->Line Key X->Value To configure a record key via web user interface: Click on DSSKey->Line Key.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the URL in the Value field. Click Confirm to accept the change. To configure a record key via phone user interface: Press Menu->Features->DSS Keys->Line Keys. Select the desired DSS key. Press , or the Switch soft key to select Key Event from the Type field.
Page 323
Configuring Advanced Features Hot desking key can be configured using the configuration files or locally. Assign a hot desking key. Parameters: Configuration File <y0000000000xx>.cfg linekey.X.type/ programablekey.X.type Assign a hot desking key. Navigate to: Web User Interface http://<phoneIPAddress>/servl Local et?p=dsskey&q=load&model Phone User Interface Assign a hot desking key.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure a hot desking key via web user interface: Click on DSSKey->Line Key. In the desired DSS key field, select Hot Desking from the pull-down list of Type. Click Confirm to accept the change. To configure a hot desking key via phone user interface: Press Menu->Features->DSS Keys->Line Keys.
Page 325
Configuring Advanced Features Event Description Incoming Call When the IP phone receives an incoming call. Outgoing Call When the IP phone places a call. Established When the IP phone establishes a call. Terminated When the IP phone terminates a call. Open DND When the IP phone enables the DND mode.
Page 326
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones An HTTP or HTTPS GET request may contain variable name and variable value, separated by “=”. Each variable value starts with $ in the query part of the URL. The valid URL format is: http(s)://IP address of server/help.xml?variable name=$variable value.
Page 327
Configuring Advanced Features Variable Value Description $call_id The call-id of the active call. Procedure Action URL can be configured using the configuration files or locally. Configure action URL. Parameters: action_url.setup_completed action_url.registered action_url.unregistered action_url.register_failed action_url.off_hook action_url.on_hook action_url.incoming_call action_url.outgoing_call action_url.call_established action_url.dnd_on action_url.dnd_off action_url.always_fwd_on action_url.always_fwd_off Configuration File...
Page 328
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones action_url.forward_incoming_call action_url.reject_incoming_call action_url.answer_new_incoming_c action_url.transfer_finished action_url.transfer_failed Configure action URL. Navigate to: Local Web User Interface http://<phoneIPAddress>/servlet?p =features-actionurl&q=load Details of Configuration Parameters: Parameters Permitted Values Default action_url.setup_completed URL within 511 characters Blank Description: Configures the action URL the IP phone sends after startup.
Page 329
Configuring Advanced Features Parameters Permitted Values Default Phone User Interface: None action_url.registered URL within 511 characters Blank Description: Configures the action URL the IP phone sends after an account is registered. Example: action_url.registered = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Registered Phone User Interface: None action_url.unregistered...
Page 330
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default action_url.off_hook URL within 511 characters Blank Description: Configures the action URL the IP phone sends when off hook. Example: action_url.off_hook = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Off Hook Phone User Interface: None action_url.on_hook...
Page 331
Configuring Advanced Features Parameters Permitted Values Default Description: Configures the action URL the IP phone sends when placing a call. Example: action_url.outgoing_call = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Outgoing Call Phone User Interface: None action_url.call_established URL within 511 characters Blank Description: Configures the action URL the IP phone sends when establishing a call.
Page 332
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default action_url.dnd_off = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Close DND Phone User Interface: None action_url.always_fwd_on URL within 511 characters Blank Description: Configures the action URL the IP phone sends when always forward feature is enabled.
Page 333
Configuring Advanced Features Parameters Permitted Values Default Web User Interface: Features->Action URL->Open Busy Forward Phone User Interface: None action_url.busy_fwd_off URL within 511 characters Blank Description: Configures the action URL the IP phone sends when busy forward feature is disabled. Example: action_url.busy_fwd_off = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Close Busy Forward...
Page 334
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Web User Interface: Features->Action URL->Close NoAnswer Forward Phone User Interface: None action_url.transfer_call URL within 511 characters Blank Description: Configures the action URL the IP phone sends when performing a transfer. Example: action_url.transfer_call = http://192.168.0.20/help.xml?IP=$ip Web User Interface:...
Page 335
Configuring Advanced Features Parameters Permitted Values Default Phone User Interface: None action_url.hold URL within 511 characters Blank Description: Configures the action URL the IP phone sends when placing a call on hold. Example: action_url.hold = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Hold Phone User Interface: None action_url.unhold...
Page 336
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default action_url.unmute URL within 511 characters Blank Description: Configures the action URL the IP phone sends when un-muting a call. Example: action_url.unmute = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->UnMute Phone User Interface: None...
Page 337
Configuring Advanced Features Parameters Permitted Values Default Description: Configures the action URL the IP phone sends when changing the state of the IP phone from busy to idle. Example: action_url.busy_to_idle = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Busy To Idle Phone User Interface: None action_url.idle_to_busy URL within 511 characters...
Page 338
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default action_url.forward_incoming_call URL within 511 characters Blank Description: Configures the action URL the IP phone sends when forwarding an incoming call. Example: action_url.forward_incoming_call = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Forward Incoming Call Phone User Interface: None...
Page 339
Configuring Advanced Features Parameters Permitted Values Default Description: Configures the action URL the IP phone sends when completing a call transfer. Example: action_url.transfer_finished = http://192.168.0.20/help.xml?IP=$ip Web User Interface: Features->Action URL->Transfer Finished Phone User Interface: None action_url.transfer_failed URL within 511 characters Blank Description: Configures the action URL the IP phone sends when failing to transfer a call.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure action URL via web user interface: Click on Features->Action URL. Enter the action URLs in the corresponding fields. Click Confirm to accept the change. Opposite to action URL, action URI allows IP phones to interact with web server application by receiving and handling an HTTP or HTTPS GET request.
Page 341
Configuring Advanced Features Variable Value Phone Action Cancel actions or reject incoming calls or mute or un-mute calls. 0-9/*/POUND Press the keypad (0-9, * or #). L1-LX Press the line keys (X=3). F1-F4 Press the soft keys. Press the MESSAGE key. HEADSET Press the HEADSET key.
Page 342
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones prompts the message “Allow Remote Control?”. You can specify one or more trusted IP addresses on the IP phone, or configure the IP phone to receive and handle the URI from any IP address.
Page 343
Configuring Advanced Features Details of the Configuration Parameter: Parameter Permitted Values Default features.action_uri_limit_ip IP address or any Blank Description: Configures the address(es) from which Action URI will be accepted. For discontinuous IP addresses, multiple IP addresses are separated by commas. For continuous IP addresses, the format likes *.*.*.* and the “*”...
Page 344
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Click Confirm to accept the change. You can capture the screen display of the IP phone using the action URI. IP phones support handling an HTTP or HTTPS GET request. The URI format is http(s)://<phoneIPAddress>/screencapture.
Else, the browser will display an image showing the phone’s current screen directly. You can save the image to your local system. Frequent capture may affect the phone performance. Yealink recommend you to capture Note the phone screen display within a minimum interval of 4 seconds.
Working Server: Server 1 is configured with the domain name of the working server. For example, yealink.pbx.com. DNS mechanism is used such that the working server is resolved to multiple SIP servers for failover purpose. The working server is deployed in redundant pairs, designated as primary and secondary servers.
Page 347
Configuring Advanced Features unavailable, the secondary server will serve as the working server. Server Redundancy on Yealink IP For more information on server redundancy, refer to Phones , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. Procedure Server redundancy can be configured using the configuration files or locally.
Page 348
Parameters Permitted Values Default Description: Configures the IP address or domain name of the SIP server Y for account X. Example: account.1.sip_server.1.address = yealink.pbx.com Web User Interface: Account->Register->SIP Server Y->Server Host Phone User Interface: None account.X.sip_server.Y.port Integer from 0 to...
Page 349
Configuring Advanced Features Parameters Permitted Values Default Description: Configures the retry times for the IP phone to resend requests when the SIP server Y is unavailable or there is no response from the SIP server Y for account X. Web User Interface: Account->Register->SIP Server Y->Server Retry Counts Phone User Interface: None...
Page 350
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default control in the failover mode. 0-newRequests: all requests are sent to the primary server first, regardless of the last server that was used. 1-DNSTTL: the IP phone will send requests to the last registered server first. If the time defined by DNSTTL on the registered server expires, the phone will retry to send requests to the primary server.
Page 351
Configuring Advanced Features Parameters Permitted Values Default Web User Interface: None Phone User Interface: None To configure server redundancy and transport type via web user interface: Click on Account->Register. Select the desired account from the pull-down list of Account. Configure registration parameters of the selected account in the corresponding fields.
Page 352
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones To configure server redundancy for failover purpose via web user interface: Click on Account->Register. Select the desired account from the pull-down list of Account. Configure registration parameters of the selected account in the corresponding fields.
Page 353
A query. If no port is found through the DNS query, 5060 will be used. The following details the procedures of DNS query for the IP phone to resolve the domain name (e.g., yealink.pbx.com) of working server into the IP address, port and transport protocol. NAPTR (Naming Authority Pointer) First, the IP phone sends NAPTR query to get the NAPTR pointer and transport protocol.
Page 354
The two records also contain a port “5060”, the IP phone uses this port. If the Target is not a numeric IP address, the IP phone performs an A query. So in this case, the IP phone uses “server1.yealink.pbx.com" and “server2.yealink.pbx.com" for the A query.
Configuring Advanced Features call will fail. At the start of a call, server availability is determined by SIP signaling failure. SIP signaling failure depends on the SIP protocol being used as described below: If TCP is used, then the signaling fails if the connection or the send fails. ...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default performs the DNS NAPTR and SRV queries for the service type and port. Web User Interface: Account->Register->SIP Server 1/2->Transport Phone User Interface: None account.X.naptr_build 0 or 1 (X ranges from 1 to 3) Description: Configures the way of SRV query for the IP phone to be performed when no result is...
Page 357
Configuring Advanced Features The IP phone attempts to resolve the domain name within the static DNS cache. The IP phone will always use the results returned from the static DNS cache. IP phones can be configured to use static DNS cache preferentially. Static DNS cache is configurable on a per-line basis.
Page 358
(X ranges from 1 to 3, Y ranges from 1 to 2) Description: Configures the domain name to which NAPTR record Y refers for account X. Example: account.1.dns_cache_naptr.1.name = yealink.pbx.com Web User Interface: None Phone User Interface: None account.X.dns_cache_naptr.Y.flags...
Page 359
(X ranges from 1 to 3, Y ranges from 1 to 2) Description: Configures a domain name to be used for the next SRV query in NAPTR record Y for account X. Example: account.1.dns_cache_naptr.1.replace = _sip._tcp.yealink.pbx.com Web User Interface: None Phone User Interface: None account.X.dns_cache_naptr.Y.service...
Page 360
Blank (X ranges from 1 to 3, Y ranges from 1 to 2) Description: Configures the domain name in SRV record Y for account X. Example: account.1.dns_cache_srv.1.name = _sip._tcp.yealink.pbx.com Web User Interface: None Phone User Interface: None account.X.dns_cache_srv.Y.port Integer from 0 to 65535...
Page 361
(X ranges from 1 to 3, Y ranges from 1 to 2) Description: Configures the domain name of the target host for an A query in SRV record Y for account X. Example: account.1.dns_cache_srv.1.target = server1.yealink.pbx.com Web User Interface: None Phone User Interface: None account.X.dns_cache_srv.Y.weight...
Page 362
Blank (X ranges from 1 to 3, Y ranges from 1 to 2) Description: Configures the domain name in A record Y for account X. Example: account.1.dns_cache_a.1.name = yealink.pbx.com Web User Interface: None Phone User Interface: None account.X.dns_cache_a.Y.ip IP address...
Page 363
Configuring Advanced Features Parameters Permitted Values Default Example: account.1.dns_cache_a.1.ip = 192.168.1.13 Web User Interface: None Phone User Interface: None account.X.dns_cache_a.Y.ttl Integer from 30 to 2147483647 (X ranges from 1 to 3, Y ranges from 1 to 2) Description: Configures the time interval (in seconds) that A record Y may be cached before the record should be consulted again for account X.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures whether preferentially to use the static DNS cache for domain name resolution of the SIP server for account X. 0-Use domain name resolution from the DNS server preferentially 1-Use static DNS cache preferentially Example: account.1.static_cache_pri = 1...
Page 365
Seconds until data unit expires. End of LLDPDU Marks end of LLDPDU. Name assigned to the IP phone. System Name The default value is “yealink”. Description of the IP phone. System Description The default value is “yealink”. The supported and enabled capabilities of the IP phone.
Page 366
Serial number of the IP phone. Number Inventory – Manufacturer name of the IP phone. Manufacturer Name The default value is “yealink”. Inventory – Model Model name of the IP phone. Name Assertion identifier of the IP phone. Asset ID The default value is “asset”.
Page 367
Configuring Advanced Features Parameters Permitted Values Default Description: Enables or disables LLDP feature on the IP phone. 0-Disabled 1-Enabled Note: If you change this parameter, the IP phone will reboot to make the change take effect. Web User Interface: Network->Advanced->LLDP->Active Phone User Interface: Menu->Settings->Advanced Settings (default password: admin) ->Network->LLDP->LLDP Status...
Page 368
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the desired time interval in the Packet Interval (1~3600s) field. Click Confirm to accept the change. A dialog box pops up to prompt that settings will take effect after a reboot. Click OK to reboot the phone.
Page 369
Configuring Advanced Features http://<phoneIPAddress>/servle t?p=network-adv&q=load Phone User Interface Configure CDP feature. Details of Configuration Parameters: Parameters Permitted Values Default network.cdp.enable 0 or 1 Description: Enables or disables CDP feature on the IP phone. 0-Disabled 1-Enabled Note: If it is set to 1, the IP phone will attempt to determine its VLAN ID through CDP . If you change this parameter, the IP phone will reboot to make the change take effect.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the desired time interval in the Packet Interval (1~3600s) field. Click Confirm to accept the change. A dialog box pops up to prompt that settings will take effect after a reboot. Click OK to reboot the phone.
Page 371
DHCP , the IP phone will examine DHCP option for a valid VLAN ID. The predefined option 132 is used to supply the VLAN ID by default. You can customize the DHCP option used to request the VLAN ID. VLAN Feature on Yealink IP Phones For more information on VLAN, refer to , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Page 372
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Navigate to: http://<phoneIPAddress>/servlet?p=n etwork-adv&q=load Configure VLAN for the Internet port and PC port. Phone User Interface Configure DHCP VLAN discovery feature. Details of Configuration Parameters: Parameters Permitted Values Default network.vlan.internet_port_enable 0 or 1 Description: Enables or disables...
Page 373
Configuring Advanced Features Parameters Permitted Values Default Description: Configures VLAN priority for the Internet (WAN) port. 7 is the highest priority, 0 is the lowest priority. Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 374
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default network.vlan.pc_port_priority Integer from 0 to 7 Description: Configures VLAN priority for the PC (LAN) port. Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 375
Configuring Advanced Features Parameters Permitted Values Default Menu->Settings->Advanced Settings (default password: admin) ->Network->VLAN->DHCP VLAN->Option network.vlan.vlan_change.enable 0 or 1 Description: Enables or disables the IP phone to obtain IP address with lower preference of VLAN assignment method or disable VLAN feature when the IP phone cannot obtain IP address with the current VLAN assignment method.
Page 376
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select the desired value (0-7) from the pull-down list of Priority. Click Confirm to accept the change. A dialog box pops up to prompt that the settings will take effect after a reboot. Click OK to reboot the phone.
Page 377
Configuring Advanced Features To configure DHCP VLAN discovery via web user interface: Click on Network->Advanced. In the VLAN block, select the desired value from the pull-down list of DHCP VLAN Active. Enter the desired option in the Option (128-254) field. The default option is 132.
Page 378
SIP-T23/T23P/T23G IP phones, the maximum file size is 100KB. The related VPN files are: certificates (ca.crt and client.crt), key (client.key) and the configuration file (vpn.cnf) of OpenVPN the VPN client. For more information on how to package a TAR file, refer to Feature on Yealink IP Phones , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142. Procedure VPN can be configured using the configuration files or locally.
Page 379
Configuring Advanced Features Configure VPN feature and upload a TAR package to the IP phone. Web User Interface Navigate to: Local http://<phoneIPAddress>/servlet?p =network-adv&q=load Phone User Interface Configure VPN feature. Details of Configuration Parameters: Parameters Permitted Values Default network.vpn_enable 0 or 1 Description:...
Page 380
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Click Upload to upload the TAR file. The web user interface prompts the message “Import config…”. In the VPN block, select the desired value from the pull-down list of Active. Click Confirm to accept the change.
These metrics can be sent between the phones in RTCP-XR packets. RTCP-XR mechanism for voice quality monitoring is supported by Yealink IP phones. The RTCP-XR mechanism, complaint with RFC 3611-RTP Control Extended Reports (RTCP-XR), provides the metrics contained in RTCP-XR packets for monitoring the quality of calls.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones QoS provides better network service through the following features: Supporting dedicated bandwidth Improving loss characteristics Avoiding and managing network congestion Shaping network traffic Setting traffic priorities across the network ...
Page 383
Configuring Advanced Features SIP QoS SIP protocol is used for creating, modifying and terminating two-party or multi-party sessions. To ensure good voice quality, SIP packets emanated from IP phones should be configured with a high transmission priority. DSCPs for voice and SIP packets can be specified respectively. Procedure QoS can be configured using the configuration files or locally.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the DSCP for SIP packets. The default DSCP value for SIP packets is 26 (Assured Forwarding). Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 385
Configuring Advanced Features number of public IP addresses. NAT ensures security since each outgoing or incoming request must first go through a translation process. But in the VoIP environment, NAT breaks end-to-end connectivity. NAT Traversal NAT traversal is a general term for techniques that establish and maintain IP connections traversing NAT gateways, typically required for client-to-client networking applications, especially for VoIP deployments.
Page 386
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones http://<phoneIPAddress>/servlet? p=network-adv&q=load Phone User Configure NAT traversal and STUN Interface server on a phone basis. Details of Configuration Parameters: Parameters Permitted Values Default account.X.nat.nat_traversal 0 or 1 (X ranges from 1 to 3) Description:...
Page 387
Configuring Advanced Features Parameters Permitted Values Default Configures the IP address or the domain name of the STUN server. Example: sip.nat_stun.server = 218.107.220.201 Web User Interface: Network->Advanced->NAT->STUN Server Phone User Interface: Menu->Settings->Advanced Settings (default password: admin) ->Network->NAT->NAT Server Integer from 1024 to sip.nat_stun.port 3478 65000...
Page 388
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Select STUN from the pull-down list of NAT. Click Confirm to accept the change. To configure NAT traversal and STUN server via web user interface: Click on Network->Advanced. In the NAT block, select the desired value from the pull-down list of Active. Enter the IP address or the domain name of the STUN server in the STUN Server field.
Configuring Advanced Features Click Confirm to accept the change. To configure NAT traversal and STUN server via phone user interface: Press Menu->Settings->Advanced Settings (default password: admin) ->Network->NAT->NAT Status. Press , or the Switch soft key to select the desired value from the NAT Status field.
Page 390
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Yealink 802.1X Authentication For more information on 802.1X authentication, refer to available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Page 391
Configuring Advanced Features Procedure 802.1X authentication can be configured using the configuration files or locally. Configure the 802.1X authentication. Parameters: network.802_1x.mode Configuration File <y0000000000xx>.cfg network.802_1x.identity network.802_1x.md5_password network.802_1x.root_cert_url network.802_1x.client_cert_url Configure the 802.1X authentication. Web User Interface Navigate to: Local http://<phoneIPAddress>/servle t?p=network-adv&q=load Configure the 802.1X Phone User Interface authentication.
Page 392
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Phone User Interface: Menu->Settings->Advanced Settings (default password: admin) ->Network->802.1x Settings->802.1x Mode network.802_1x.identity String within 32 characters Blank Description: Configures the user name for 802.1x authentication. Example: network.802_1x.identity = admin Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 393
Configuring Advanced Features Parameters Permitted Values Default Example : network.802_1x.root_cert_url = http://192.168.1.10/ca.pem Note: If you change this parameter, the IP phone will reboot to make the change take effect. It is only applicable to EAP-TLS, EAP-PEAP/MSCHAPV2, EAP-TTLS/EAP-MSCHAPV2, EAP-PEAP/GTC, EAP-TTLS/EAP-GTC and EAP-FAST protocols.
Page 394
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones 2) Enter the password for authentication in the MD5 Password field. b) If you select EAP-TLS: 1) Enter the user name for authentication in the Identity field. 2) Leave the MD5 Password field blank. 3) In the CA Certificates field, click Browse to select the desired CA certificate (*.pem, *.crt, *.cer or *.der) from your local system.
Page 395
Configuring Advanced Features 5) Click Upload to upload the certificates. c) If you select EAP-PEAP/MSCHAPv2: 1) Enter the user name for authentication in the Identity field. 2) Enter the password for authentication in the MD5 Password field. 3) In the CA Certificates field, click Browse to select the desired CA certificate (*.pem, *.crt, *.cer or *.der) from your local system.
Page 396
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones 4) Click Upload to upload the certificate. d) If you select EAP-TTLS/EAP-MSCHAPv2: 1) Enter the user name for authentication in the Identity field. 2) Enter the password for authentication in the MD5 Password field. 3) In the CA Certificates field, click Browse to select the desired CA certificate (*.pem, *.crt, *.cer or *.der) from your local system.
Page 397
Configuring Advanced Features 4) Click Upload to upload the certificate. e) If you select EAP-PEAP/GTC: 1) Enter the user name for authentication in the Identity field. 2) Enter the password for authentication in the MD5 Password field. 3) In the CA Certificates field, click Browse to select the desired CA certificate (*.pem, *.crt, *.cer or *.der) from your local system.
Page 398
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones 1) Enter the user name for authentication in the Identity field. 2) Enter the password for authentication in the MD5 Password field. 3) In the CA Certificates field, click Browse to select the desired CA certificate (*.pem, *.crt, *.cer or *.der) from your local system.
Page 399
Configuring Advanced Features 3) In the CA Certificates field, click Browse to select the desired CA certificate (*.pem, *.crt, *.cer or *.der) from your local system. 4) Click Upload to upload the certificate. Click Confirm to accept the change. A dialog box pops up to prompt that settings will take effect after a reboot. Click OK to reboot the phone.
Page 400
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones e) If you select EAP-PEAP/GTC: 1) Enter the user name for authentication in the Identity field. 2) Enter the password for authentication in the MD5 Password field. f) If you select EAP-TTLS/EAP-GTC: 1) Enter the user name for authentication in the Identity field.
Page 401
This method is used to add a new instance of an AddObject object defined on the CPE. This method is used to remove a particular instance DeleteObject of an object. Yealink TR-069 Technote For more information on TR-069, refer to , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Page 402
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure TR-069 can be configured using the configuration files or locally. Configure TR-069 feature. Parameters: managementserver.enable managementserver.username managementserver.password Configuration <y00000000 File 00xx>.cfg managementserver.url managementserver.connection_request_username managementserver.connection_request_password managementserver.periodic_inform_enable managementserver.periodic_inform_interval Configure TR-069 feature. Web User Navigate to: Local...
Page 403
Configuring Advanced Features Parameters Permitted Values Default Example: managementserver.username = user1 Web User Interface: Settings->TR069->ACS Username Phone User Interface: None String within 64 managementserver.password Blank characters Description: Configures the password for the IP phone to authenticate with the ACS (Auto Configuration Servers).
Page 404
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Example: managementserver.connection_request_username = accuser Web User Interface: Settings->TR069->Connection Request Username Phone User Interface: None String within 64 managementserver.connection_request_password Blank characters Description: Configures the password for the IP phone to authenticate the incoming connection requests.
Page 405
Configuring Advanced Features Parameters Permitted Values Default Web User Interface: Settings->TR069->Periodic Inform Interval (seconds) Phone User Interface: None To configure TR-069 via web user interface: Click on Settings->TR069. Select Enabled from the pull-down list of Enable TR069. Enter the user name and password authenticated by the ACS in the ACS Username and ACS Password fields.
Page 406
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones IPv6 Address Assignment Method Supported IPv6 address assignment methods: Manual Assignment: An IPv6 address and other configuration parameters (e.g., DNS server) for the IP phone can be statically configured by an administrator. Stateless Address Autoconfiguration (SLAAC): SLAAC is one of the most convenient ...
Page 407
Configuring Advanced Features Interface assignment method. Configure the static IPv6 DNS when DHCPv6 is used. Details of Configuration Parameters: Parameters Permitted Values Default network.ip_address_mode 0, 1 or 2 Description: Configures the IP address mode. 0-IPv4 1-IPv6 2-IPv4&IPv6 Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 408
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Enables or disables the IP phone to use manually configured static IPv6 DNS when Internet (WAN) port type for IPv6 is configured as DHCP . 0-Disabled 1-Enabled Note: If you change this parameter, the IP phone will reboot to make the change...
Page 409
Configuring Advanced Features Parameters Permitted Values Default Network->Basic->IPv6 Config->Static IP Address->IPv6 Prefix (0~128) Phone User Interface: Menu->Settings->Advanced Settings (default password: admin) ->Network->WAN Port->IPv6->Static IPv6 Client->IPv6 IP Prefix network.ipv6_internet_port.gateway IPv6 address Blank Description: Configures the IPv6 default gateway when the IP address mode is configured as IPv6 or IPv4&IPv6, and the Internet (WAN) port type for IPv6 is configured as Static IP Address.
Page 410
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default network.ipv6_secondary_dns IPv6 address Blank Description: Configures the secondary IPv6 DNS server when the IP address mode is configured as IPv6 or IPv4&IPv6, and the Internet (WAN) port type for IPv6 is configured as Static IP Address, or and the Internet (WAN) port type for IPv6 is configured as DHCP and Staic DNS is configured as Enabled.
Page 411
Configuring Advanced Features If you mark the Static IP Address radio box, configure the IPv6 address and other configuration parameters in the corresponding fields.
Page 412
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones (Optional.) If you mark the DHCP radio box, you can configure the static DNS address in the corresponding fields. Click Confirm to accept the change. A dialog box pops up to prompt that the settings will take effect after a reboot. Click OK to reboot the phone.
Page 413
Configuring Advanced Features Press , or the Switch soft key to select Enabled from the Static DNS field. Enter the desired values in the IPv4 Pri DNS and IPv4 Sec DNS fields respectively. Press the Save soft key to accept the change.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones This chapter provides information for making configuration changes for the following audio features: Headset Prior Dual Headset Audio Codecs Acoustic Clarity Technology Headset prior allows users to use headset preferentially if a headset is physically connected to the IP phone.
Configuring Audio Features Parameter Permitted Values Default headset mode. The headset mode will not be deactivated until the user presses the HEADSET key again. Web User Interface: Features->General Information->Headset Prior Phone User Interface: None To configure headset prior via web user interface: Click on Features->General Information.
Page 416
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Procedure Dual headset can be configured using the configuration files or locally. Configure dual headset. Configuration File <y0000000000xx>.cfg Parameter: features.headset_training Configure dual headset. Navigate to: Local Web User Interface http://<phoneIPAddress>/se rvlet?p=features-general&q =load Details of the Configuration Parameter:...
Configuring Audio Features Select the desired value from the pull-down list of Dual-Headset. Click Confirm to accept the change. CODEC is an abbreviation of COmpress-DECompress, capable of coding or decoding a digital data stream or signal by implementing an algorithm. The object of the algorithm is to represent the high-fidelity audio signal with minimum number of bits while retaining the quality.
Page 418
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones The following table summarizes the supported audio codecs on IP phones: Codec Algorithm Reference Bit Rate Sample Packetization Rate Time 20ms G722 G.722 RFC 3551 64 Kbps 16 Ksps PCMA G.711 RFC 3551 64 Kbps...
Page 419
Configuring Audio Features Codec Configuration Methods Priority RTPmap Web User Interface Configuration Files G726-24 Web User Interface Configuration Files G726-32 Web User Interface Configuration Files G726-40 Web User Interface Configuration Files iLBC Web User Interface Procedure Configuration changes can be performed using the configuration files or locally. Configure the codecs to use on a per-line basis.
Page 420
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default account.X.codec.Y.enable Refer to the following 0 or 1 (X ranges from 1 to 3, Y ranges content from 1 to 9) Description: Enables or disables the specified codec for account X. 0-Disabled 1-Enabled Default:...
Page 421
Configuring Audio Features Parameters Permitted Values Default When Y=7, the default value is G726-24; When Y=8, the default value is G726-32; When Y=9, the default value is G726-40. Example: account.1.codec.1.payload_type = PCMU Web User Interface: Account->Codec Phone User Interface: None account.X.codec.Y.priority Refer to the following Integer from 0 to 10...
Page 422
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default When Y=1, the default value is 9; When Y=2, the default value is 0; When Y=3, the default value is 8; When Y=4, the default value is 18; When Y=5, the default value is 106;...
Page 423
Configuring Audio Features and then click To adjust the priority of codecs, select the desired codec and then click Click Confirm to accept the change. To configure the ptime on a per-line basis via web user interface: Click on Account. Select the desired account from the pull-down list of Account.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Acoustic Echo Cancellation (AEC) is used to reduce acoustic echo from a voice call to provide natural full-duplex communication patterns. It also increases the capacity achieved through silence suppression by preventing echo from traveling across a network.
Configuring Audio Features Parameter Permitted Values Default Phone User Interface: None To configure AEC via web user interface: Click on Settings->Voice. Select the desired value from the pull-down list of ECHO. Click Confirm to accept the change. Background noise suppression (BNS) is designed primarily for hands-free operation and reduces background noise to enhance communication in noisy environments.
Page 426
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones audio session. VAD can avoid unnecessary coding or transmission of silence packets in VoIP applications, saving on computation and network bandwidth. Procedure VAD can be configured using the configuration files or locally. Configure VAD.
Configuring Audio Features Select the desired value from the pull-down list of VAD. Click Confirm to accept the change. Comfort Noise Generation (CNG) is used to generate background noise for voice communications during periods of silence in a conversation. It is a part of the silence suppression or VAD handling for VoIP technology.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Details of the Configuration Parameter: Parameter Permitted Values Default voice.cng 0 or 1 Description: Enables or disables CNG (Comfortable Noise Generator) feature on the IP phone. 0-Disabled 1-Enabled Web User Interface: Settings->Voice->Echo Cancellation->CNG Phone User Interface: None...
Page 429
Configuring Audio Features is capable of adapting the changes in the network's delay. The range of the delay time for the dynamic jitter buffer added to packets can be also configured on IP phones. Procedure Jitter buffer can be configured using the configuration files or locally. Configure the mode of jitter buffer and the delay time for jitter buffer.
Page 430
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Note: It works only if the parameter “voice.jib.adaptive” is set to 1 (Adaptive). Web User Interface: Settings->Voice->JITTER BUFFER->Min Delay Phone User Interface: None voice.jib.max Integer from 0 to 400 Description: Configures the maximum delay time (in milliseconds) of jitter buffer.
Page 431
Configuring Audio Features The valid value ranges from 0 to 300. Click Confirm to accept the change.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones This chapter provides information for making configuration changes for the following security-related features: Transport Layer Security Secure Real-Time Transport Protocol Encrypting Configuration Files TLS is a commonly-used protocol for providing communications privacy and managing the security of message transmission, allowing IP phones to communicate with other remote parties and connect to the HTTPS URL for provisioning in a way that is designed to prevent eavesdropping and tampering.
Page 434
A unique server certificate: It is unique to an IP phone (based on the MAC address) and issued by the Yealink Certificate Authority (CA). A generic server certificate: It issued by the Yealink Certificate Authority (CA). Only if no unique certificate exists, the IP phone may send a generic certificate for authentication.
Page 435
Configuring Security Features Common Name Validation feature enables the IP phone to mandatorily validate the common name of the certificate sent by the connecting server. And Security verification rules are compliant with RFC 2818. In TLS feature, we use the terms trusted and server certificate. These are also known as Note CA and device certificates.
Page 436
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Upload the trusted certificates. Navigate to: http://<phoneIPAddress>/servlet?p= trusted-cert&q=load Configure server certificates feature. Upload the server certificates. Navigate to: http://<phoneIPAddress>/servlet?p= server-cert&q=load Details of Configuration Parameters: Parameters Permitted Values Default account.X.sip_server.Y.transport_type 0,1,2 or 3 (X ranges from 1 to 3, Y ranges from 1 to 2) Description: Configures the type of transport protocol for account X.
Page 437
Configuring Security Features Parameters Permitted Values Default Note: If you change this parameter, the IP phone will reboot to make the change take effect. Web User Interface: Security->Trusted Certificates->Only Accept Trusted Certificates Phone User Interface: None security.ca_cert 0, 1 or 2 Description: Configures the type of certificates in the Trusted Certificates list for the IP phone to authenticate for TLS connection.
Page 438
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default Description: Configures the type of the device certificates for the IP phone to send for TLS authentication 0-Default certificates 1-Custom certificates Note: If you change this parameter, the IP phone will reboot to make the change take effect.
Page 439
Configuring Security Features Parameters Permitted Values Default Phone User Interface: None phone_setting.reserve_certs_enable 0 or 1 Description: Enables or disables the IP phone to reserve custom certificates after it is reset to factory defaults. 0-Disabled 1-Enabled Web User Interface: None Phone User Interface: None To configure TLS on a per-line basis via web user interface: Click on Account->Register.
Page 440
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Certificates, Common Name Validation and CA Certificates. Click Confirm to accept the change. To upload a trusted certificate via web user interface: Click on Security->Trusted Certificates. Click Browse to select the certificate (*.pem, *.crt, *.cer or *.der) from your local system.
Configuring Security Features To configure the server certificates via web user interface: Click on Security->Server Certificates. Select the desired value from the pull-down list of Device Certificates. Click Confirm to accept the change. To upload a server certificate via web user interface: Click on Security->Server Certificates.
Page 442
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones m=audio 11780 RTP/SAVP 0 8 18 9 101 a=crypto:1 AES_CM_128_HMAC_SHA1_80 inline:NzFlNTUwZDk2OGVlOTc3YzNkYTkwZWVkMTM1YWFj a=crypto:2 AES_CM_128_HMAC_SHA1_32 inline:NzkyM2FjNzQ2ZDgxYjg0MzQwMGVmMGUxMzdmNWFm a=crypto:3 F8_128_HMAC_SHA1_80 inline:NDliMWIzZGE1ZTAwZjA5ZGFhNjQ5YmEANTMzYzA0 a=rtpmap:0 PCMU/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:18 G729/8000 a=fmtp:18 annexb=no a=rtpmap:9 G722/8000 a=fmtp:101 0-15 a=rtpmap:101 telephone-event/8000 a=ptime:20 a=sendrecv The callee receives the INVITE message with the RTP encryption algorithm, and then...
Page 443
Configuring Security Features Procedure SRTP can be configured using the configuration files or locally. Configure SRTP feature on a per-line basis. Configuration File <MAC>.cfg Parameter: account.X.srtp_encryption Configure SRTP feature on a per-line basis. Navigate to: Local Web User Interface http://<phoneIPAddress>/servl et?p=account-adv&q=load&ac Details of the Configuration Parameter: Parameters...
This tool generates another new file named as Aeskey.txt to store the plaintext 16-character symmetric keys for each configuration file. For a Microsoft Windows platform, you can use a Yealink-supplied encryption tool "Config_Encrypt_Tool.exe" to encrypt the <y0000000000xx>.cfg and <MAC>.cfg files respectively.
Configuring Security Features For security reasons, administrator should upload encrypted configuration files, <y0000000000xx_Security>.enc and/or <MAC_Security>.enc files to the root directory of the provisioning server. During auto provisioning, the IP phone requests to download <y0000000000xx>.cfg file first. If the downloaded configuration file is encrypted, the IP phone will request to download <y0000000000xx_Security>.enc file (if enabled) and decrypt it into the plaintext key (e.g., key2) using the built-in key (e.g., key1).
Page 446
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones using random AES key. The AES keys of configuration files are different. Note AES keys must be 16 characters and the supported characters contain: 0 ~ 9, A ~ Z, a ~ z and the following special characters are also supported: # $ % * +, - .
Page 447
Configuring Security Features auto_provision.aes_key_16.com auto_provision.aes_key_16.mac auto_provision.update_file_mode Configure AES keys. Navigate to: Local Web User Interface http://<phoneIPAddress>/servlet?p =settings-autop&q=load Details of Configuration Parameters: Parameters Permitted Values Default auto_provision.aes_key_in_file 0 or 1 Description: Enables or disables the IP phone to decrypt configuration files using the encrypted AES keys.
Page 448
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default (Disabled). Web User Interface: Settings->Auto Provision->Common AES Key Phone User Interface: None auto_provision.aes_key_16.mac 16 characters Blank Description: Configures the plaintext AES key for decrypting the MAC-Oriented CFG file. The valid characters contain: 0 ~ 9, A ~ Z, a ~ z and the following special characters are also supported: # $ % * +, - .
Page 449
Configuring Security Features the following special characters are also supported: # $ % * +, - . : = ? @ [ ] ^ _ { } Click Confirm to accept the change.
However, if you want to specify the desired phone to use the resource file, the resource file access URL should be specified in the <MAC>.cfg file. The names of the Yealink-supplied template files are (You can rename the filename as required):...
Resource Files Softkey Layout Template Directory Template Super Search Template Local Contact File Remote XML Phone Book The replace rule template helps with the creation of multiple replace rules. After setup, place the replace rule template to the provisioning server and specify the access URL in the configuration files.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones <Data Prefix="1" Replace="05928665234" LineID=""/> <Data Prefix="2(xx)" Replace="002$1" LineID="0"/> <Data Prefix="5([6-9])(.)" Replace="3$2" LineID="1,2,3"/> <Data Prefix="0(.)" Replace="9$1" LineID="2"/> <Data Prefix="1009" Replace="05921009" LineID="1"/> </DialRule> The dial-now template helps with the creation of multiple dial-now rules. After setup, place the dial-now template to the provisioning server and specify the access URL in the configuration files.
Resource Files <Data DialNowRule="52[0-6]" LineID="1"/> <Data DialNowRule="xxxxxx" LineID=""/> </DialNow> The softkey layout template allows you to customize soft key layout for different call states. The call states include CallFailed, CallIn, Connecting, Dialing, RingBack and Talking. After setup, place the templates to the provisioning server and specify the access URL in the configuration files.
Resource Files Procedure Use the following procedures to customize a directory template. Customizing a directory template: Open the template file using an ASCII editor. For each directory list that you want to configure, edit the corresponding string in the file. For example, configure the local directory list, edit the following strings: <item id_name="localdirectory"...
Page 456
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones <root_super_search> indicates the start of a template and </root_super_search> indicates the end of a template. The default display names of the directory lists are Local Directory, History, Remote Phone Book and LDAP .
Resource Files You can add contacts one by one on the IP phone directly. You can also add multiple contacts at a time and/or share contacts between IP phones using the local contact template file. After setup, place the template file to the provisioning server and specify the access URL of the template file in the configuration files.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones other_number="" specifies the other number of the contact. line="" specifies the line you want to add this contact to. ring="" specifies the ring tone for this contact. group_id_name="" specifies the existing group you want to add the contact to. Specify the values within double quotes.
Page 459
Specify the key between <Name> and </Name>. Specify the access URL of a XML file between </URL> and </URL>. Save the file and place this file to the provisioning server. The following shows an example of a Menu.xml file: <YealinkIPPhoneMenu> <Title>XiaMen Yealink</Title> <MenuItem> <Name>Department1</Name> <URL>http://10.2.9.1:99/Department.xml</URL> </MenuItem>...
Page 460
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones <URL>http://10.2.9.1:99/Department.xml</URL> </SoftKeyItem> <SoftKeyItem> <Name>*</Name> <URL>http://10.2.9.1:99/Department.xml</URL> </SoftKeyItem> <SoftKeyItem> <Name>1</Name> <URL>http://10.2.9.1:99/Department.xml</URL> </SoftKeyItem> </YealinkIPPhoneMenu> When creating a Department.xml file, learn the following: <YealinkIPPhoneDirectory> indicates the start of a department file and </YealinkIPPhoneDirectory> indicates the end of a department file. Create contact lists for a department between <DirectoryEntry>...
Page 461
Resource Files </DirectoryEntry> <DirectoryEntry> <Name>Test3</Name> <Telephone>6650</Telephone> <Telephone>915980830849</Telephone> </DirectoryEntry> </YealinkIPPhoneDirectory> Yealink supplies a phonebook generation tool to generate a remote XML phone book. Note For more information, refer to Yealink Phonebook Generation Tool User Guide , available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones This chapter provides an administrator with general information for troubleshooting some common problems that he (or she) may encounter while using IP phones. IP phones can provide feedback in a variety of forms such as log files, packets, status indicators and so on, which can help an administrator more easily find the system problem and fix it.
Page 463
Troubleshooting Procedure Log setting can be configured using the configuration files or locally. Configures the syslog mode. Parameters: syslog.mode Configures the IP address or domain name of the syslog server where to export the log files. Configuration File <y0000000000xx>.cfg Parameters: syslog.server Configures the severity level of the logs to be reported to a log file.
Page 464
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameters Permitted Values Default None syslog.server IP address or domain name Blank Description: Configures the IP address or domain name of the syslog server when exporting log to the syslog server. Example: syslog.server = 192.168.1.50 Note: It works only if the parameter “syslog.mode”...
Page 465
Troubleshooting Select the desired level from the pull-down list of System Log Level. Click Confirm to accept the change. The system log level is set as 6, the informational level. Note Informational level may make some sensitive information accessible (e.g., password-dial number), we recommend that you reset the system log level to 3 after providing the syslog file.
Page 466
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Enter the IP address or domain name of the syslog server in the Server Name field. Click Confirm to accept the change. A dialog box pops up to prompt “Do you want to restart your machine?”. The configuration will take effect after a reboot.
Page 467
Troubleshooting Click Export to open file download window, and then save the file to your local system. The following figure shows a portion of a log file- an account registration: You can capture packet in two ways: capturing the packet via web user interface or using the Ethernet software.
Page 468
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Click Stop to stop capturing. Click Export to open the file download window, and then save the file to your local system. To capture packets using the Ethernet software: Connect the Internet port of the IP phone and the PC to the same HUB, and then use Sniffer, Ethereal or Wireshark software to capture the signal traffic.
Page 469
Troubleshooting http://<phoneIPAddress> /servlet?p=settings-prefer ence&q=load Details of the Configuration Parameter: Parameter Permitted Values Default watch_dog.enable 0 or 1 Description : Enables or disables Watch Dog feature. 0-Disabled 1-Enabled If it is set to 1 (Enabled), the IP phone will reboot automatically when the system is broken down.
Page 470
The <mac>-local.cfg configuration file contains changes made via phone user interface and web user interface. The config.bin file is an encrypte file. For more information on config.bin file, contact your Yealink reseller. To export BIN configuration files via web user interface: Click on Settings->Configuration.
Page 471
Troubleshooting To export CFG configuration files via web user interface: Click on Settings->Configuration. Select Local_Configuration or All_Configuration from the pull-down list of Export CFG Configuration File. Click Export to open file download window, and then save the file to your local system.
Page 472
Click Import to import the configuration file. This section describes solutions to common issues that may occur while using the IP phone. Upon encountering a scenario not listed in this section, contact your Yealink reseller for further support. Do one of the following: Ensure that the IP phone is properly plugged into a functional AC outlet.
Page 473
Troubleshooting Ensure that the Ethernet cable is not damaged. Ensure that the IP address and related network parameters are set correctly. Ensure that your network switch or hub is operational. “ ” The LCD screen prompts “No Service” message when there is no available SIP account on the IP phone.
Page 474
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones or are seated too close to sensitive microphones and cause echo. Intermittent voice is mainly caused by packet loss, due to network congestion, and jitter, due to message recombination of transmission or receiving equipment (e.g., timeout handling, retransmission mechanism, buffer under run).
Page 475
(the size of the uncompressed file compared to that of the compressed file) and can be stored in smaller space. Tools for converting BMP format to DOB format are available. For more information, refer to Yealink IP Phones Auto Provisioning Guide available online: http://www.yealink.com/DocumentDownload.aspx?CateId=142&flag=142.
Page 476
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones “ ” “ ” They are codes that the IP phone sends to the server when a certain action takes place. On code is used to activate a feature on the server side, while off code is used to deactivate a feature on the server side.
Page 477
Troubleshooting To reset the IP phone via web user interface: Click on Settings->Upgrade. Click Reset to Factory Reset in the Reset to Factory Setting field. The web user interface prompts the message “Do you want to reset to factory?”. Click OK to confirm the resetting. The IP phone will be reset to factory sucessfully after startup.
Page 478
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones 802.1x--an IEEE Standard for port-based Network Access Control (PNAC). It is a part of the IEEE 802.1 group of networking protocols. It provides an authentication mechanism to devices wishing to attach to a LAN or WLAN. ACS (Auto Configuration server)--responsible for auto-configuration of the Central Processing Element (CPE).
Page 479
Appendix technological innovation and excellence. LAN (Local Area Network)--used to interconnects network devices in a limited area such as a home, school, computer laboratory, or office building. MIB (Management Information Base)--a virtual database used for managing the entities in a communications network. OID (Object Identifier)--assigned to an individual object within a MIB.
Page 480
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Time Zone Time Zone Name −11:00 Samoa −10:00 United States-Hawaii-Aleutian −10:00 United States-Alaska-Aleutian −09:00 United States-Alaska Time −09:30 French Polynesia −08:00 Canada(Vancouver, Whitehorse) −08:00 Mexico(Tijuana, Mexicali) −08:00 United States-Pacific Time −07:00 Canada(Edmonton, Calgary) −07:00...
Page 481
Appendix Time Zone Time Zone Name Portugal(Lisboa, Porto, Funchal) Spain-Canary Islands(Las Palmas) United Kingdom(London) Morocco +01:00 Albania(Tirane) +01:00 Austria(Vienna) +01:00 Belgium(Brussels) +01:00 Caicos +01:00 Chad +01:00 Spain(Madrid) +01:00 Croatia(Zagreb) +01:00 Czech Republic(Prague) +01:00 Denmark(Kopenhagen) +01:00 France(Paris) +01:00 Germany(Berlin) +01:00 Hungary(Budapest) +01:00 Italy(Rome) +01:00...
Page 482
New Zealand(Wellington, Auckland) +12:45 New Zealand(Chatham Islands) +13:00 Tonga(Nukualofa) +13:30 Chatham Islands +14:00 Kiribati Yealink IP phones trust the following CAs by default: DigiCert High Assurance EV Root CA Deutsche Telekom AG Root CA-2 Equifax Secure Certificate Authority ...
Page 483
VeriSign Universal Root Certification Authority Yealink endeavors to maintain a built-in list of most common used CA Certificates. Due to Note memory constraints, we cannot ensure a complete set of certificates. If you are using a certificate from a commercial Certificate Authority not in the list above, you can send a request to your local distributor.
Page 484
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones consists of memory key, line key and programable key. The following table lists the number of DSS keys you can configure for each phone model: Phone Model Line Key Programable Key SIP-T23/T23P/T23G Note The programable key takes effect only if the IP phone is idle.
Page 485
Appendix Group Listening XML Group Group Pickup Multicast Paging Paging List Record XML Browser Hot Desking URL Record LDAP Prefix Zero Touch Local Group Keypad Lock ...
Page 486
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Local Directory Local Group XML Directory Keypad Lock Directory Format Integer For the line key, the default value is 15 (Line). For programable keys: When X=1, the default value is 28 (History). When X=2, the default value is 61 (Directory).
Page 488
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones X=1-10, 14 When assigning the following features, you do not need to configure this parameter: DTMF Prefix XML Browser LDAP Conference Forward Hold ...
Page 489
Appendix Configuration File Parameter- <y0000000000xx>.cfg linekey.X.value Parameter- programablekey.X.value Configures the value for some key features. For line keys: Description X ranges from 1 to 3. For programable keys: X=1-10, 14 Format String Default Value Blank Range String within 99 characters When you assign the Speed Dial to the line key, this parameter is used to Example...
Page 490
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Parameter- Configuration File linekey.X.pickup_value <y0000000000xx>.cfg (x ranges from 1 to 3) Configures the pickup code for BLF feature. Description This parameter is only applicable to BLF feature. Format String Default Value Blank Range String within 256 characters...
Configures the second remote phone book. Example linekey.1.xml_phonebook = 1 This section describes how Yealink IP phones comply with the IETF definition of SIP as described in RFC 3261. This section contains compliance information in the following: RFC and Internet Draft Support ...
Page 492
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones RFC 3261—SIP: Session Initiation Protocol (replacement for RFC 2543) RFC 3262—Reliability of Provisional Responses in the Session Initiation Protocol (SIP) RFC 3263—Session Initiation Protocol (SIP): Locating SIP Servers ...
Page 493
Appendix Initiation Protocol (SIP) RFC 3842—A Message Summary and Message Waiting Indication Event Package for the Session Initiation Protocol (SIP) RFC 3856—A Presence Event Package for Session Initiation Protocol (SIP) RFC 3863—Presence Information Data Format RFC 3890—A Transport Independent Bandwidth Modifier for the SDP ...
RFC number. The following SIP request messages are supported: Method Supported Notes REGISTER Yealink IP phones support mid-call changes such as placing a call on hold as INVITE signaled by a new INVITE that contains an existing Call-ID.
Page 495
Appendix Method Supported Notes MESSAGE UPDATE PUBLISH The following SIP request headers are supported: Note In the following table, a “Yes” in the Supported column means the header is sent and properly parsed. Method Supported Notes Accept Alert-Info Allow Allow-Events Authorization Call-ID Call-Info...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Method Supported Notes Proxy-Authenticate Proxy-Authorization RAck Record-Route Refer-To Referred-By Remote-Party-ID Replaces Require Route RSeq Session-Expires Subscription-State Supported User-Agent The following SIP responses are supported: Note In the following table, a “Yes” in the Supported column means the header is sent and properly parsed.
Page 497
Appendix 1xx Response Supported Notes 181 Call Is Being Forwarded 183 Session Progress 2xx Response—Successful Responses 2xx Response Supported Notes 200 OK 202 Accepted In REFER transfer. 3xx Response—Redirection Responses 3xx Response Supported Notes 300 Multiple Choices 301 Moved Permanently 302 Moved Temporarily 4xx Response—Request Failure Responses 4xx Response...
Page 498
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones 4xx Response Supported Notes 414 Request-URI Too Long 415 Unsupported Media Type 416 Unsupported URI Scheme 420 Bad Extension 421 Extension Required 423 Interval Too Brief 480 Temporarily Unavailable 481 Call/Transaction Does Not Exist 482 Loop Detected 483 Too Many Hops...
Page 499
Appendix 6xx Response—Global Responses 6xx Response Supported Notes 600 Busy Everywhere 603 Decline 604 Does Not Exist Anywhere 606 Not Acceptable SDP Headers Supported v—Protocol version o—Owner/creator and session identifier a—Media attribute c—Connection information m—Media name and transport address s—Session name t—Active time SIP uses six request methods: INVITE—Indicates a user is being invited to participate in a call session.
Page 500
SIP 6xx—Global Failure Responses The following figure illustrates the scenario of a successful call. In this scenario, the two end users are User A and User B. User A and User B are located at Yealink SIP IP phones. The call flow scenario is as follows: User A calls User B.
Page 501
Appendix Step Action Description User A sends a SIP INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is ...
Page 502
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description being alerted. The proxy server forwards the 180 180 Ringing—Proxy Server to Ringing response to User A. User A User A hears the ring-back tone indicating that User B is being alerted.
Page 503
The following figure illustrates the scenario of an unsuccessful call caused by the called user’s being busy. In this scenario, the two end users are User A and User B. User A and User B are located at Yealink SIP IP phones. The call flow scenario is as follows: User A calls User B.
Page 504
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description field. The transaction number within a single call leg is identified in the CSeq field. The media capability User A is ready to receive is specified.
Page 505
The following figure illustrates the scenario of an unsuccessful call caused by the called user’s no answering. In this scenario, the two end users are User A and User B. User A and User B are located at Yealink SIP IP phones. The call flow scenario is as follows: User A calls User B.
Page 506
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
The following figure illustrates a successful call setup and call hold. In this scenario, the two end users are User A and User B. User A and User B are located at Yealink SIP IP phones. The call flow scenario is as follows: User A calls User B.
Page 508
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones User A places User B on hold. User A Proxy Server User B F1. INVITE B F2. INVITE B F3. 180 Ringing F4. 180 Ringing F5. 200 OK F6. 200 OK F7.
Page 509
Appendix Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 510
In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 511
Appendix The call flow scenario is as follows: User A calls User B. User B answers the call. User C calls User B. User B accepts the call from User C. Proxy Server User C User A User B F1. INVITE B F2.
Page 512
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 513
Appendix Step Action Description User A sends a SIP ACK to the proxy server, The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active. The proxy server sends the SIP ACK to User B.
Page 514
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends a mid-call INVITE request INVITE—User A to Proxy to the proxy server with new SDP Server session parameters, which are used to place the call on hold. INVITE—Proxy Server to User The proxy server forwards the mid-call INVITE message to User B.
Page 515
This is called a blind transfer. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 516
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones User C answers the call. Call is established between User A and User C. User A Proxy Server User B User C F1. INVITE B F2. INVITE B F3. 180 Ringing F4.
Page 517
Appendix Step Action Description User A sends an INVITE message to the proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 518
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends a SIP ACK to the proxy server, The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active.
Page 519
This is called attended transfer. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 520
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones User A transfers the call to User C. Call is established between User B and User C. User A Proxy Server User B User C F1. INVITE B F2. INVITE B F3.
Page 521
Appendix Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 522
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends a SIP ACK to the proxy server, The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active.
Page 523
Appendix Step Action Description sends the INVITE request to User C. User C sends a SIP 180 Ringing 180 Ringing—User C to Proxy response to the proxy server. The 180 Server Ringing response indicates that the user is being alerted. The proxy server forwards the 180 180 Ringing—Proxy Server to Ringing response to User A.
User C when User A calls User B. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 525
Appendix User C answers the call. Call is established between User A and User C. User A Proxy Server User B User C F1. INVITE B F2. INVITE B F3. 302 Move Temporarily F4. ACK F5. 302 Move Temporarily F6. ACK F7.
Page 526
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends an INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of the User B is ...
Page 527
Appendix Step Action Description User A sends a SIP INVITE request to the proxy server. In the INVITE request, a INVITE—User A to Proxy unique Call-ID is generated and the Server Contact-URI field indicates that User A requested the call. The proxy server maps the SIP URI in the INVITE—Proxy Server to User To field to User C.
User B is busy. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network. The call flow scenario is as follows: User B enables busy call forward, and the destination number is User C.
Page 529
Appendix Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 530
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description ACK message. 302 Move Temporarily—Proxy The proxy server forwards the 302 Server to User A Moved Temporarily message to User A. User A sends a SIP ACK to the proxy server.
User C when User B does not answer the incoming call after a period of time. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network.
Page 532
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 533
Appendix Step Action Description ACK message. 302 Move Temporarily—Proxy The proxy server forwards the 302 Server to User A Moved Temporarily message to User A. User A sends a SIP ACK to the proxy server. The ACK message notifies the ACK—User A to Proxy Server proxy server that User A has received the ACK message.
Page 534
User B and User C. In this call flow scenario, the end users are User A, User B, and User C. They are all using Yealink SIP IP phones, which are connected via an IP network. The call flow scenario is as follows: User A calls User B.
Page 535
Appendix User A mixes the RTP channels and establishes a conference between User B and User C. User A User B User C Proxy Server F1. INVITE B F2. INVITE B F3. 180 Ringing F4. 180 Ringing F5. 200 OK F6.
Page 536
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description User A sends the INVITE message to a proxy server. The INVITE request is an invitation to User B to participate in a call session. In the INVITE request: The IP address of User B is inserted ...
Page 537
Appendix Step Action Description User A sends a SIP ACK to the proxy server. The ACK confirms that User A ACK—User A to Proxy Server has received the 200 OK response. The call session is now active. The proxy server sends the SIP ACK to User B.
Page 538
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Step Action Description sends the SIP INVITE request to User C. User C sends a SIP 180 Ringing 180 Ringing—User C to Proxy response to the proxy server. The 180 Server Ringing response indicates that the user is being alerted.
Page 540
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Numeric 180 Ring Workaround 802.1X Authentication Call Completion Call Forward Call Hold Call Log About This Guide Call Park Acoustic Echo Cancellation Call Recording Action URL Call Return Action URI Call Transfer Administrator Password Call Waiting...
Page 541
Index Early Media Local Directory Encrypting Configuration Files Logo Customization Enabling the Watch Dog Feature Message Waiting Indicator Feature Key Synchronization Missed Call Log Multicast Paging Getting Information from Status Indicators Getting Started NAT Traversal Group Call Pickup Network Address Translation (NAT) Network Conference No Answer Forward Notification Popups...
Administrator’s Guide for SIP-T23 & T23P & T23G IP Phones Server Redundancy Session Timer Web Server Type Web User Interface SIP Components SIP Header SIP IP Phone Models SIP Request SIP Responses SIP Session Description Protocol Usage SIP Session Timer Softkey Layout Specifying the Language to Use SRTP...
Need help?
Do you have a question about the SIP-T2 Series and is the answer not in the manual?
Questions and answers