Pass Data Parameters Global Settings
For more information on implementing this feature contact Support.
Pass Data Parameters allows you to gather specified data from incoming SIP headers and CCAI Platform metadata and pass it to a Virtual Agent or an Outbound SIP destination. These parameters can be set to gather either static or dynamic data, which is subsequently sent to a specified field on the outgoing header.
Enable Data Parameters in global settings
Go to Settings > Operation Management > Data Parameters
Select the Capture data parameters from Inbound SIP headers in IVR sessions checkbox.
Click Save Data Parameters.
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 functionality. 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 allows you to retrieve a value and pass it (dynamically).
Pass the set up parameters in the outbound SIP headers during automatic redirections.
To set up an automatic redirection to an external SIP destination, refer to Configuring SIP Transfers as Automatic Redirection before configuring your parameters.
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 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 Task Assistants
Data Parameters that gather data from incoming calls and send them on to Virtual Agents and Task Assistants. These data parameters are gathered, held during the call, and then passed back to the Google Dialogflow CX services when the call is routed to a Virtual Agent or Task Assistant. The data parameters are returned in a set format within 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 allows you to 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, and 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
- CCAIP 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 CCAIP Metadata
- Click the Add Parameter button.
- Under Type, select Dynamic.
- Under Source, select CCAIP Metadata.
- In the Incoming Field dropdown, select the type of CCAIP Metadata that
will be passed to Dialogflow. The following CCAIP metadata data parameters
can be passed:
- ANI (phone number)
- Consumer ID
- Call ID
- Ticket ID (CRM)
- Queue ID
- 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 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 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
- 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 dropdown, 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.