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:
-
- Ruta base: revise la información aquí (regiones compatibles y URL base).
- 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.
- 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í.