Integrar WhatsApp com Bitrix24

Passo a passo

1. 1

   Crie a instancia e pegue as chaves na ZapZap API

   No painel da ZapZap API, provisione um numero, leia o QR Code no WhatsApp e copie o instanceId, a x-api-key e o x-api-secret. Esse numero e o que enviara as mensagens a partir do Bitrix24.

2. 2

   Abra os Webhooks de saida no Bitrix24

   No Bitrix24, va em Aplicativos, depois Desenvolvedores (Developer resources) e clique em Outbound webhook. Selecione o evento desejado, por exemplo ONCRMDEALUPDATE ou ONCRMLEADADD, para disparar quando o negocio muda de estagio.

3. 3

   Aponte o webhook para um automatizador

   No campo Handler URL, informe a URL de um servico intermediario (como Make, n8n ou uma funcao propria) que vai receber o evento do Bitrix24 e traduzir os dados do negocio para a chamada da ZapZap API.

4. 4

   Monte a chamada para a ZapZap API

   No automatizador, configure uma requisicao HTTP POST para a ZapZap API usando o telefone do contato do negocio e o texto da mensagem. Envie os cabecalhos x-api-key e x-api-secret para autenticar.

5. 5

   Teste com um negocio real e monitore

   Mova um negocio de teste no funil do Bitrix24, confirme que a mensagem chegou no WhatsApp e acompanhe os disparos. Use os Webhooks de entrada (Inbound webhook) do Bitrix24 caso queira registrar respostas de volta no CRM.

// Exemplo ILUSTRATIVO: disparo de WhatsApp ao mudar estagio no Bitrix24
// Consulte os endpoints e campos reais 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",
      text: "Ola! Recebemos seu contato e ja estamos cuidando do seu atendimento.",
    }),
  }
);

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