Campos de datos personalizados: Caso de uso en Studio

En este artículo, le mostraremos cómo configurar y utilizar la función para almacenar datos personalizados y relacionarlos con las interacciones de Talkdesk dentro de Studio Flow (s).

 

Paso 1: Crear un cliente OAuth.

Cree un cliente oAuth con el alcance (interaction-custom-fields:write). Se presenta un ejemplo:

  • Vaya a «Builder - > Clientes OAuth» y genere un nuevo cliente OAuth.

 

    • Elija un tipo de concesión.
    • Agregue el alcance «interaction-custom-fields:write» y pulse el botón para crear el nuevo Cliente OAuth (podrá descargar datos importantes como el Client ID y Client Secret).

 

  •  
  • Para más información sobre los clientes oAuth, haga clic aquí.

 

Paso 2: Crear una integración personalizada

Cree una conexión personalizada utilizando la Reporting Custom Fields API para almacenar los datos personalizados (relacionados con una interacción de Talkdesk). Se presenta un ejemplo:

  • Vaya a «Builder -> Integrations» y cree una nueva integración (escriba “Integración personalizada”).

 

  • En la configuración de la integración personalizada, deberá completar los datos relacionados con la Regional Cloud de su cuenta de Talkdesk:
      1. Ruta base: revise la información aquí (regiones compatibles y URL base).
      2. Tipo de autenticación: Recomendamos usar «Credenciales de cliente OAuth2», con: Client ID: el Client ID del cliente OAuth creado en el paso anterior.
        •  
        • Client Secret: el Client Secret del cliente OAuth creado en el paso anterior.
      3. URL de token de acceso: revise la información aquí (URL base).
  • Para obtener más información sobre integraciones personalizadas, haga clic aquí.

 

Paso 3: Crear una acción

Cree una acción para insertar los datos personalizados en Talkdesk.

Esta acción será utilizada por Studio Flow.

Se presenta un ejemplo:

  • Vaya a «Builder -> Integrations -> <<your connection="" custom="">>» y cree una acción.</your>
  •  
  • Para invocar la Reporting Custom Fields API para almacenar los datos personalizados, necesitará las siguientes configuraciones:

  • Ruta relativa: Post -> interaction-custom-fields.
  • En el esquema de entrada, puede usar algo así:
{

  "$id": "root",

  "$schema": "http://json-schema.org/draft-07/schema#",

  "type": "object",

  "properties": {

    "interaction_id": {

      "type": "string",

      "title": "interaction_id"

    },

    "text_field_1": {

      "type": "string",

      "title": "text_field_1"

    },

    "text_field_2": {

      "type": "string",

      "title": "text_field_2"

    },

    "text_field_3": {

      "type": "string",

      "title": "text_field_3"

    },

    "text_field_4": {

      "type": "string",

      "title": "text_field_4"

    },

    "numeric_field_1": {

      "type": "number",

      "title": "numeric_field_1"

    },

    "numeric_field_2": {

      "type": "number",

      "title": "numeric_field_2"

    },

    "numeric_field_3": {

      "type": "number",

      "title": "numeric_field_3"

    },

    "numeric_field_4": {

      "type": "number",

      "title": "numeric_field_4"

    },

    "timestamp_field_1": {

      "$id": "#root/timestamp_field_1",

      "title": "Timestamp_field_1",

      "type": "string",

      "default": "",

      "examples": [

        "2024-01-31T12:24:11"

      ],

      "pattern": "^.*$"

    }

  },

  "required": [],

  "additionalProperties": false,

  "title": "root schema"

}
  • No hay necesidad de un esquema de salida.
  • Puede probar esta acción y verificar si aparece en el informe de campos de datos personalizados:
  • Una prueba exitosa recibirá un código «204».
  • Después de esto, puede publicar la acción y empezar a usarla en Studio.
  • Para obtener más información sobre las acciones, haga clic aquí.

 

Paso 4: Usar la acción en un Studio Flow:

Una vez que se hayan completado los pasos anteriores, puede usar esta función en un Studio Flow.

Para obtener los datos personalizados, puede utilizar componentes como «Execute Action» o «Salesforce Data Dip» para recopilar los datos personalizados que se almacenarán en el informe de Interaction Custom Fields.

 

Para almacenar/insertar los datos, debe usar una «Execute Action» con los siguientes pasos:

  • Inserte un componente de tipo «Execute Action» y:
    • Elija la integración personalizada creada en el paso 2.
    • Elija la acción creada en el paso 3.
    • En las entradas se debe usar el Interaction ID (en el flujo de voz y en un flujo digital está disponible en el primer componente) y puede elegir qué Custom Fields usar/almacenar.

 

El siguiente es un flujo de demostración creado para probar esta función:

Para obtener más información sobre los componentes de flujo de Studio, haga clic aquí.

Volver ""
Por favor, inicie sesión para enviar una solicitud.