Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Adding and configuring CTI link(s)

Updated on October 12, 2021

When a CTI Link is created, a CTI connection is created from each node within the Pega Platform cluster to the CTI Server.

When a CTI Link is created, it is used on any Pega Platform node within the cluster.

Log in to the Pega Platform as a user with access to the Pega-CTI ruleset (a user with the role CASysAdmin on Pega Customer Service systems, CTIDeveloper in other systems). In the header of Dev Studio, click ConfigureChannel Services Pega CallAdministration & Configuration:

In the Pega Call Administration & Configuration landing page, select the CTI Links gadget. A list of existing CTI links appears, with information about their status.

To edit an existing CTI link, click ActionsEdit.

To create a new link, perform the following :

  1. Choose Add CTI Link and select the CTI link type.
  2. In the new form, provide a short description and name for the new CTI link, then click Create and open.
  3. In the rule form that appears on the Link Configuration tab, enter the information for your CTI Link.
    FieldDescription
    EnabledSelect if this CTI Link is enabled. Pega Call will only attempt to connect to the CTI server if the corresponding CTI Link is enabled.
    Auto StartSelect if you wish to have Pega Platform start the CTI engine when Pega Platform starts up. Allowing PRPC to autostart a CTI Link ensures that the link is ready when CSRs need to use telephony services. If AutoStart is not enabled, the first CSR to login after Pega Platform starts up is likely to experience a longer delay before he or she logs in. Select AutoStart for CTI Links on production systems.
    JTAPI VendorChoose "Avaya AES" to connect with the Avaya AES platform.
    AES Server Host NameRequired. The host name or IP address of the AES server.
    T-Server Host NameRequired. The host name or IP address of the T-server.
    PortRequired. Port that Pega Call connects to.
    Tenant IDUser ID for the CTI user or connection on the CTI Server.
    PasswordPassword for the CTI user ID on the CTI Server.
    Application NameThe application name associated with Pega Call on the Genesys Pure Engage platform.
    Append Node IDSelect this check box to append the Pega Platform node ID to the application name. In a Pega Platform cluster, this enables identification of each Pega Platform node's connection to the T-Server.
    CTI Server Host NameRequired. The host name or IP address of the CTI server.
    PortRequired. The port used for SOAP connections to the server.
    Peripheral IDRequired. ID of the ACD peripheral on Cisco ICM.
    Protocol Version

    Select the protocol version from the options provided.

    CTI Protocol Version

    ICM/UCCE Version

    107.0 and above
    148.0 and above
    158.5 and above
    169.0 and above
    1810.0 and above
    Client IDRequired. User ID for the CTI user or connection on the CTI Server.
    PasswordPassword for the CTI user ID on the CTI Server.
    Append Node IDSelect this check box to append the PRPC node ID to the application name. In a Pega Platform cluster, this enables identification of each Pega Platform node's connection to the Cisco CTI Server.
    TLinkThe name of the TLink on the Avaya AES Server.
    AES User IDRequired. User ID for the CTI user or connection on the CTI Server.
    PasswordRequired. Password for the CTI user ID on the CTI Server.
    Connection Timeout(s)Time in seconds before a CTI Link is considered to be disconnected. The CTI Link Engine will wait for this duration after a connection interruption, before attempting to connect to a backup CTI server (if one is configured).
    Retry Interval(s)Time in seconds between attempts to reconnect to the CTI server. The Retry Interval should be set to a lower value than the Connection Timeout, to allow the CTI Link Engine to attempt to reconnect to a CTI Server before attempting to fail over to the backup CTI Server.
    Heartbeat EnabledWhether to enable heartbeats on the link between the Pega Platform node(s) and the Cisco CTI Server
    Heartbeat IntervalTime in seconds between heartbeats on the link to the Cisco CTI Server.
    ECC Variable Key ConversionThe CTI Link engine for Cisco ICM uses a Pega Platform value group to represent ICM’s extended call context (ECC) variables. ECC variable names are mapped to property names. Since Pega Platform property names cannot include periods (.), all periods in ECC variable names received from ICM are mapped to underscore (_) characters in Pega Platform property names. The key conversion setting determines how underscores in the Pega Platform property names are mapped to ECC variable names when variables are sent back to ICM. This setting is set to All, First or None. If set to All, all underscore characters in the property name will be mapped to periods in the ECC variable name. If set to First, only the first underscore in the property name is mapped to a period. If set to None, the property name is used as the ECC variable name with no mapping of underscore characters.
    Enable UCID SupportSelect to have Pega Call get and use universal call IDs (UCIDs) from Avaya AES. Only enable this option if UCIDs are configured on the Avaya ACD and if you use universal call IDs to track calls between systems.
    Site IDProvide a unique identifier for the ACD that this CTI link will connect to. If more than one link connects to the same ACD, they should all have the same Site ID.
    Desktop HeartbeatsThese settings pertain to heartbeats from the desktop to the server.
    • Enabled --Select to require heartbeats from desktops. If a Pega Call-enabled desktop stops sending heartbeat messages (as when a web browser is shut down without properly logging out from CTI), the CTI Link stops monitoring the device (phone or extension) associated with that desktop. It is recommend that you enable this option, in order to prevent continued monitoring of devices that are not being used and potential problems with subsequent logins.
    • Heartbeat Interval(s) -- Interval (in seconds) at which heartbeat messages are expected.
    • Heartbeat Timeout(s) --Elapsed time (in seconds) after which, if no heartbeats have been received from a desktop, the CTI Link will stop monitoring the device associated with the desktop. This should be set to several times the heartbeat interval.
    • Behavior upon timeout -- Select one of the options provided:
      • Unmonitor device (stop event subscription) -- Stops the CTI event subscription from the CTI server for the user's device (extension). Pega Call no longer monitors the user's extension and does not provide screen pops or UI updates for that extension. The user can no longer control that extension through Pega Call. The user's agent-state does not change on the ACD.
      • Make agent Not-Ready and unmonitor device -In addition to stopping CTI events as described in the option above, Pega Call attempts to change the user's agent-state on the ACD to "Not-Ready". This prevents the user from receiving customer phone calls from the queue.
    Javascript ObjectThe JavaScript reference that is used to perform the operation. This is a read-only field.
    Primary Server URLRequired. Primary host of the CTI server.
    Failover Server URLFailover host of the CTI server
    Dial PlanSelect a dial plan rule that will be used to place calls with this CTI Link Engine. If no dial plan is selected, dial strings will be sent to the PBX/ACD without modification.
    Contact Center InstanceEnter the Amazon Connect contact center instance.
    CCT Server Host NameRequired. The host name or ip address of the AACC Communications Control Toolkit (CCT) Server.
    CCT Server PortThe port used for SOAP connections to the CCT Server.
    Domain NameThe Windows domain for the AACC system. This domain will be used to authenticate CSRs when they log in.
    Dial PlanSelect a dial plan rule that will be used to place calls with this CTI Link. If no dial plan is selected, dial strings will be sent to the PBX/ACD without modification.
    Site IDProvide a unique identifier that this CTI link will connect to. If more than one link connects to the same ACD, they should all have the same Site ID.
  4. Save the CTI Link configuration.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us