Contactar leads automáticamente desde un formulario con API

Si ya tienes un formulario web, una landing o un CRM que captura leads, puedes contactarlos automáticamente en segundos en lugar de horas. La idea es simple: cada vez que entra un lead, tu sistema hace un POST a la API de Blind Agents, la plataforma crea o actualiza el contacto y su empresa, y dispara al instante el canal que elijas —un email, un WhatsApp o una llamada con un agente de IA—. En esta guía te muestro, paso a paso, cómo contactar leads automáticamente desde un formulario con API.

La mayoría de los formularios terminan en una bandeja de entrada o en una hoja de cálculo que alguien revisa cuando puede. Para cuando una persona ve el lead y responde, quien llenó el formulario ya está hablando con otra empresa. La ventaja competitiva no está en captar más leads, sino en ser el primero en responder mientras el interés sigue caliente.

Con una automatización por evento API, ese primer contacto deja de depender de que alguien esté disponible. El disparo es automático y ocurre en el mismo momento en que se envía el formulario, sin importar la hora ni el día.

• Respuesta en segundos, no en horas: el lead recibe tu mensaje mientras todavía tiene tu marca en la cabeza.
• Sin trabajo manual: nadie tiene que copiar datos ni recordar hacer seguimiento.
• Multicanal: el mismo evento puede terminar en un email, un WhatsApp o una llamada de voz, según lo que mejor funcione para ese lead.
• Todo queda registrado: el contacto, su empresa y la conversación viven en la plataforma desde el primer segundo.

El mecanismo tiene tres piezas. Primero, un sistema externo —tu formulario, tu CRM, Zapier o Make— envía un POST al endpoint de eventos con los datos del lead. Segundo, Blind Agents autentica la petición con la API-key de tu organización y crea o actualiza el contacto (y la empresa asociada). Tercero, dispara el canal que hayas configurado en la automatización.

El endpoint es POST https://api.blindagents.com/v1/events y la autenticación va en el header BLIND-AGENTS-API-KEY con la clave de tu organización. Un cuerpo típico se ve así: {"event":"new_lead","contact":{"name":"Ada","email":"ada@acme.com","phone":"+57..."},"company":{"name":"ACME"}}.

El objeto contact acepta nombre, email y teléfono. Con el email podrás disparar un email; con el teléfono, un WhatsApp o una llamada. Envía los datos que tengas: cuantos más campos incluyas, más completo llega el contacto a la plataforma y mejor puede continuar la conversación el agente.

• Una organización en Blind Agents con al menos un canal listo: un remitente de email, un número de WhatsApp o un número de voz, según cómo quieras contactar.
• La API-key de tu organización para autenticar las peticiones.
• Un formulario o CRM capaz de enviar un webhook / POST (directo o vía Zapier o Make).
• Un agente de IA configurado para continuar la conversación cuando el lead responda.

La automatización se crea desde la plataforma; el POST solo la dispara. Sigue estos pasos:

1. Entra a la sección Automatizaciones y pulsa Nueva automatización.
2. En Detalles, ponle un nombre claro (por ejemplo, «Lead de formulario») y elige el tipo de disparador por evento API.
3. En Disparador y mensaje, indica el nombre del evento que enviarás (por ejemplo, new_lead) y redacta el mensaje inicial según el canal: para email, una plantilla o un asunto y cuerpo; para WhatsApp, una plantilla aprobada; para llamada, el guion de apertura.
4. En Agente y entrega, elige el canal de salida (email, WhatsApp o llamada), el agente de IA que atenderá y el modo de operación (automático, copiloto o manual).
5. Guarda la automatización. Queda escuchando los eventos que tu sistema envíe con ese nombre.

• Email: envías una plantilla guardada o defines asunto y cuerpo directamente. Ideal cuando el lead dejó su correo.
• WhatsApp: se envía una plantilla aprobada para iniciar la conversación. Requiere un número de WhatsApp conectado.
• Llamada: un agente de IA llama al lead desde un número de voz con el guion que definas y conversa en tiempo real.

Si tu formulario permite webhooks, apúntalo directamente al endpoint de eventos. Si no, Zapier o Make hacen de puente: creas un Zap o escenario que se dispara con cada envío del formulario y añades un paso de «Webhooks → POST» hacia /v1/events.

1. En tu herramienta (Zapier, Make o el propio CRM), crea una acción de tipo POST hacia https://api.blindagents.com/v1/events.
2. Añade el header BLIND-AGENTS-API-KEY con la API-key de tu organización.
3. Mapea los campos del formulario al cuerpo JSON: name, email y phone dentro de contact, y el nombre de la empresa dentro de company.
4. Fija el campo event con el mismo nombre que configuraste en la automatización (por ejemplo, new_lead).
5. Envía un lead de prueba y verifica que el contacto aparece y que el mensaje sale.

El disparo inicial es solo el comienzo. Cuando el lead responde —contesta el email, el WhatsApp o habla en la llamada—, el agente de IA que asignaste continúa la conversación. En modo automático responde solo; en copiloto sugiere respuestas para que tu equipo apruebe; en manual deja la conversación lista para que una persona la tome. El contacto y su empresa ya están creados, así que todo el historial queda en un solo lugar.

Cada automatización reporta sus métricas en el Monitor: cuántos eventos se recibieron, cuántos mensajes se dispararon, cuántos se entregaron y —según el canal— cuántos se leyeron o se contestaron. Así sabes si el primer contacto automático está funcionando y puedes ajustar el mensaje, el canal o el agente sin tocar tu formulario.