Phone Integration¶

XUC based web applications like agent interface or UC Assistant integrates buttons for phone control. This section details necessary configuration, supported phones and limitations.

Note

The VoIP VLAN network have to be accessible by the xivocc xuc server

Required configuration¶

The following steps are not required if you updated the Provisioning plugins.

Polycom phones¶

Warning

This is required only for plugins:

xivo-polycom-4.0.9 version below v1.9
xivo-polycom-5.4.3 version below v1.8

To enable phone control buttons on web interfaces you must update the basic template of Polycom phones:

go to the plugin directory: /var/lib/xivo-provd/plugins/xivo-polycom-VERSION
copy the default template from templates/base.tpl to var/templates/
then you must update app.push parameters in the else section (do not replace switchboard settings) as follows:

apps.push.messageType="5"
apps.push.username="guest"
apps.push.password="guest"

Snom phones¶

For transfer to work on Polaris version you must have plugins with version v2.2 or above.

Yealink phones¶

Warning

This is required only for plugins xivo-yealink-v80 below v1.31

To enable phone control buttons on web interfaces you must update the basic template of Yealink phones:

go to the plugin directory: /var/lib/xivo-provd/plugins/xivo-yealink-VERSION
copy the default template from templates/base.tpl to var/templates/
enable sip notify even for non switchboard profiles (do not replace switchboard settings)

{% if XX_options['switchboard'] -%}
push_xml.sip_notify = 1
call_waiting.enable = 0
{% else -%}
push_xml.sip_notify = 1
call_waiting.enable = 1
{% endif %}

Update Device Configuration¶

to update device configuration you must run xivo-provd-cli -c 'devices.using_plugin("xivo-polycom-VERSION").reconfigure()'
and finally you must resynchronize the device: xivo-provd-cli -c 'devices.using_plugin("xivo-polycom-VERSION").synchronize()'
refer to provisioning documentation for more details
if the phone synchronization fails check if the phone uses the version of the plugin you have updated, you can use xivo-provd-cli -c 'devices.find()'

Configuration Customization¶

If you changed, via the XiVO PBX Web Interface in Configuration ‣ Provisioning‣ Template Device, the phone administrator username or administrator password, you need to customize the xuc server configuration.

For this you need to:

Include the a specific configuration file for the xucserver onment variable to specify the alternate config file location

xuc:
...

  environment:
  ...
  - CONFIG_FILE=/conf/xuc.conf

  volumes:
  - /etc/docker/xuc:/conf

Create the directory /etc/docker/xuc/:
```
mkdir -p /etc/docker/xuc/
```

Create the /etc/docker/xuc/xuc.conf configuration file with the following content:

For Snom: change the user and password values accordingly:

 include "application.conf"

 Snom {
     user="guest"
     password="guest"
 }

For Polycom: change the user and password values accordingly:

 include "application.conf"

 Polycom {
     user="guest"
     password="guest"
 }

Known limitations¶

Phone integration with Agent and Web / Desktop application has these limitations:

Transfer¶

If the second call was initiated from Agent / Assistant and the called user rejected the call, the first call will stay hold until it is manually resumed
If the second call was initiated from the phone, the transfer must be also completed from the phone. It can’t be completed from Agent / Assistant.
You cannot complete a transfer initiated from the Agent / Assistant by hanging up.

Conference with Yealink / Polycom¶

Conference can’t be created from Agent or Web / Desktop Assistant