Integrar WhatsApp con Bitrix24

Paso a paso

1. 1

   Crea la instancia y obtén las claves en ZapZap API

   En el panel de ZapZap API, aprovisiona un número, lee el QR Code en WhatsApp y copia el instanceId, la x-api-key y el x-api-secret. Ese número es el que enviará los mensajes desde Bitrix24.

2. 2

   Abre los Webhooks de salida en Bitrix24

   En Bitrix24, ve a Aplicaciones, luego Desarrolladores (Developer resources) y haz clic en Outbound webhook. Selecciona el evento deseado, por ejemplo ONCRMDEALUPDATE u ONCRMLEADADD, para que se dispare cuando el negocio cambie de etapa.

3. 3

   Apunta el webhook a una herramienta de automatización

   En el campo Handler URL, indica la URL de un servicio intermedio (como Make, n8n o una función propia) que recibirá el evento de Bitrix24 y traducirá los datos del negocio a la llamada de ZapZap API.

4. 4

   Arma la llamada a ZapZap API

   En la herramienta de automatización, configura una solicitud HTTP POST a ZapZap API usando el teléfono del contacto del negocio y el texto del mensaje. Envía los encabezados x-api-key y x-api-secret para autenticar.

5. 5

   Prueba con un negocio real y monitorea

   Mueve un negocio de prueba en el embudo de Bitrix24, confirma que el mensaje llegó a WhatsApp y sigue los envíos. Usa los Webhooks de entrada (Inbound webhook) de Bitrix24 si quieres registrar las respuestas de vuelta en el CRM.

// Ejemplo ILUSTRATIVO: envío de WhatsApp al cambiar de etapa en Bitrix24
// Consulta los endpoints y campos reales en https://api.zapzapapi.com/llms.txt

const res = await fetch(
  "https://api.zapzapapi.com/api/v1/{instanceId}/send/text",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.ZAPZAP_API_KEY,
      "x-api-secret": process.env.ZAPZAP_API_SECRET,
    },
    body: JSON.stringify({
      number: "5511999999999",
      text: "¡Hola! Recibimos tu contacto y ya estamos atendiendo tu solicitud.",
    }),
  }
);

const data = await res.json();
console.log(data);