Cómo automatizar WhatsApp con una API (evento → plantilla)

Si ya conectaste WhatsApp a tu negocio, el siguiente paso es que se dispare solo. Aprender cómo automatizar WhatsApp con una API significa que, en cuanto un sistema externo registra un evento —un lead que llena un formulario, una compra en tu tienda, un ticket que cambia de etapa en tu CRM—, Blind Agents envíe automáticamente un mensaje de WhatsApp con una plantilla aprobada, cree el contacto y deje a un agente de IA listo para continuar. En esta guía verás el flujo completo: qué necesitas, cómo hacer el POST y cómo configurarlo paso a paso.

En lugar de que alguien copie y pegue números o escriba mensajes a mano, tu sistema le avisa a Blind Agents mediante una llamada a la API cada vez que ocurre algo importante. Blind Agents recibe ese evento, crea o actualiza el contacto y su empresa, y dispara el canal que configuraste. Cuando el canal es WhatsApp, el disparo envía una plantilla aprobada al número del contacto y abre la conversación.

• Un número conectado a WhatsApp Business por API (no la app del teléfono).
• Al menos una plantilla de WhatsApp aprobada para el primer mensaje: los mensajes que inicia el negocio requieren plantilla.
• La API-key de tu organización, que viaja en el header BLIND-AGENTS-API-KEY.
• Un sistema externo capaz de hacer una petición HTTP POST: un formulario web, tu CRM, o un conector como Zapier o Make.

El recorrido tiene tres momentos claros:

1. Tu sistema detecta el evento (por ejemplo, un lead nuevo) y hace un POST a la API de Blind Agents con los datos del contacto y su empresa.
2. Blind Agents autentica la petición con tu API-key, crea o actualiza el contacto y la empresa, y busca la automatización que coincide con ese evento.
3. La automatización envía la plantilla de WhatsApp al número del contacto, abre una conversación y deja al agente y modo que elegiste listos para continuar cuando la persona responda.

Tu sistema solo necesita enviar una petición HTTP. El endpoint y la autenticación son estos: haces un POST a https://api.blindagents.com/v1/events con el header BLIND-AGENTS-API-KEY (tu API-key) y un cuerpo en formato JSON con el evento y los datos del contacto.

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

— Cuerpo de ejemplo del POST a /v1/events

• event: el nombre del evento (por ejemplo, new_lead). Es lo que la automatización usa para saber qué disparar.
• contact: nombre, email y teléfono del contacto. El teléfono en formato internacional (con +) es el número que recibe el WhatsApp.
• company: el nombre de la empresa del contacto; Blind Agents la crea o la vincula automáticamente.

Toda la configuración vive en la plataforma, sin escribir código del lado de Blind Agents:

1. Abre la sección Automatizaciones y pulsa nuevo.
2. En Detalles, dale un nombre a la automatización y elige el tipo de disparador por evento API.
3. Define el nombre del evento (el mismo que enviará tu sistema, por ejemplo new_lead) para que coincida con el POST.
4. En Disparador y mensaje, elige WhatsApp como canal y selecciona la plantilla aprobada que se enviará como primer mensaje.
5. En Agente y entrega, elige el agente de IA y el modo —automático, copiloto o manual— que continuará la conversación cuando el contacto responda.
6. Guarda la automatización y copia la API-key de tu organización.
7. Conecta tu sistema externo: configura el formulario, CRM, Zapier o Make para que haga el POST al endpoint con el header BLIND-AGENTS-API-KEY cuando ocurra el evento.
8. Haz una prueba enviando un evento real y confirma en el Monitor que se disparó y se entregó.

Cualquier evento que hoy dependa de que alguien reaccione a tiempo es candidato a automatizarse:

• Lead nuevo desde tu formulario web: en segundos recibe un WhatsApp de bienvenida y el agente empieza a calificar.
• Compra o carrito en tu ecommerce: confirma el pedido o recupera el carrito abandonado.
• Ticket o cambio de etapa en tu CRM: dispara un seguimiento sin que nadie tenga que acordarse.
• Registro a un evento o demo: envía el recordatorio y los datos de acceso en el momento.

Cada automatización reporta sus métricas en el Monitor, para que sepas si el disparo está funcionando:

• Disparadas: cuántos eventos coincidieron y activaron la automatización.
• Enviadas y entregadas: cuántos WhatsApp salieron y llegaron al teléfono.
• Leídas (Visto): cuántos contactos abrieron el mensaje.
• Tasa de respuesta: cuántos contestaron, la señal de que la conversación realmente arrancó.

El mismo evento puede disparar otro canal si te conviene: un correo (con plantilla o asunto y cuerpo) o incluso una llamada con un agente de IA y un guion. WhatsApp es la vía más directa cuando quieres una respuesta rápida y una conversación que siga en el mismo hilo.

El resultado es contundente: con la automatización por evento API, el tiempo entre 'pasó algo' y 'el contacto ya tiene un WhatsApp' baja de horas a segundos, y sin que nadie tenga que estar mirando la pantalla.