Configuración de webhooks de alertas en tiempo real para Agentes IA avanzada

¿Qué plan tengo?

Complemento

Agentes IA - Avanzado

Esta función solo está disponible para los clientes de Enterprise. Comuníquese con su CSM si desea activarlo.

En este artículo se explica lo siguiente:

• Eventos que disparan alertas en tiempo real
• Configuración de webhook

Eventos que disparan alertas en tiempo real

Con el webhook de alertas en tiempo real, puede recibir notificaciones en tiempo real cuando se activan eventos de su interés. Estos eventos pueden ocurrir en cualquier parte de nuestro sistema, pero por el momento se limitan a los cinco que se enumeran a continuación: 

1. Falló una derivación

2. Falló una acción

3. Se envió un mensaje de error técnico genérico en el chat

4. Una integración de backend personalizada falló; en este caso, la integración de backend exacta se especifica en el objeto data.

5. Pruebas: se puede disparar un evento de prueba desde los Agentes IA – Avanzado para que los desarrolladores puedan probar e implementar el uso del webhook sin tener que esperar a uno de los disparadores.

Tan pronto como se dispara uno de los eventos, enviamos una solicitud con el siguiente parámetro al URL del webhook:

Nombre	Tipo	Descripción
botName	cadena	Nombre del agente IA que activó el evento
evento	cadena	Los cinco tipos de eventos diferentes
conversationId	cadena	ID de conversación única
platformConversationId	cadena	ID de conversación específica de la plataforma
data	objeto	Metadatos, usados principalmente por el evento de integración de backend

Para el evento de integración de backend personalizado, enriqueceremos el objeto de datos con el siguiente parámetro:

Nombre	Tipo	Descripción
botId	cadena	Una combinación de números y letras de 24 dígitos que es única para cada agente IA. Más información.
conversationId	cadena	ID de conversación única
conversationLink	cadena	Vincular a la conversación especificada en los registros de conversación
httpStatus	número	Tipo de estado del error
endpointUrl	cadena	URL a la que se dirigió la integración de backend

Configuración de webhook

Se puede acceder a la configuración del webhook en la configuración del agente IA > General > Webhook. Solo lo pueden ver los clientes empresariales.

Para configurarlo, siga las instrucciones a continuación:

1. En Agentes IA – Avanzado, vaya a Configuración de agente IA > General > Webhook

2. Copie y pegue el URL del webhook de la herramienta de datos en el campo definido. Tenga en cuenta que solo permitimos direcciones URL con https.

3. Haga clic en Mostrar token y use el token de autenticación para recuperar correctamente los mensajes de alerta en la herramienta de datos.

4. Haga clic en Usar webhook para hacer seguimiento del rendimiento de los agente IA para activar la funcionalidad.

5. Guarde la configuración actualizada del agente IA. El botón de webhook de prueba debería estar activado ahora.

6. Haga clic en Probar webhook para enviar un evento de prueba al URL que especificó como el URL del webhook. El último paso es opcional pero recomendado.