Deja que tu IA de soporte haga cosas por los clientes con acciones por webhook
Por Termi3 min de lectura
Muchas preguntas de soporte necesitan que se haga algo: revisar un pedido, lanzar un backup, reenviar una clave. Una IA que solo responde se las pasa a una persona. Con las acciones, FiveBot llama a tu propio endpoint HTTPS para hacerlo, en el chat web Hollo y en los tickets de Discord, y responde con lo que devolvió tu servidor.
Un ejemplo de FiveDock
FiveDock, una herramienta de backups y hosting para servidores FiveM, usa FiveBot como chat en su web. Un usuario con la sesión iniciada escribe "haz una copia de mi servidor". La IA ya sabe qué servidores tiene ese usuario, porque FiveDock se los pasa al abrir el chat, y pregunta cuál si hay más de uno. Luego muestra una tarjeta con el nombre del servidor y un botón Ejecutar. Con una pulsación, el endpoint de FiveDock inicia el backup y el chat avisa de que está en marcha.
Lo mismo sirve para "¿mi servidor está en línea?" o "recupera el inventario de Kowalski de ayer".
Cómo se define una acción
En Ajustes, IA, Acciones puedes añadir hasta 10. Cada una tiene:
- un nombre y una frase que dice cuándo usarla;
- la dirección HTTPS a la que llama FiveBot;
- hasta cinco campos con tipo, como un nombre de servidor o un número de horas, que la IA rellena a partir de la conversación;
- Ejecutar sin preguntar, para lecturas seguras como comprobar un estado;
- un interruptor para activarla o desactivarla.
Enviar prueba lanza una llamada de ejemplo y muestra el código de estado y cuánto tardó. La página también muestra las últimas 10 llamadas.
Quién puede lanzarlas
Las acciones solo se ejecutan para personas que FiveBot puede identificar: un visitante que tu web firmó al abrir el chat, o la persona que abrió un ticket de Discord. Los visitantes anónimos y el email reciben respuestas de tu base de conocimiento y nada más.
La IA comprueba los campos con los tipos que definiste. Si falta un valor, hace una pregunta corta y nombra las opciones. Salvo que la acción se ejecute sin preguntar, el cliente recibe una tarjeta en el chat, o botones en Discord, con Ejecutar y Cancelar.
Qué recibe tu endpoint
Un POST con la acción, sus campos, el usuario y el ticket, firmado con el secreto de firma de tu espacio de trabajo:
FiveBot-Signature: t=<unix time>,v1=<HMAC-SHA256 of t.body>
La página de ajustes tiene un fragmento de Node que comprueba la firma. FiveBot resuelve primero la dirección y rechaza redes privadas y locales, no sigue redirecciones, espera 10 segundos como máximo y lee hasta 16 KB de la respuesta. La respuesta se trata como datos, así que el texto que contenga no puede darle instrucciones nuevas a la IA.
Coste
Cada llamada cuesta un crédito de IA además de la respuesta y aparece como Acciones en el registro de créditos. Cada llamada queda registrada con su resultado.
Preguntas frecuentes
¿Qué plan necesito?
Pro o Network. Los precios están en fivebot.ai/pricing.
¿Puede un cliente engañar a la IA para que actúe en nombre de otro?
FiveBot toma el usuario de la firma que creó tu web o de la cuenta de Discord que abrió el ticket, y tu endpoint recibe esa identidad en cada llamada. Los datos que parecen un intento de darle instrucciones a la IA se descartan.
¿Cómo firma mi web a un visitante?
Tu backend firma al visitante con el secreto de identidad de Hollo y pasa el resultado a FiveBot.identify. Más sobre Hollo.
¿En qué se diferencia de las acciones del asistente?
Las acciones del asistente son para ti y tu staff y lanzan eventos o comandos en tu servidor FiveM. Las acciones por webhook son para tus clientes y llaman a cualquier endpoint HTTPS que tengas. Acciones del asistente.