Phone integration

XUC based web applications like agent interface or xivo client web 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

Supported phones

Manufacturer Function
Answer Hangup Hold Conference Attended Transfer Direct Transfer
Snom 7XX OK OK OK OK OK OK
Polycom VVX OK OK OK NO OK OK
Yealink T4XG, T4XP, T4XS OK OK OK NO OK OK
  • NO - Not available

Required configuration

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

Customize templates for Polycom phones

Warning

Only required 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"

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()'

Known limitations

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

Transfer with Snom

  • Transfer button in Agent / Assistant must be pressed twice to complete the 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