El generador de integraciones es una herramienta avanzada que, sin necesidad de programación, le permite conectar su agente IA a cualquier API o fuente de datos aunque no posea grandes competencias técnicas o de programación. En este artículo encontrará las preguntas frecuentes sobre el generador de integraciones.
Los temas tratados son estos:
- Preguntas frecuentes sobre parámetros y datos
- Preguntas frecuentes sobre entornos
- Preguntas frecuentes sobre tarjetas y carruseles
- Preguntas frecuentes sobre la autenticación
Artículo relacionado:
Preguntas frecuentes sobre parámetros y datos
¿Cómo se recopilan los datos de sesión de una conversación?
La recopilación de los datos de una sesión en las conversaciones de un agente IA comienza por la obtención automática de los metadatos del usuario cuando se inicia la sesión y continúa durante toda la interacción con el agente IA (lo que permite captar entradas, respuestas y entidades).
En el momento en que comienza una sesión de chat (especialmente si el usuario ha iniciado sesión), se recopilan ciertos metadatos de forma automática. Los metadatos suelen incluir detalles que son únicos para cada usuario, como la ID del usuario o la información de la cuenta, la ID de la sesión, la ubicación, las marcas de tiempo y otros detalles. Esos datos se pueden guardar como una acción de conversación.
En el transcurso de la conversación, puede elegir si desea captar algunas respuestas (ya sea escritas como texto libre o enviadas a través de botones) del usuario. Esto se hace por medio de:
- Un parámetro que usa una opción llamada “Recopilar parámetro” en un bloque condicional
- Una entidad
Luego estos parámetros se pueden transferir a la integración para usarse como parámetros de solicitud en el extremo de URL o en el cuerpo de la solicitud.
¿Qué es un parámetro de URL y cómo se usa?
Un parámetro de URL es un parámetro dinámico en el URL que cambia en función de la información que se pasa a la integración mediante los parámetros de solicitud que vienen de la conversación.
Este es un ejemplo de una ID de usuario que se usa como parámetro:
https://{{zendesk_subdomain}}.zendesk.com/api/v2/users/{{user_id}}En las llaves dobles, el parámetro user_id se agrega al URL.
¿Cómo se accede a los datos de la conversación para usarlos en la API?
Para que los datos de la conversación se puedan usar, deben guardarse en la sesión como un parámetro como se describió anteriormente, ya sea recopilando el parámetro o guardando los metadatos en un parámetro en los datos de sesión. Los datos deben guardarse como un parámetro de solicitud en el generador de integraciones si vienen de la conversación o como datos de sesión o metadatos para enviarse a la API. También se puede enviar dinámicamente un parámetro en el cuerpo de la solicitud.
¿Cómo se accede a los parámetros o datos de la respuesta de la API para usarlos en la conversación?
Para que los parámetros o datos de la respuesta de la API se puedan usar, deben guardarse como parámetros de sesión en el entorno (la mayoría de las veces, el escenario de éxito). Una vez guardados y una vez que la API llega a un determinado escenario, se puede acceder al parámetro de sesión para usarlo en un mensaje de agente IA o como parámetro para un bloque condicional:
- En un mensaje de agente IA, se accede mediante {{parameterName}}.
- En un bloque condicional, se accede con el nombre del parámetro.
¿Cómo se envían parámetros de solicitud en el cuerpo?
Para enviar un parámetro de solicitud en el cuerpo, debe encerrarlo en llaves dobles como en este ejemplo:
{{exampleParameter}}¿Se puede enviar una matriz en el cuerpo de la solicitud?
Sí. Puede seleccionar “Matriz” como tipo de datos a la hora de definir los parámetros de solicitud. Para una prueba, asegúrese de cambiar el formato del valor con la función de JSONata $eval($). La función “eval” analiza y evalúa una cadena que contiene una expresión JSON o una expresión JSONata como si fuera JSON.
En este caso, tomamos una cadena incluida en una matriz y usamos $eval() para analizarla como una matriz. Esto suele utilizarse para enviar una matriz de órdenes.
Al hacer una prueba, ¿por qué no se recibe ningún parámetro de solicitud o se reciben parámetros incorrectos?
Al hacer pruebas, se debe utilizar en el generador de integraciones un valor de prueba que concuerde con los datos reales en el extremo para el parámetro de solicitud. Sin embargo, en una conversación activa, este parámetro viene de la conversación. Si no puede ver el parámetro y el valor en los datos de sesión durante la prueba, sería bueno asegurarse de que efectivamente lo está captando y guardando como el parámetro correcto en el diálogo.
Tenga en cuenta que los datos de sesión saneados no se mostrarán en los registros de conversaciones y quizás tenga que registrarlos temporalmente en un mensaje de agente IA para depurarlos.
¿Por qué se ve [Object, object]?
[Object, object] quiere decir que usted está tratando de obtener un objeto a modo de salida, pero el sistema no cuenta con una manera estructurada de mostrarlo. Para solucionar el problema, deberá convertir el objeto en un formato de cadena.
¿Se registran las llamadas exitosas?
No. Para cumplir las normas aplicables a la información de identificación personal (PII) y el RGPD, no registramos llamadas de datos exitosas. Sí registramos las que no tienen éxito para poder ofrecer más información sobre lo que falló durante la resolución de problemas, si es necesario.
Preguntas frecuentes sobre entornos
¿Por qué sería bueno contar con distintos entornos?
Es probable que prefiera evitar usar datos en tiempo real a la hora de probar la integración. Si tiene acceso a un sandbox, un área de preproducción o un entorno de desarrollo (le sugerimos que consulte a su equipo técnico o lea la documentación de API), podrá configurarlo desde el generador de integraciones.
Los entornos comparten parámetros de solicitud y salidas. Sin embargo, difieren en los detalles de extremos y autenticación. En el generador de diálogo se puede cambiar fácilmente de un entorno a otro en el nodo de API. Esto quiere decir que solo necesita crear un diálogo a la hora de hacer la prueba y luego puede cambiarse a un entorno de producción (cuando esté listo para lanzar la integración).
Preguntas frecuentes sobre tarjetas y carruseles
¿Es necesario establecer un número máximo de tarjetas?
Para la integración de Sunshine Conversations, hay un máximo de 10 tarjetas.
Recomendamos que se limite el número de tarjetas en un carrusel a 9 tarjetas, o bien 8 tarjetas y una tarjeta como opción alternativa. Una tarjeta de opción alternativa proporciona al usuario una manera de salir del carrusel (por ejemplo, si no ve lo que busca).
¿Es necesario mostrar imágenes en las tarjetas en un carrusel?
Sí. La imagen es un campo de datos requerido. Se puede rellenar el campo de imagen con un vínculo de imagen genérica siempre que no se requieran imágenes dinámicas (por ejemplo, una imagen por producto).
Preguntas frecuentes sobre la autenticación
¿Qué métodos de autenticación se pueden usar?
Puede usar los siguientes métodos de autenticación:
- Clave de API
- Token de portador
- Token de vencimiento
- Autenticación básica
- OAuth 2.0
- Lista autorizada de direcciones IP
Para comenzar con la autenticación para el generador de integraciones, consulte Requisitos técnicos para las integraciones.
¿Se puede crear una integración con un extremo incluido en la lista autorizada?
Sí. Para ello, debe agregar nuestras direcciones IP a su lista autorizada. Para ver una lista de las direcciones IP, consulte Permitir que las direcciones IP conecten agentes IA a su CRM.
¿Qué es una integración de “solo autenticación” y cuándo es necesaria?
Para informarse sobre las integraciones de “solo autenticación”, consulte Uso de la autorización personalizada con el generador de integraciones.
¿Se pueden implementar el límite de acceso y las limitaciones del flujo de datos?
No imponemos límites de acceso ni limitaciones del flujo de datos directamente. Los límites de acceso suelen ser impuestos por los sistemas o las API con los que nos integramos (p. ej., su sistema backend) y dependen de la configuración de su backend.
¿Qué pasa si una API demora más de 9 segundos en responder?
El espacio de trabajo de agentes IA impone un tiempo máximo de 9 segundos para las respuestas de API. Si su API no facilita una respuesta dentro de este tiempo, la solicitud agota el tiempo máximo y devuelve el error ECONNABORTED. Además, los tiempos de respuesta más largos pueden afectar negativamente la experiencia del usuario, ya que este puede sentirse frustrado al tener que esperar para recibir información.
Una manera de resolver esta situación es anticipando que determinadas respuestas de API van a tomar más de 9 segundos, en cuyo caso recomendamos hacer las llamadas de API necesarias al inicio de la conversación siempre que se pueda (por ejemplo, a raíz del evento que indica que se inició un chat) y guardar la información relevante en la sesión. Así, los datos estarán listos cuando se necesiten y se evitan retrasos durante el flujo de la conversación.