Montar un asistente para tus usuarios con acciones y flujos
Un asistente dentro de tu producto que resuelve dudas y hace cosas de la cuenta de cada usuario con tu API: identidad, acciones, flujos, WhatsApp y pruebas.
Este caso monta un asistente dentro de tu producto: tus usuarios le escriben desde el chat, o por WhatsApp, y además de resolver dudas hace cosas de su cuenta, como consultar un estado o pedir un cambio, llamando a tu API.
Sirve igual si lo montas tú desde las pantallas o si se lo pides a tu propio asistente de IA conectado por MCP. En los dos casos, las decisiones son las mismas.
1. Que Intake sepa quién escribe
Es lo primero, porque todo lo demás depende de ello. Si el asistente va a tocar datos de la cuenta, tiene que saber de quién es la cuenta sin preguntarlo.
Instala el chat para usuarios con sesión iniciada, activa la verificación de identidad y firma el token en tu servidor. Lo que la página ya sabe del usuario, como su rol o la cuenta que tiene abierta, mándalo como atributo dentro del token, marcado como «Solo actualizaciones verificadas». Está todo en «Identificar a tus usuarios en el chat: el código, el token y los atributos».
Sin firma, Intake no da por probada la identidad: tus acciones no recibirán el correo ni el identificador del usuario, y el asistente no podrá hacer nada de su cuenta. Si todavía usas la firma de antes (userHash), ten en cuenta que solo firma el identificador: el correo va sin firmar. Pasa al token, que lo firma todo.
2. Prepara tu API para el asistente
Tu API es la que decide qué puede ver y hacer cada usuario. El asistente solo pide.
- Un punto por cosa: consultar el estado, ver la configuración, pedir un cambio. Pequeños y concretos, con lo justo en la respuesta.
- Identifica al usuario con lo que manda Intake:
{{personId}}o{{personEmail}}en una cabecera. Solo llevan valor con la identidad probada. Con el token, los dos están firmados; con la firma de antes, solo el identificador. - Comprueba que la llamada viene de Intake con una clave secreta en otra cabecera.
- Responde con un JSON corto y con un mensaje que se pueda leer tal cual. Si algo falla, devuélvelo con un estado que no sea 2xx, o con
"ok": falsey unerrorcon un código, como"error": "missing_fields". Intake lo cuenta como fallo y el asistente no lo da por hecho. - Contesta rápido. El agente espera 8 segundos de serie, y se puede subir hasta 30.
Para los cambios, mejor en dos pasos: uno que enseña lo que va a cambiar y otro que lo aplica. Así el asistente puede enseñarle el resultado al usuario y pedirle que confirme antes de tocar nada.
3. Crea las acciones
Una acción por cada punto de tu API, en Agente IA › Acciones. Lo que más importa es «Cuándo usarla»: cuándo sí y cuándo no, con condiciones claras. El resto está en «Crear una acción personalizada».
Para lo delicado, como borrar, cobrar o devolver dinero, usa «Requiere aprobación humana», y revisa «Repetir esta acción» para que un reintento no haga dos veces lo mismo.
4. Acciones solas o dentro de un flujo
Lo normal es dejar que el agente use las acciones directamente: conversa con el usuario, pregunta lo que falta, llama a la acción y le cuenta el resultado.
Un flujo de intención tiene sentido cuando quieres que algo pase siempre igual: un formulario con campos fijos, un mensaje que no cambia, una etiqueta o una nota interna, o pasar la conversación a un equipo. Ten en cuenta tres cosas:
- El agente tiene a mano todas las acciones activas. Si un flujo usa una acción, el agente también puede llamarla por su cuenta y saltarse el flujo. Si quieres que pase por el flujo, escríbelo en «Cuándo usarla» de la acción.
- Un flujo de intención corre una vez por conversación.
- Si el flujo manda un mensaje, ese es la respuesta del turno: el agente no añade otro.
No le pongas a un flujo el mismo nombre que a una acción. El agente los ve juntos y le cuesta distinguirlos.
5. Cuidado con el flujo de primer mensaje
Un flujo «Cuando el cliente envía su primer mensaje» corre antes de que conteste el agente, y el cliente espera lo que tarde. Si llama a tu API para saber quién es el usuario, esa espera se suma a cada conversación nueva.
En el chat de la web, eso lo resuelven los atributos firmados. Si aun así lo necesitas, limítalo en «A quién alcanza» a los canales donde haga falta, como WhatsApp, donde no hay página que diga quién escribe.
6. WhatsApp
En WhatsApp lo que Intake da por probado es el número. Para unirlo a un usuario de tu producto, haz una comprobación tuya: dos acciones, una que manda un código a su correo y otra que lo verifica cuando el usuario lo escribe en el chat. A partir de ahí, tu API reconoce ese número.
Recuerda que si el número lo comparten varios, quien lo tenga en la mano actúa como su dueño.
7. Las reglas del asistente
En Agente IA › Guía, escribe como directrices lo que tiene que hacer siempre: qué datos pedir antes de un cambio, qué casos pasar a una persona, qué no contar nunca. Las directrices se aplican desde el siguiente mensaje.
Si ya le das el resultado de una acción en el contexto, por ejemplo con un flujo que pregunta quién es el usuario, dile que no la vuelva a llamar.
8. Pruébalo de verdad
- Cada acción, con «Probar API» antes de guardarla.
- El asistente entero, escribiendo tú desde el chat de tu producto con un usuario de prueba.
- Lo que hizo, en Agente IA › Acciones › Ejecuciones, en el Historial de cada flujo y en la traza de cada respuesta de la IA.
Hazlo antes de activarlo para todos: lo que se activa llega a tus clientes en cuanto se guarda.
Los errores que más se repiten
- La rama de un flujo nunca se cumple. Los datos que devuelve una acción se guardan con el nombre de «Guardar como» delante y en minúsculas: si guardas como
cuenta, un campoisRootescuenta_isroot. Mira en el Historial del flujo qué datos guardó la acción. cuenta_okno dice lo que esperabas. Es cierto si tu API contestó 2xx, salvo que tu JSON traiga su propio campook: entonces vale lo que diga ese campo.- El flujo se para en un mensaje. Si un mensaje es solo una variable y esa variable llega vacía, el paso falla y el flujo no sigue. Comprueba antes con una rama que la acción fue bien.
- La conversación pasa al equipo a mitad de un pedido. El agente tiene un máximo de respuestas seguidas, 20 de serie, en «Cuántas respuestas seguidas puede dar», en la configuración de escalado. Súbelo si tus conversaciones son largas.
- El agente cita información vieja. Si cambias un documento del conocimiento, edítalo: no subas una copia nueva dejando la antigua.
¿Te ha resultado útil?
