Migrar do WAHA para a ZapZap: guia de migração (inclui n8n)

O WAHA é uma API HTTP não oficial que você roda em Docker; o site do projeto o descreve como gratuito e de código aberto. Você escolhe o motor de conexão (WEBJS, NOWEB, GOWS), o servidor e a hora de atualizar. A documentação do próprio WAHA avisa que o WhatsApp não permite bots ou clientes não oficiais e que isso pode levar a bloqueio.

Na ZapZap, hospedagem, atualização e monitoramento ficam conosco, a cobrança é de R$15 por número ativo ao mês e o risco do número continua existindo, porque também é uma solução não oficial. Em troca, você perde o controle do servidor e do motor.

A coluna do WAHA vem da documentação oficial (waha.devlike.pro, 27/10/2026). O WAHA usa session e chatId com sufixo (@c.us); a ZapZap usa o ID da instância na URL e o número só com dígitos.

Se o seu fluxo usa o nó do WAHA ou um HTTP Request apontando para o WAHA, a troca é direta. Instale o nó da comunidade n8n-nodes-zapzap em Settings, Community Nodes (nós da comunidade não verificados só funcionam no n8n self-hosted, segundo a documentação do n8n) ou use um HTTP Request com os cabeçalhos x-api-key e x-api-secret. Passo a passo na integração com n8n.

No gatilho de recebimento, troque o Webhook do WAHA pelo Webhook do n8n com a URL de produção (não a de teste) e configure essa URL em configurar webhook. Nos nós seguintes, ajuste as expressões: onde havia payload.from e payload.body, passe a usar data.message.chatid e data.message.text. Os 12 templates de n8n já vêm no formato da ZapZap.

// Entrada: evento da ZapZap. Saída: o formato que seus nós já esperavam do WAHA.
const e = $input.first().json.body ?? $input.first().json;
const m = e?.data?.message;
if (e?.event !== "messages" || !m || m.fromMe) return [];
return [{
  json: {
    payload: {
      from: String(m.chatid || "").replace(/\D/g, "") + "@c.us",
      body: m.text || "",
      fromMe: false,
    },
  },
}];

O envio é uma troca de URL, cabeçalhos e campos: session e chatId com @c.us viram o ID da instância na URL e number só com dígitos. Isole o envio numa função e troque o conteúdo dela.

// ANTES: WAHA
// POST {WAHA_URL}/api/sendText   header: X-Api-Key
// body: { session: "default", chatId: "5511999999999@c.us", text: "Olá!" }

// DEPOIS: ZapZap
export async function enviarWhatsApp(numero, texto) {
  const r = await fetch(
    "https://api.zapzapapi.com/api/v1/" + process.env.ZAPZAP_INSTANCE_ID + "/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: numero.replace(/@.*/, ""), text: texto }),
      signal: AbortSignal.timeout(15000),
    }
  );
  if (!r.ok) throw new Error("ZapZap " + r.status + " " + (await r.text()));
  return r.json();
}

Checklist: 1) criar a conta e testar com um número seu; 2) trocar a função de envio ou o nó do n8n; 3) apontar o webhook e validar a assinatura (guia); 4) exportar o que quiser guardar do WAHA; 5) conectar o número de produção por QR code na hora da virada, sem mantê-lo ativo nos dois; 6) desligar o contêiner antigo depois de alguns dias estáveis.

Continue no WAHA se você tem DevOps, quer o código e os dados no seu ambiente e prefere escolher o motor de conexão. Veja o comparativo WAHA x ZapZap e a conta de custo em Evolution e WAHA hospedados x gerenciada. Se você precisa de canal homologado pela Meta, a opção é a API oficial.