Yealink Configuration

For text-only notifications any Yealink phone is supported.

For notifications with images, you are restricted to the following list.

This procedure defines when the Yealink phone should register the phone as an endpoint within Revolution.

1. Log into the web configuration interface for your phone.

2. Go to Features > Action URL.

3. For the listed actions, identify those for which Yealink should use to register the phone.

   It is suggested you select at least IP Changed, Setup Completed, Registered, and Autop Finish. Note that not all of these actions are available for every phone.

4. For the selected actions, enter the following string into the value fields (replacing [ip_address] with your Revolution IP address):

   http://[ip_address]/YealinkListener?mac=$mac&firmware=$firmware&model=$model

When any of the selected events occur, Yealink will communicate with Revolution using the provided string. At that point, Revolution will recognize the phone as an endpoint, and it will be named in the format:

Yealink <Phone Model> <MAC address>

See Assign a custom name for easier identification for more information.

To send Revolution notification text and images to your Yealink phones, you must configure the Remote Control feature to accept communications from Revolution.

1. Log into the web configuration interface for your phone.

2. Go to Features > Remote Control.

3. For Push XML Server IP Address, enter the IP address of your Revolution server. Alternatively, you can enter the string any, which means that the phone will accept information from any IP address. If you leave this field empty, the phone will reject pushes from all sources.

4. For Username and Password, enter credentials for connecting to the phone. You will enter these credentials into the Yealink settings within Revolution. Ensure that all Yealink phones use the same credentials.

5. For Block XML in Calling, set to Disabled.

   For Action URI Allow IP List, enter the IP address of your Revolution server. You can enter several IP addresses, if needed, in a comma-separated list.

6. All other fields can be set per your requirements.

Go to Configuration > Phone Systems > Yealink.and select the Settings tab.

• For Yealink Username and Yealink Password, enter the credentials used to connect to the Yealink phones, as set up in their web configuration.

• Enable Use HTTPS if you have configured your Yealink phones to use HTTPS. If you enable this and some Yealink phones are not set up for HTTPS, Revolution will fallback to HTTP to ensure notifications continue. When enabled, you may need to enable the Advanced Setting Allow Self-Signed Certificates in the rare case where Revolution does not have the same certificates as Yealink.

When you are creating or editing notifications, you can send information to your Yealink phones by selecting the proper endpoint in the Endpoint & Contact Selection section.

• For text and images, select the endpoint recognized, as described in the section Register your Yealink phones as endpoints.

• For audio, you can use a related process as described in the section Configure Yealink SIP phones.

You can configure Yealink Line Keys to interact with Revolution.

1. Create phone services in Revolution:

   • Phone Service Dialer – See Phone service dialers that dial a number.

   • Phone Service Trigger – See Phone service triggers that send a notification

2. Configure your Yealink phone Line Keys – See Yealink Phone Services.