UCP Phone

This applies to version 14 of your PBX GUI

The UCP Phone (formerly WebRTC Phone) is an in-browser phone. The Phone widget allows an Administrator to enable a "WebRTC phone" that can be attached to a user's extension which they can connect to through the PBX User Control Panel, this phone will then receive phone calls at the same time as the users extension using user and device mode behind the scenes. If you have User and Device Mode enabled any extension you enable the WebRTC Phone a duplicate extension of 99XXXX will be created (where XXXX is the original extension number), when the user then views the web interface of the WebRTC phone they will be connected to device 99XXXX which will receive calls from the original extension.

1 Support
2 Ports
3 Enabling UCP Phone for a user
4 Adding the UCP Phone in UCP
5 UCP Phone Settings

Support

At the time of writing (March 13th 2017) the APIs to utilize the in-browser phone are only supported in Edge, Firefox, Chrome and Opera. See below for a list of supported browsers (in green or light green/yellow):

Additionally the in-browser phone requires a secure connection with a valid certificate. There is currently no way around this. You can get a free certificate through Let's Encrypt with the Certification Manager module.

Ports

Summary of ports and services related to WebRTC. If the PBX is behind a router, set up port forwarding as appropriate. Use the PBX Firewall module to limit access to trusted hosts only where possible.

Service	Default bind port	Notes
UCP https	varies	Defined in System Admin, Port Management. Consider using the defaul https port, 443 to keep things simple for users.
Admin http	varies	If using Let's Encrypt setup and auto renewal, it requires /Admin access on port 80 System Admin, Port Management
Asterisk https	8089	Defined in Advanced settings, Asterisk Builtin mini-HTTP server

Enabling UCP Phone for a user

The UCP Phone can be enabled per user or per group in the User Management Module under the UCP > Phone tab.

If you have not previously correctly configured Certification Manager you will not be able to enable the phone in UCP

Adding the UCP Phone in UCP

The UCP Phone widget is only available as a Side Bar Widget

Once added the phone will show up on all dashboards to the left

Clicking the phone will bring up the dialpad. You can receive calls even when the dialpad is closed.

You can type a number into the interface and then click call to place a call.

Calls can be placed on hold by pressing the hold button:

if you close the window will in the middle of a call the call will stay connected and a countdown timer will be added to the side bar icon:

UCP Phone Settings

You can set specific settings for your phone in UCP by clicking the gear icon:

Silence Ringer: Silence the ringer for inbound calls
Disconnect Phone: Disconnect the UCP Phone (appear as offline)