This page explains how to capture data parameters from inbound session initiation protocol (SIP) headers and pass them to virtual agents, virtual task assistants, and outbound SIP headers.
Data parameters by channel
The following table is a high-level overview outlining data parameter availability by channel.
Data parameter type | Customer Support Virtual Agent | Task Virtual Assistant | |||||||
---|---|---|---|---|---|---|---|---|---|
Web | Mobile | IVR | SMS | Web | Mobile | IVR | SMS | ||
Fixed | X | X | X | X | |||||
Dynamic | CCAI Platform metadata | X | X | X | X | ||||
Signed parameters | X | X | |||||||
Unsigned parameters | X | X | |||||||
SIP headers | X | X | |||||||
Form | X |
Capture data parameters from inbound SIP headers
You can capture data parameters from inbound SIP headers and pass them to the following:
You can also configure CCAI Platform to include inbound SIP header data in CRM records and session metadata files.
To capture data parameters from inbound SIP headers, follow these steps:
In the CCAI Platform portal, click Settings > Operation Management. If you don't see the Settings menu, click Menu.
Go to the Data Parameters pane.
Under Voice, select Capture data parameters from inbound SIP headers in IVR sessions.
To use SIP header data for caller ID, do the following:
Select Use SIP header data for Caller ID.
In the Field name field, enter the SIP header field name.
Select Include SIP header data in session CRM records to include SIP header data as a comment in the CRM record.
Select Include SIP header data in session metadata files to include SIP header data in the session metadata file.
Click Save Data Parameters.
CRM record
The following code sample shows how the data parameters from an inbound SIP header would look in a CRM record:
Call redirected to external SIP.
SIP destination: <<SIP Destination URI>>
Data parameters passed:
{
"<<destination_field_#1>>" : "<<destination_value_#1>>",
"<<destination_field_#2>>" : "<<destination_value_#2>>"
}
You can include SIP header data in records for the following CRMs:
Session metadata file
The following code sample shows how the data parameters from an inbound SIP header would look in a session metadata file:
"sip_headers": {
"header 1": "value 1",
"header 2": "value 2"
}
Pass data parameters to outbound SIP headers
For pricing and implementation contact Support.
To send data to an external SIP destination, the Outbound SIP setup for Pass Data Parameters uses the automatic redirection capability. The data parameters defined in the inbound SIP header are gathered and transmitted to the external destination assigned to the selected IVR queue.
With Pass Data Parameters to an Outbound SIP you can:
Set up a static or dynamic data parameters at the IVR queue level. A fixed parameter helps you to pass a static value. A dynamic parameter lets you retrieve a value and pass it (dynamically).
Pass the set up parameters in the outbound SIP headers during automatic redirections.
Admin config
Go to Settings > Queue > IVR and then select the queue.
Go to the Automatic Redirection section and make sure the toggle switch is set to Show.
Click the Configure SIP Transfer link.
On the Outbound SIP Configuration panel, enter the Destination SIP URI in
+ccNumber@fqdn
format. There is a 256 character limit for this value.Go to the Pass Data Parameters section and make sure the toggle switch is set to On. Pass Data Parameters cannot be enabled until the Destination SIP URI has been entered.
Add a fixed parameter for a SIP header
Click the Add Parameter button.
Under the Type, select Fixed.
Enter the following fields
Destination Field: the field name under which the data parameter value will be passed to Dialogflow.
Destination Value: the value being passed.
A sample of the parameter is shown in Preview.
Click Save.
Add a dynamic parameter from a SIP Header
Click the Add Parameter button.
Under Type, select Dynamic.
Under Source, select SIP Header.
Enter the following fields:
Incoming Field: the field name in the incoming SIP header the value of which will be passed to Dialogflow. This is a free text entry (string)
Destination Field: the field name under which the data parameter value will be passed to Dialogflow.
A sample of the parameter is shown in Preview.
Click Save.
Data records
Use the checkboxes in the Data Records section to indicate if you want the data parameters passed to be included in the session metadata files or CRM records.
Click Save and then click the Back to Settings link.
Pass data parameters to Virtual Agents and Virtual Task Assistants
Data parameters gather data from incoming calls, hold it during the call, and then pass it back to Google Dialogflow CX services when the call is routed to a Virtual Agent or Virtual Task Assistant. The data parameters are returned in a set format in the Dialogflow APIs when you invoke the Dialogflow Agent.
You can add a data parameter in order to:
Collect either static or dynamic data settings at the IVR queue level. A fixed parameter helps you to pass a static value. A dynamic parameter lets you retrieve a value and pass it (dynamically).
Collect data through a dynamic form parameter: Only available for Virtual Task Assistant when the form parameters are configured. A data capture form is provided to the agent in the Agent Adapter when they deploy the Virtual Task Assistant. A form parameter defines the field(s) that the agent must fill out. For example, if the form field value is
booking_id
, a corresponding manual input field will appear in the adapter. In order for an agent to dispatch a Task Assistant to collect payment, thebooking_id
must be provided.
The following parameters can be added to an existing or a new Virtual Agent or Virtual Task Assistant:
Fixed parameters
CCAI Platform metadata parameters
SIP header parameters
Agent Form parameter (only available for Virtual Task Assistant)
Add a fixed parameter
Fixed data parameters are fields that the system automatically passes to the VA and Task Assistant.
- Click the Add Parameter button.
- Under Type, select Fixed.
- Enter the following fields:
- Destination Field: The field name under which the data parameter value will be passed to Dialogflow.
- Destination Value: The value being passed.
- A sample of the parameter will be shown in Preview.
Add a dynamic parameter from CCAI Platform metadata
Click the Add Parameter button.
Under Type, select Dynamic.
Under Source, select CCAIP Metadata.
In the Incoming Field drop-down, select the type of CCAIP Metadata that will be passed to Dialogflow. The following CCAIP metadata data parameters can be passed:
ANI (phone number): The number the end-user is calling from.
Consumer ID: The unique ID of the end-user in the platform.
Call ID: The unique ID of the call in the platform.
Ticket ID (CRM): The CRM ticket ID linked to the session.
Queue ID: The queue ID from the session it's been escalated from.
DNIS/TFN: The DNIS (Dialed Number Identification Service) or TFN (Toll-Free Number) refers to the unique phone number that an end-user dials to reach your customer support system.
Latest agent ID: A system-generated ID assigned to each agent operating within the CCAI Platform platform. This ID uniquely identifies the agent responsible for handling the most recent segment of an ongoing call.
Latest agent email: The email address associated with the agent who handled the latest segment of an active call.
Queue language: The language short code that identifies the designated queue or department a call is being transferred to based on language requirements.
Current sentiment score: The average sentiment score for the latest segment of a call.
Overall Sentiment Score: A cumulative evaluation of the sentiment or satisfaction level throughout the entire call until the point of transfer.
In the Destination Field, enter the field name under which the data parameter value will be passed to Dialogflow. A sample of the parameter will be shown in Preview.
Click Save.
Add a dynamic parameter from a SIP Header
Click the Add Parameter button.
Under Type, select Dynamic.
Under Source, select SIP Header. Enter the following fields:
Incoming Field: The field name in the incoming SIP header that will be passed to CCAI Platform. This is a free text entry (string).
Destination Field: The field name under which the data parameter value will be passed to CCAI Platform.
A sample of the parameter will be shown in preview.
Add a dynamic custom form parameter
When the Agent Form parameters are configured, a data capture form is provided
to the agent in the Agent Adapter when they deploy the Virtual Task Assistant.
A form parameter defines the field(s) that the agent must fill out. For
example, if the form field value is booking_id
, a corresponding manual input
field will appear in the adapter. In order for an agent to dispatch a Task
Assistant to collect payment, they must enter the booking_id
.
Click +Add parameter.
In the Type drop-down, select Dynamic.
In the Source drop-down, select Form.
Enter the field name to display on the Agent Adapter.
Select the Required checkbox to specify that the parameter has to be filled prior to transferring the session to a Virtual Task Assistant.
Enter the destination parameter. Review the parameter in the preview window before submitting it, as all changes will be accepted without being validated.
Click Save.
Enable passing data parameters at the queue level
In the CCAI Platform portal, go to Settings > Queue > IVR and then select the queue.
Confirm that the queue has Virtual Agents assigned to it and then click the Edit Virtual Agent Assignments link. If the selected queue does not have Virtual Agents assigned, click the Add Virtual Agent button to configure a new Virtual Agent before proceeding.
Go to the Pass Data Parameters section and make sure the toggle is set to On.
Admin Config
Go to Settings > Queue > IVR and then select the queue.
Confirm the queue has Virtual Agents assigned to it and then click the Edit Virtual Agent Assignments link.
NOTE: If the selected queue does not have Virtual Agents assigned, click the Add Virtual Agent button to configure new Virtual Agent before proceeding.
Go to the Pass Data Parameters section and check the toggle is set to On.
Add a Fixed parameter
Click the Add Parameter button.
Under Type, select Fixed.
Enter the following fields
Destination Field: the field name under which the data parameter value will be passed to Dialogflow.
Destination Value: the value being passed.
A sample of the parameter is shown in Preview.
Add a Dynamic parameter from CCAI Platform Metadata
Click the Add Parameter button.
Under Type, select Dynamic.
Under Source, select CCAI Platform Metadata.
In the Incoming Field drop-down, select the type of CCAI Platform Metadata that needs to be passed to Dialogflow.
The following CCAI Platform metadata data parameters can be passed:
ANI (phone number)
Consumer ID
Call ID
Ticket ID (CRM)
Queue ID
In Destination Field, enter the field name under which the data parameter value will be passed to Dialogflow.
A sample of the parameter is shown in Preview.
Click Save.
Add a Dynamic parameter from a SIP Header
Click the Add Parameter button.
Under Type, select Dynamic.
Under Source, select SIP Header.
Enter the following fields:
Incoming Field: the field name in the incoming SIP header the value of which will be passed to Dialogflow. This is a free text entry (string).
Destination Field: the field name under which the data parameter value will be passed to Dialogflow.
A sample of the parameter is shown in Preview.
Data Records
Use the checkboxes in the Data Records section to indicate if you want the data parameters passed to be included in the session metadata files or CRM records.
Click Save and then click the Back to Settings link.