The Devlink3 protocol is available over WebSocket or TLS and this article will go over how to attach using a WebSocket connection.
For Cloud IP Office solutions, the WebSocket may be the only allowed method to connect. For further information on which DevLink3 you should be configuring, refer to this article.
Websocket is available over HTTP or HTTPS.
- For HTTP, the socket authentication should be MD5, for HTTPS it is recommended that it is used with basic authentication.
Setup within IP Office
The details below are determined by Avaya but are listed for your convenience.
- The DevLink 3 Websocket protocol is available only over TLS. The port for this Websocket connection on IP Office is 50796
- Availability of the TLS service is governed by the IP Office security setting: TAPI / DevLink 3 on the “Unsecured interfaces” TAB in System Security. This must be checked for Chronicall connectivity.
- A combination of username and password is used to authenticate the application.
- This is configurable on the IP Office by adding a new Rights Group and Service User via the Security Settings on the IP Office.
- Configure a new Rights Group and enable the checkboxes "Enhanced TSPI Access" and "DevLink3" in the Telephony API’s tab.
- Configure a new Service User with a Name and Password and assign it the DevLink3 Rights Group Membership
- Note: When monitoring events, a maximum of 3x DevLink3 connections are allowed to a single IP Office. If using multi-node flags, only 3x Devlink3 connections are allowed on a single SCN.
- Lastly, for any non-Avaya device to connect to the HTTP server, the system configuration setting “Avaya HTTP Clients only” needs to be UNCHECKED.
Setup within Chronicall
- When adding a WebSocket site, change the API from 'System Monitor' to 'DevLink3 Websocket (R11)'
- Site Name: Give the IP Office connection a meaningful name.
- IP Address of IP Office: Enter the IP address of the IP Office.
- DevLink3 Username: Enter the Service User with DevLink3 rights (Configured above).
- DevLink3 Password: Enter the password of the Service User (Configured above).
- External Trunks: See here for more details.