How to set up web application integration via Popup URL

Requirements

For Legacy Collaboration/ Collaboration 7:

• UC-Essential subscription or higher 

For x-bees: 

• x-bees Standard subscription or higher

• WMS 6.08.20241011.1 or higher

What is Popup URL / App and what is it used for?

Popup URL / App allows you to open an application or a web page upon receiving or placing a call and pass parameters (static parameters or supported variables).

In Legacy Collaboration

To add Popup URL / App, go to Legacy Collaboration Settings -> Personal -> Popup URL / App 

You can set up the popup URL / App to be for incoming / outgoing call and select the triggering event:

• On-click (Incoming/ Outgoing call): click the link to open the app / URL

Open

• Ringing (Incoming call): the app / URL opens upon receiving a call (when call is in “ringing” state)

• Call generation (Outgoing call): the app / URL opens upon placing a call (when call is in “ringing” state)

• Answer (Incoming/ Outgoing call): the app / URL opens as soon as the call is answered

In x-bees and Collaboration 7

For x-bees and Collaboration 7, Popup URL can be currently configured via WMS only:

1. Go to WMS -> Users

2. Select necessary user and click Preferences -> Edit Preferences

3. On the Edit Preferences screen, click Settings and navigate to Popup URL section:

Open

Supported triggering events are:

• Ringing/ Answer (incoming calls)

• Call generation/ Answer (outgoing calls)

Which variables are supported?

The following variables {param} are supported:

• {CALLERNUM} – Caller number

• {CALLERNAME} – Caller name

• {USERNUM} – User number

• {USERNAME} – User name

• {CALLTYPE} – Call Type (incoming / outgoing)

• {TAGS} – Call tags 

Variable manipulation:

{CALLERNUM:1} – removes the first digit -> in this way you can remove the first digit from the caller number

In Legacy Collaboration Popup URL/ App settings, you can click on the question mark “?” to view the prompt:

Open

Examples of URLs:

• http://yourhost.com/variable1={param} -> example with popup URL

• “C:\Program Files\Internet Explorer\iexplore.exe” http://yourhost.com/?var1={param}^&var2={param} -> example with application (Legacy Collaboration only) 

Callback URLs

Callback URLs are set up globally for all PBX users and allow opening Zoho CRM or other CRM systems upon receiving or placing a call and pass parameters (static parameters or supported variables). You can set up Callback URLs to be opened for the following events: "new call", "call updated" (for example, call transfer), "call ended". When the selected event occurs, PBX makes an HTTP request to the specified URL. 

For example, http://192.168.140.4/?wildix={CALLERNAME}&cnum={CALLERNUM}&uname={USERNAME}&unum={USERNUM}&cdirection={CALLTYPE} .

Other examples of URLs:

• http://yourhost.com/?variable1={param}

• http://yourhost.com/?var1={param}&var2={param}

• http://yourhost.com/variable1/{param}

Supported variables {param}:

• {CALLERNUM} – Caller number

• {CALLERNAME} – Caller name

• {USERNUM} – User number

• {USERNAME} – User name

• {CALLTYPE} – Call Type (incoming / outgoing)

• {CHANNEL} - Call channel

Popup URL examples

You can enter one or several parameters which can be passed to the specified URL.

When you receive an incoming call, the application opens the web page where the new ticket is created, fields “To”, “Subject”, “From number” are filled out automatically, where “To” and “Subject” are the static parameters entered by you and “From number” is the phone number variable entered automatically. Example: