Integrar WhatsApp con Kommo

Paso a paso

1. 1

   Conectar el número en ZapZap API

   Crea tu cuenta en api.zapzapapi.com, agrega una instancia, lee el código QR con el WhatsApp que hará los envíos y copia las credenciales x-api-key y x-api-secret generadas para esa instancia.

2. 2

   Preparar el embudo en Kommo

   En Kommo, abre Leads y ajusta las etapas de tu pipeline en Configurar (ícono de engranaje del embudo). Define en qué etapas se debe disparar WhatsApp, por ejemplo Nuevo contacto, Propuesta enviada y Seguimiento.

3. 3

   Crear el Salesbot

   Ve a Leads, abre el panel Digital Pipeline y haz clic en agregar un disparador en la etapa deseada. Elige la acción Bots y crea un nuevo Salesbot en el editor visual.

4. 4

   Agregar la acción de webhook

   Dentro del Salesbot, agrega el paso Enviar webhook (Send webhook). Apunta la URL a tu endpoint intermedio, que recibe los datos del lead (nombre, teléfono, etapa) y llama a ZapZap API para enviar el texto.

5. 5

   Activar el disparador y probar

   Guarda el Salesbot, define el disparador para que se ejecute cuando el lead entre en la etapa y actívalo. Mueve un lead de prueba a esa etapa y confirma que el mensaje llega a WhatsApp y que el registro aparece en la tarjeta del lead.

// Ejemplo ILUSTRATIVO: tu endpoint recibe el webhook del Salesbot (Kommo)
// y envía el WhatsApp por ZapZap API. Revisa los campos exactos 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", // telefono del lead que viene de Kommo
      text: "¡Hola! Recibimos tu contacto y ya estamos con tu propuesta."
    })
  }
);

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