Integração via webhook

Integrar WhatsApp com ActiveCampaign

ActiveCampaign é uma plataforma de automação de marketing e CRM que orquestra jornadas de contato através das Automations. A integração com a ZapZap API permite disparar mensagens de WhatsApp como uma etapa dentro dessas automações, usando a ação de Webhook nativa. A ZapZap API é uma API de WhatsApp não oficial baseada em instâncias: você conecta um número real via QR Code e passa a enviar mensagens de forma programática. A autenticação usa os cabeçalhos x-api-key e x-api-secret, e a cobrança é de R$15 por número ativo por mês, pré-pago, com crédito grátis para testar antes de escalar.

Por que conectar

Uma clínica de estética captura leads por um formulário do ActiveCampaign. Ao entrar na lista, o contato dispara uma Automation que envia e-mail de boas-vindas e, no mesmo fluxo, um WhatsApp confirmando o interesse e oferecendo horário. Se o lead não responder em 2 dias, a automação envia um lembrete pelo WhatsApp. Como o disparo acontece dentro da própria jornada do ActiveCampaign, marketing e atendimento ficam sincronizados sem trabalho manual, e o time comercial recebe o lead já aquecido pelo canal que ele mais usa.

Passo a passo

  1. 1

    Conecte seu número na ZapZap API

    No painel da ZapZap API, crie uma instância e leia o QR Code com o WhatsApp do número que fará os envios. Guarde a instanceId, a x-api-key e o x-api-secret gerados para a instância.

  2. 2

    Abra a Automation no ActiveCampaign

    No menu lateral, vá em Automations e crie uma nova automação ou edite uma existente. Defina o gatilho, por exemplo Subscribes to a list ou Submits a form, para decidir quando o WhatsApp será enviado.

  3. 3

    Adicione a ação de Webhook

    Dentro do fluxo, clique no sinal de mais para adicionar uma ação, escolha a categoria CX Apps (ou Conditions and Workflow) e selecione Webhook. É essa ação que envia os dados do contato para fora do ActiveCampaign.

  4. 4

    Aponte o webhook para o seu endpoint de envio

    Cole a URL do seu endpoint intermediário que recebe o contato do ActiveCampaign e chama a ZapZap API. O ActiveCampaign envia campos do contato como telefone e nome; seu endpoint monta o body com number e text e faz a chamada autenticada à ZapZap API.

  5. 5

    Ative e teste a automação

    Salve, coloque a automação em Active e rode um contato de teste com um número real. Confirme a chegada da mensagem no WhatsApp e ajuste o texto, delays e condições do fluxo conforme a jornada desejada.

Exemplo

// Exemplo ILUSTRATIVO: endpoint intermediario que recebe o webhook
// do ActiveCampaign e dispara o WhatsApp pela ZapZap API.
// Confira a referencia real em https://api.zapzapapi.com/llms.txt

const instanceId = "SUA_INSTANCE_ID";

// dados vindos do webhook do ActiveCampaign (contato)
const contato = { telefone: "5511999999999", nome: "Maria" };

await fetch(`https://api.zapzapapi.com/api/v1/${instanceId}/send/text`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "SUA_API_KEY",
    "x-api-secret": "SEU_API_SECRET"
  },
  body: JSON.stringify({
    number: contato.telefone,
    text: `Ola ${contato.nome}, recebemos seu contato e ja vamos te atender.`
  })
});

Ilustrativo. Os campos e endpoints exatos estão na documentação.

Perguntas frequentes

Preciso de um servidor intermediário entre o ActiveCampaign e a ZapZap API?

Sim, na maioria dos casos. A ação de Webhook do ActiveCampaign envia os campos do contato no formato dela, então você usa um endpoint próprio ou uma ferramenta como Make ou n8n para transformar esses dados no body que a ZapZap API espera e adicionar os cabeçalhos de autenticação.

Quanto custa para enviar WhatsApp pelo ActiveCampaign?

A ZapZap API cobra R$15 por número ativo por mês, no modelo pré-pago, e você recebe crédito grátis para testar. O ActiveCampaign tem o custo do plano dele à parte. Não há cobrança por mensagem na ZapZap API.

Que dados do contato eu consigo usar na mensagem?

A ação de Webhook do ActiveCampaign envia os campos do contato, incluindo telefone, nome, e-mail e campos personalizados. Você usa esses valores no seu endpoint para personalizar o texto antes de chamar a ZapZap API.

É a API oficial do WhatsApp?

Não. A ZapZap API é uma solução não oficial baseada em instâncias, na qual você conecta um número real via QR Code. Por isso recomenda-se usar mensagens relevantes, respeitar o opt-in dos contatos e aquecer o número gradualmente.

Onde encontro a referência técnica dos endpoints?

A documentação para máquinas e a lista de endpoints ficam em https://api.zapzapapi.com/llms.txt. Use-a como fonte para montar as chamadas de envio com base https://api.zapzapapi.com.

Comece com crédito grátis

Crie sua conta, conecte um número em minutos e teste a API com aquecimento e anti-bloqueio. R$15 por número ativo/mês, pré-pago, sem fidelidade.