Home
Products
xtelsio CTI Clientxtelsio CTI Serverxtelsio TAPI for Asteriskxtelsio IP Phone
Reseller
Order
Downloads
Contact
Help
xtelsio CTI Clientxtelsio CTI Serverxtelsio TAPI for Asteriskxtelsio IP Phone
CTI for Yealink Help:
Configuration

The following notes are used to configure the CTI Client in conjunction with Yealink IP phones.

For Yealink phones, the configuration instructions are basically the same as for Snom phones.
See:

 

TAPI / CTI
  • For the Yealink phones, the CTI Client includes a built-in driver - so no stand-alone TAPI driver is offered.
  • However, the CTI Client provides a "CTI Client TAPI-Connector" in the Windows system , which can be integrated in other TAPI applications.
    By this way, TAPI control is enabled for Yealink phones indirectly via the xtelsio CTI Client.
On this page

Special hints for Yealink phones

Connect Error / Authentication Error

  • T2x and T3x series:
    Check that you can log into the Yealink phone with your web browser.

  • T4x series:
    With firmware version x.73.x.x or higher, the Login for Yealink T4x phones is based on an Internet Explorer component. If the IP address of the Yealink phone is not in the security zones "Local intranet" or is "trusted", the HTTP connection to the phone may fail.

    • Therefore, make sure first that you can log on to the Yealink phone via Internet Explorer.

    • The cause of a "TCP connect error" can also be if an incorrect local IP address is linked under the "Action URLs" tab. If in doubt, try it with all IPs that are available under "Action URLs".

    • For more information see: Connection

    • Internet Explorer - Proxy Settings: If a "restrictive" proxy server is entered in your Internet Explorer, the login test or opening the Yealink TAPI device can fail. In this case, enter the Yealink IP as an exception in the Internet Exporter under: [Internet Options > Connections > LAN Settings > Proxy Server > Advanced > Exceptions].

    Problems with HTTPS for Yealink T4x series: With firmware version x.73.x.x or higher, the Login for Yealink T4x phones is based on an Internet Explorer component. Therefore, make sure first that you can log on to the Yealink phone via Internet Explorer.

    If the login with Internet Explorer fails due to HTTPS certificate problems, please note the following:

  • T5x series:
    Check that you can log into the Yealink phone with your web browser.

 

Allow Remote Control

Yealink phones have a security function, so that control (dialing, answering) is only possible from confirmed IP addresses.

To do this, the IP address of your computer must be entered in the "Action URI IP allow list". See:

  • [Yealink-Web-Konfiguration > Features > Remote Control > Action URI allow IP List].
    • If "Remote Control" is not visible in the left navigation, then this page may have been blocked for simple user logins by your telephone provider. In this case, please contact your telephone provider or telephone administrator.
  • The CTI Client should normally enter the computer IP automatically.
  • To enable "Remote Control" for a subnet, you would have to enter 192.168.1.* manually, for example.
  • A release for all IP addresses with "any" is no longer supported by newer models (from firmware x.86.0.70).
  • In the context of Asterisk TAPI driver there are still problems with the firmware x.73.xx The "Action URI IP allow list" must be set manually in this case via web browser.

Which local computer IP is used, results from the driver configuration setting on the tab "Actions URL". In the context of the "TAPI for Asterisk driver" it is the tab "Local IP".

If the "Action URI IP allow list" was set or changed first time, the next CTI/TAPI dial action must be confirmed once on the phone. Then also CTI functions such as "Answer" are executed by the phone.

CTI dial does not work

To resolve the problem, follow these steps:

  • Verify that a manual dial is performed correctly on the phone.

  • Check that you can log into the Yealink phone with your web browser.

  • Restart the phone. (Simply pull the 5V power cord and re-insert it.)

  • Please install the current xtelsio program version.

  • In the CTI Client, select "Use Active Identity from Phone" in [Options > PhoneDialog (TAPI Device) > Driver Configuration > Tab "Dial" > Identity for Outgoing Connections].

  • Please read the instructions above for "Allow Remote Control".
    Also important is the correctly set local computer IP on the tab "Actions URL".

  • In the CTI Client under [Options > PhoneDialog (TAPI device) > Driver configuration > Tab "Connection"] the "Test" is to be carried out once.

  • Restart the CTI Client using [File > Restart Application].

  • Setup a call using CTI. If the message "Allow Remote Control" appears in the telephone display, confirm this once on the telephone.

  • Verify that you can initiate a dial action in the Yealink web configuration: [Directory > Phone Call Info > Dial Number].
    • If that does not work, it could be due to a special Yealink firmware from your VoIP provider (so occurred at TelekomCLOUD).
      Possible solutions:
      • Import the following configuration file in the Yealink via [Settings > Configuration > CFG Configuration > Import CFG Configuration File]:
      • Or you could try to install the official Yealink firmware for your Yealink phone from: [www.yealink.com > SUPPORT > DOCUMENTS & SOFTWARE / DOWLOAD].
        Hint: Under [Settings > Auto Provision], you can disable autoprovisioning in Yealink by setting [PNP = Off] and clearing [Server URL].
Group call

Problem: Unfortunately, if one group rings several phones in parallel and the call is answered by another group member, the own telephone does not report an Action URL. The own CTI Client does not get, that the own Yealink phone does not ring anymore.
Solution: Under [Options > PhoneDialog (TAPI device) > Driver configuration > Other] you can set an "Incoming call timeout".

Yealink is a registered trademark of Xiamen Yealink Network Technology Co., Ltd. http://www.yealink.com