Connection settings for Twilio Flex

The following fields appear if you select Twilio as the ACD.

Click the Twilio Config button to access the Twilio Configuration page.

NOTE   If your organization has New WFM, then New WFM implementations are done in a separate process. A select number of integrated platforms can be configured using the WFM Integrations page (see Manage WFM integrations). If your integrated platform is not listed on the WFM Integrations page, then it requires a project managed by Calabrio Professional Services.

NOTE   The available fields vary depending on if Quality Management (QM) and/or Classic Workforce Management (WFM) is selected as an enabled product.

Twilio Flex Configuration Information

Calabrio Configuration Information

Products Enabled

Metadata Mapping

(Quality Management only) This section allows you to define which Twilio task attributes, including complex object-based attributes, are synced over with Twilio contacts if you have Quality Management enabled as a product. This is required in order to map additional Twilio Flex task attributes as custom metadata in Calabrio ONE. Enter the Twilio task attribute name exactly as it appears in the attributes of your Twilio tasks. For object-based attributes, enter them in the format <Object Name> and <Attribute Name> . Using the drop-down list, you can choose which custom metadata field a particular task attribute should be mapped to in Calabrio ONE.

Custom metadata fields must first be created in Metadata Manager (located at Application Management > QM > QM Configuration > Metadata Manager).

NOTE   Metadata mapping is not supported for attributes nested more than one level below an object.

Enable RTE Messaging for Screen Recording

(Quality Management only) Selecting this check box allows screen recording for the configured ACD.

Twilio Voice Recording Encryption

Enabling Twilio Voice Recording Encryption allows Calabrio ONE to import encrypted voice recordings from Twilio. You need to enter your Twilio SID and private key in Calabrio ONE for processing. After processing, Calabrio ONE re-encrypts all recordings. In your Twilio system, you can find your SID on the Credentials page. Calabrio keeps key information in Amazon Web Services Secrets Manager.

NOTE   This feature is not enabled by default. To request this feature, contact your account representative.

Event Webhook URL

The event webhook URL is the target URL Calabrio ONE sends contact status event messages to. The URL must be a fully-qualified absolute domain name. Configuring this field allows your tenant to receive a payload notification when a contact has been successfully uploaded and processed in Calabrio ONE. This means contact data and media has been downloaded, audio events processed, and encryption and encoding tasks have been completed.

The payload body of the contact status webhook event is as follows.

1
2
3
4
5
6
7
8
{ 
   "ccrId":0, // (int)
   "sessionId": "", // (string) 
   "legId": "", // (string) - The same value as callId
   “tenantId”: 0, // (int)
   "status": "", // (string) - For example, ‘COMPLETE’ or ‘FAILED’
   "failureReason": "" // (optional string) - A human-readable reason for failure, not a pass-through API error or exception
}

BEST PRACTICE   If your organization has security compliance requirements regarding recordings, you can delete source recordings in Twilio Flex as soon as you are notified a recording is encrypted and secured in Calabrio ONE.

Historical Data Capture

(Classic Workforce Management only) Configuring this section enables Calabrio ONE to look for the Twilio Flex Insights Classic WFM Historical Data Report to add task queues and real-time adherence data to the sync process. Your Twilio Flex account information you gathered as a prerequisite for Workforce Management is entered in the fields of this section.

Agent State Mapping

(Classic Workforce Management only) This section allows you to map specific Twilio activities to specific Calabrio ONE states for adherence if you have Classic WFM enabled as a product. The “Hold” state is pre-configured and does not need to be mapped. Mappings can be edited or deleted by selecting the Edit Mapping or Delete icons to the right of the Enable State Reason Code sliders. Toggle the Enable State Reason Code slider to show the Twilio activity names in the Schedule Adherence drawer.

NOTE   The slider is only available for activities mapped to the Not Ready, Work Not Ready, and Work Ready states in Calabrio ONE.