Webhook para enviar WhatsApp desde un formulario (guía)

¿Quieres que, en cuanto alguien llena tu formulario, le llegue un WhatsApp al instante? La forma más directa de lograrlo es con un webhook para enviar WhatsApp desde un formulario: tu formulario hace una llamada HTTP (un POST) a la API de Blind Agents, nosotros creamos el contacto y disparamos el mensaje por WhatsApp en segundos. En esta guía configuras la automatización por evento API paso a paso, con el ejemplo del cuerpo (body) y el header de la API-key incluidos.

La idea es sencilla: cada vez que se envía tu formulario, un evento viaja hasta Blind Agents y desencadena una acción. Sin sondeos, sin exportar a mano, sin esperar una sincronización nocturna: el mensaje sale mientras el lead sigue caliente y pensando en ti. El recorrido es este:

• Alguien completa y envía tu formulario web (o se crea un lead en tu CRM).
• Tu formulario, tu backend o una herramienta como Zapier o Make hace un POST al endpoint de eventos de Blind Agents, autenticado con la API-key de tu organización.
• Blind Agents crea o actualiza el contacto y su empresa con los datos que enviaste.
• La automatización dispara el canal configurado —en este caso WhatsApp— y envía tu plantilla aprobada al teléfono del contacto.
• Si asignaste un agente de IA, este continúa la conversación en cuanto el contacto responde, en modo automático, copiloto o manual.

• Una cuenta de Blind Agents con un número de WhatsApp conectado.
• Al menos una plantilla de WhatsApp aprobada (por ejemplo, un saludo de bienvenida con el nombre del contacto).
• La API-key de tu organización, que autentica cada POST.
• Un formulario, CRM o automatizador (Zapier, Make) capaz de hacer una petición HTTP POST.

Todo se administra en la sección Automatizaciones. Vas a crear una automatización cuyo disparador es un evento de la API.

1. Entra a Automatizaciones y pulsa Nuevo.
2. En Detalles, elige el disparador Evento API y ponle un nombre reconocible, como "Lead del formulario web".
3. En Disparador y mensaje, selecciona el canal WhatsApp y elige tu plantilla aprobada. Mapea las variables de la plantilla a los datos del contacto que vas a enviar (nombre, empresa, etc.).
4. En Agente y entrega, escoge el número de WhatsApp de salida y, si lo deseas, asigna un agente de IA y su modo (automático, copiloto o manual) para que retome la conversación cuando el contacto responda.
5. Guarda la automatización. A partir de ahora, cada evento que reciba disparará ese WhatsApp.

La API-key es la credencial que identifica a tu organización en cada llamada. Se envía en el header BLIND-AGENTS-API-KEY. Trátala como una contraseña: guárdala en tu servidor o en tu herramienta no-code, nunca en el código que corre en el navegador del visitante.

Cuando alguien envía el formulario, tu backend (o Zapier/Make) hace un POST al endpoint de eventos con el header de la API-key. Así se ve la petición completa:

“curl -X POST https://api.blindagents.com/v1/events -H "BLIND-AGENTS-API-KEY: TU_API_KEY" -H "Content-Type: application/json" -d '{"event":"new_lead","contact":{"name":"Ada","email":"ada@acme.com","phone":"+57..."},"company":{"name":"ACME"}}'”

El cuerpo (body) lleva el nombre del evento y los datos del contacto y su empresa. Este es el ejemplo mínimo:

“{"event":"new_lead","contact":{"name":"Ada","email":"ada@acme.com","phone":"+57..."},"company":{"name":"ACME"}}”

• event: el nombre del evento que identifica la automatización, por ejemplo new_lead.
• contact.name: el nombre del contacto, útil para personalizar las variables de la plantilla.
• contact.email y contact.phone: sirven para reconocer al contacto y evitar duplicados; el teléfono es obligatorio para poder enviar WhatsApp.
• company.name: la empresa a la que se asocia el contacto, que Blind Agents crea o actualiza.

Con eso, Blind Agents crea o actualiza el contacto (lo reconoce por su email o teléfono), registra o actualiza la empresa ACME y dispara el WhatsApp usando tu plantilla aprobada.

1. Lanza un evento de prueba con el comando de arriba, cambiando los datos por los de un contacto tuyo real.
2. Verifica en Blind Agents que el contacto (y su empresa) aparecen creados o actualizados.
3. Confirma que el WhatsApp salió y se entregó al teléfono de prueba.
4. Abre el Monitor para ver cuántos eventos se dispararon y el estado de entrega de cada mensaje.

• Respuesta no autorizada: casi siempre es la API-key mal copiada o enviada en un header distinto a BLIND-AGENTS-API-KEY.
• El WhatsApp no llega: revisa que el teléfono tenga código de país (+…) y que la plantilla esté aprobada.
• Variables vacías en el mensaje: asegúrate de mapear cada variable de la plantilla a un campo del body (por ejemplo, contact.name).
• API-key expuesta: nunca hagas el POST desde JavaScript del lado del navegador; hazlo desde tu servidor o desde Zapier/Make.

Si tu formulario no puede hacer un POST por sí mismo, no necesitas programar. Herramientas como Zapier o Make traen un paso de "Webhook" listo: pones la URL del endpoint, agregas el header BLIND-AGENTS-API-KEY y armas el body con los campos del formulario. El resultado es el mismo webhook para enviar WhatsApp desde un formulario, montado en minutos y sin código.