Integración por webhook
Integrar WhatsApp con ActiveCampaign
ActiveCampaign es una plataforma de automatización de marketing y CRM que orquesta los recorridos de los contactos mediante las Automations. La integración con ZapZap API permite enviar mensajes de WhatsApp como un paso dentro de esas automatizaciones, usando la acción nativa de Webhook. ZapZap API es una API de WhatsApp no oficial basada en instancias: conectas un número real mediante QR Code y empiezas a enviar mensajes de forma programática. La autenticación usa los encabezados x-api-key y x-api-secret, y el cobro es de R$15 por número activo al mes, prepago, con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.
Por qué conectar
Una clínica de estética capta leads con un formulario de ActiveCampaign. Al entrar en la lista, el contacto dispara una Automation que envía un correo de bienvenida y, en el mismo flujo, un WhatsApp confirmando el interés y ofreciendo un horario. Si el lead no responde en 2 días, la automatización envía un recordatorio por WhatsApp. Como el envío ocurre dentro del propio recorrido de ActiveCampaign, marketing y atención quedan sincronizados sin trabajo manual, y el equipo comercial recibe el lead ya calentado por el canal que más usa.
Paso a paso
- 1
Conecta tu número en ZapZap API
En el panel de ZapZap API, crea una instancia y lee el QR Code con el WhatsApp del número que hará los envíos. Guarda el instanceId, la x-api-key y el x-api-secret generados para la instancia.
- 2
Abre la Automation en ActiveCampaign
En el menú lateral, ve a Automations y crea una nueva automatización o edita una existente. Define el disparador, por ejemplo Subscribes to a list o Submits a form, para decidir cuándo se enviará el WhatsApp.
- 3
Añade la acción de Webhook
Dentro del flujo, haz clic en el signo más para añadir una acción, elige la categoría CX Apps (o Conditions and Workflow) y selecciona Webhook. Es esta acción la que envía los datos del contacto fuera de ActiveCampaign.
- 4
Apunta el webhook a tu endpoint de envío
Pega la URL de tu endpoint intermedio que recibe el contacto de ActiveCampaign y llama a ZapZap API. ActiveCampaign envía campos del contacto como teléfono y nombre; tu endpoint arma el body con number y text y hace la llamada autenticada a ZapZap API.
- 5
Activa y prueba la automatización
Guarda, pon la automatización en Active y ejecuta un contacto de prueba con un número real. Confirma que el mensaje llegue a WhatsApp y ajusta el texto, los retrasos y las condiciones del flujo según el recorrido deseado.
Ejemplo
// Ejemplo ILUSTRATIVO: endpoint intermedio que recibe el webhook
// de ActiveCampaign y dispara el WhatsApp mediante ZapZap API.
// Consulta la referencia real en https://api.zapzapapi.com/llms.txt
const instanceId = "TU_INSTANCE_ID";
// datos que vienen del webhook de ActiveCampaign (contacto)
const contacto = { telefono: "5511999999999", nombre: "María" };
await fetch(`https://api.zapzapapi.com/api/v1/${instanceId}/send/text`, {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": "TU_API_KEY",
"x-api-secret": "TU_API_SECRET"
},
body: JSON.stringify({
number: contacto.telefono,
text: `Hola ${contacto.nombre}, recibimos tu contacto y enseguida te atendemos.`
})
});Ilustrativo. Los campos y endpoints exactos están en la documentación.
Preguntas frecuentes
¿Necesito un servidor intermedio entre ActiveCampaign y ZapZap API?
Sí, en la mayoría de los casos. La acción de Webhook de ActiveCampaign envía los campos del contacto en su propio formato, así que usas un endpoint propio o una herramienta como Make o n8n para transformar esos datos en el body que espera ZapZap API y añadir los encabezados de autenticación.
¿Cuánto cuesta enviar WhatsApp desde ActiveCampaign?
ZapZap API cobra R$15 por número activo al mes, con modelo prepago, y recibes un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente. El plan de ActiveCampaign tiene un costo aparte. No hay cobro por mensaje en ZapZap API.
¿Qué datos del contacto puedo usar en el mensaje?
La acción de Webhook de ActiveCampaign envía los campos del contacto, incluidos teléfono, nombre, correo y campos personalizados. Usas esos valores en tu endpoint para personalizar el texto antes de llamar a ZapZap API.
¿Es la API oficial de WhatsApp?
No. ZapZap API es una solución no oficial basada en instancias, en la que conectas un número real mediante QR Code. Por eso se recomienda enviar mensajes relevantes, respetar el opt-in de los contactos y calentar el número gradualmente.
¿Dónde encuentro la referencia técnica de los endpoints?
La documentación para máquinas y la lista de endpoints están en https://api.zapzapapi.com/llms.txt. Úsala como fuente para armar las llamadas de envío con la base https://api.zapzapapi.com.
Empieza ahora
Crea tu cuenta, conecta un número en minutos y prueba la API con calentamiento y anti-bloqueo. R$15 por número activo/mes, prepago, sin permanencia.
