Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Excerpt
Use your existent custom CRM application and integrate it with the xCally Phonebar.
 

It can be realized in two way:

  1. basic CTI integration, by setting the CTI parameter into the queue settings.
  2. dynamic CTI integration (for advanced users), that give you more flexibility by setting the CTI params into the variables.

Anchor
Basic
Basic
BASIC CTI INTEGRATION

How it works

Ms. Emily Brown calls the customer care to get information about her order. 

...

A CRM web page with the customer information is displayed by the Phonebar.

 

 

What you need

Create the IVR script

The IVR script is basically the follows:

...

Refer to the Cally Square guide and examples to build your own IVR script.

 

Configure the Queue

 

Warning
titleDEPRECATED
SInce release 2.4.40 use the Integration section and Triggers instead the Queue settings

 

In the Queue Advanced Settings, set the application type, the URL with the parameters and on which event it has to be launched.

...

where UNIQUEID is the unique call id and CALLDATA is the variable where we saved the order number inserted by the customer.

Anchor
cti-params
cti-params
Here is the list of the available parameters:

PARAMETERDESCRIPTION
QUEUEQueue name
UNIQUEIDCall unique ID
CALLERIDCaller ID set on the dialplan or IVR
CALLERIDNUMCaller number, the value of CALLERID(num) variable
CALLERIDNAMECaller name (if any), the value og CALLERID(name) variable
PEERSIP Name
DATECurrent date in format YYYYMMDD
TIMECurrent time in format hhmmss
TIMESTAMPCurrent timestamp in format YYYYMMDDhhmmss
USERNAMEAgent's username
CALLDATACustom data
EXTRAINFOExtravar value
Note
titleImportant

Each parameter must be used in the URL with {} (e.g ....callid={UNIQUEID}&ordernum={CALLDATA} )

...

Note
titleImportant

Every change to the CTI Queue parameters requires a Phonebar restart

 

Ready to live the CTI experience

The custom CRM application receives the data from Phonebar opening its web interface with the customer's order information

...

Info
titleNote

The purpose of the web page in the above picture is only to explain the CTI feature. xCally doesn't include any web page template.

 

Anchor
Dynamic
Dynamic
DYNAMIC CTI INTEGRATION

The advanced CTI dynamic integration, allow you to set the CTI parameters (event, application and parameters) into the variables in order to change dynamically the CTI values for each calls, even into the same queue.

Like the previous example, we suppose to have a Company with 2 different CRM: an old application to use for order number less than 10.000, and a new application to manage the order number greater than 10.000.

In this case, the agent answer to customers from the same Queue so we cannot set the CTI parameter into the queue settings but we need to dynamically change the target URL and parameters according with the order number.

Image Added

 

In the example, the CTI parameters are set as variables 

Image Added

 

    1. CTIEVENT (the event on which the integration starts): 
      1. value "1" -> RING
      2. value "2" -> UP
    2. CTIAPPLICATION (on which browser/application the integration is executed): 
      1. value "1" -> Explorer
      2. value "3" -> Windows application
      3. value "5" -> Chrome
    3. CTIPARAMS (the parameters of the application):
      1. for browser applications, for example, you can set: http://mysite.com/myapp.html?param=value
      2. for Windows applications, for example, you can set: myapp.exe value1 value2 ... valueN

 

The list of CTI parameters to add to the URL is the same of the static CTI integration.

Here is the available params list.

 

Page Properties
hiddentrue
Related issues