Integrar WhatsApp com Kommo

Passo a passo

1. 1

   Conectar o número na ZapZap API

   Crie sua conta em api.zapzapapi.com, adicione uma instância, leia o QR Code com o WhatsApp que fará os disparos e copie as credenciais x-api-key e x-api-secret geradas para essa instância.

2. 2

   Preparar o funil no Kommo

   No Kommo, abra Leads e ajuste as etapas do seu pipeline em Configurar (ícone de engrenagem do funil). Defina em quais etapas o WhatsApp deve ser disparado, por exemplo Novo contato, Proposta enviada e Follow-up.

3. 3

   Criar o Salesbot

   Vá em Leads, abra o painel Digital Pipeline e clique em adicionar um gatilho na etapa desejada. Escolha a ação Bots e crie um novo Salesbot no editor visual.

4. 4

   Adicionar a ação de webhook

   Dentro do Salesbot, adicione o passo Enviar webhook (Send webhook). Aponte a URL para o seu endpoint intermediário, que recebe os dados do lead (nome, telefone, etapa) e chama a ZapZap API para enviar o texto.

5. 5

   Ativar o gatilho e testar

   Salve o Salesbot, defina o gatilho para disparar quando o lead entrar na etapa e ative. Mova um lead de teste para essa etapa e confirme que a mensagem chega no WhatsApp e o log aparece no cartão do lead.

// Exemplo ILUSTRATIVO: seu endpoint recebe o webhook do Salesbot (Kommo)
// e envia o WhatsApp pela ZapZap API. Confira os campos exatos em
// 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", // telefone do lead vindo do Kommo
      text: "Ola! Recebemos seu contato e ja estamos com sua proposta."
    })
  }
);

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