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"
Customize templates for Yealink phones¶
Warning
Only required 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()'
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
Transfer with Yealink / Polycom¶
- 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.
- If the second call was initiated from Agent / Assistant, the transfer should be completed from there. It is also possible to complete it by hanging up the phone but not by using the transfer key.
Conference with Yealink / Polycom¶
- Conference can’t be created from Agent or Web / Desktop Assistant