Send reserved data properties

With reserved data properties, you can send information about an end-user to CCAI Platform when a chat or call session begins, or even after a session has begun. CCAI Platform displays this end-user information in the agent adapter in the form of user profile flags. These flags can help an agent or supervisor determine how to handle a session. There are user profile flags for unverified or verified customer, bad actor, and repeat customer.

Here are the reserved data properties that you can send to CCAI Platform:

  • reserved_verified_customer: indicates that you consider this end-user to be a legitimate customer.

  • reserved_bad_actor: indicates that you consider this end-user to potentially be a bad actor. This might be due to observing fraudulent behavior or determining that the contact is from a spam campaign.

  • reserved_repeat_customer: indicates that you have determined that this end-user has contacted your contact center before.

You determine which reserved data parameters apply to an end-user based on your own systems and processes.

You can send reserved data properties to CCAI Platform in the following ways:

Send reserved data properties using the SDKs

You can send reserved data properties to CCAI Platform using the following SDKs:

Send reserved data properties using the Apps API

You can send reserved data properties to CCAI Platform using the Apps API, even after a session has begun. To send reserved data attributes during a chat or call session, see the following:

You can also get reserved data properties during a call. See the following:

Send reserved data properties using SIP headers

You can send reserved data properties to CCAI Platform using SIP headers.

Here is an example reserved data properties in a SIP header:

setting: {
  redirection: {
    option: "sip",
    sip: {
      uri: "Destination SIP URI",
      data_parameters_enabled: true | false,
      data_parameters: [
        {
          field: "verified_customer",
          type: "dynamic",
          source: "ujet_metadata",
          source_field: "Incoming Field"
        },
        {
          field: "bad_actor",
          type: "dynamic",
          source: "ujet_metadata",
          source_field: "Incoming Field"
        },
        {
          field: "repeat_customer",
          type: "dynamic",
          source: "ujet_metadata",
          source_field: "Incoming Field"
        }
      ],
      data_records: {
        in_metadata: true | false,
        in_crm_record: true | false
      }
    }
  }
}

Support for virtual agents

If you have a virtual agent (a support agent or a virtual task assistant) that performs end-user verification, the virtual agent can pass the end-user verification information to CCAI Platform. This indicates that the end-user is a legitimate customer. To enable this, you need to configure your virtual agent.

Configure a support agent to pass the Verified Customer parameter

To configure a support agent to pass the Verified Customer parameter, follow these steps:

  1. In the CCAI Platform portal, click Settings > Queue. If you don't see the Settings menu, click Menu, and then click Settings > Queue.

  2. In the IVR (Interactive Voice Response) pane, click Edit / View.

  3. Click a queue that has a virtual agent assigned to it. For more information, see Assign virtual agents to queues.

  4. In the Settings for Test pane, go to Channel Settings.

  5. Click Edit Virtual Agent Assignments.

  6. Under Data Parameters, click Add Parameter. The Add Parameter dialog appears.

  7. To define the parameter, do the following:

    1. Click the Type field, and then select Dynamic.

    2. Click the Source field, and then select Session Metadata.

    3. Click the Incoming Field field, and then select Verified Customer.

    4. In the Destination Field, enter a field name that your CRM will recognize, and that Dialogflow CX will use as a parameter. A preview of the parameter appears in the Preview field.

    5. Click Save, and then click Save again.

Configure a virtual task assistant to pass the Verified Customer parameter

To configure a virtual task assistant to pass the Verified Customer parameter, follow these steps:

  1. In the CCAI Platform portal, click Settings > Virtual Agent. If you don't see the Settings menu, click Menu, and then click Settings > Virtual Agent.

  2. Go to the Virtual Agents pane and find the virtual task assistant that you want to configure. This should be a virtual agent with a Call label and an Assistant label. For more information, see Create a virtual task assistant.

  3. Click Edit for the virtual agent that you are configuring. The Edit a Virtual Task Assistant dialog appears.

  4. Under Data Parameters, click Add Parameter. The Add Parameter dialog appears.

  5. To define the parameter, do the following:

    1. Click the Type field, and then select Dynamic.

    2. Click the Source field, and then select Session Metadata.

    3. Click the Incoming Field field, and then select Verified Customer.

    4. In the Destination Field, enter a field name that your CRM will recognize, and that Dialogflow CX will use as a parameter. A preview of the parameter appears in the Preview field.

    5. Click Save, and then click Save again.

User profile flags

When reserved data properties are sent to CCAI Platform during a call or chat session, this information is displayed in the agent adapter in the form of user profile flags. There are user profile flags for unverified or verified customer, bad actor, and repeat customer. For information about how these flags are displayed in the agent adapter, see User profile flags for chat and User profile flags for calls.