Webhook / Conexión HTTP
La Conexión HTTP (webhook) le permite al agente comunicarse con cualquier API externa: consultar datos propios o disparar automatizaciones en herramientas como Zapier o n8n.
Es la única herramienta que podés agregar varias veces en un mismo agente, cada una con un nombre y propósito distinto (por ejemplo, "Consultar stock" y "Notificar pedido nuevo").
Qué necesitás
La URL del endpoint que querés llamar. El resto de la configuración depende de cómo esté armada esa API.
Cómo configurarla
- Agregá la herramienta Conexión HTTP en Acciones.
- Escribí una descripción para el agente: cuándo debe usar esta herramienta (ej. "Consulta el estado de un pedido cuando el usuario pregunta por su envío").
- Completá la URL del endpoint y el método HTTP (POST, GET, PUT o PATCH).
- Elegí el tipo de autenticación: ninguna, Bearer token, o API key en un header (con el nombre de header que necesites).
- Agregá headers adicionales si tu API los requiere.
- Opcionalmente, definí un body template en JSON con placeholders.
Identidad del remitente
Podés activar el envío de la identidad verificada de quien escribe (email, teléfono, nombre, ID de canal) como parte del request, usando variables como {{remitente.email}} o {{remitente.telefono}}. Estos datos los agrega EMMIA de forma segura desde el canal — el usuario no puede falsificarlos. Los datos que el usuario declara por chat (cuando el agente los pide) no son verificables de la misma forma.
Nota: si activás "pedir si falta" para un dato de identidad, el agente se lo va a preguntar directamente al usuario cuando el canal no lo entregue verificado.
Qué puede hacer el agente con esta herramienta
Ejecuta el request HTTP configurado con los parámetros que el agente recolecte de la conversación, y usa la respuesta para continuar la conversación o confirmar una acción al usuario.