WhatsApp no Make pela API oficial, com o ZapClaw

Em resumo: o ZapClaw envia cada mensagem do WhatsApp a um Custom webhook do Make, e o seu cenário responde com um módulo HTTP. As mensagens passam pela API Cloud oficial da Meta, e o número continua funcionando no app WhatsApp Business do celular. Sem app próprio na Meta e sem app extra para instalar no Make: dois módulos e um filtro.

O que você precisa para conectar

• O app WhatsApp Business no número, na versão 2.24.17 ou mais recente, em uso normal.
• Autenticação em dois fatores ativa na conta pessoal do Facebook que autoriza a conexão.
• O número fora de outro provedor. Se ele estiver conectado a outra plataforma, desconecte lá primeiro.
• Um computador para fazer a conexão, com o celular em mãos para confirmá-la no app.

Não precisa de CNPJ nem de empresa verificada para conectar. A lista completa.

Por que a API oficial no Make

• Nenhuma biblioteca não oficial por trás do cenário. Integrações que imitam o WhatsApp Web contrariam os termos do WhatsApp e põem o número em risco. O ZapClaw usa a API Cloud da Meta, e as políticas da Meta valem como para qualquer empresa nela.
• O app continua no celular. Pela Coexistência, a sua equipe continua respondendo no app WhatsApp Business enquanto o Make trabalha no mesmo número.
• HTTP simples dos dois lados. Um Custom webhook para receber e o app HTTP para enviar, com a sua chave no cabeçalho X-API-Key. Migrar um cenário de outra API de WhatsApp é trocar a URL, a chave e alguns nomes de campo.
• Entregas que você confere. O Make responde ao ZapClaw assim que a requisição entra na fila, cada evento é assinado com HMAC-SHA256, e um evento que o Make não aceitar tem até 3 tentativas de entrega e pode ser reenviado pelo painel do ZapClaw.

Configure em seis passos

1. No Make, crie um cenário e adicione Webhooks > Custom webhook. Ao lado de Webhook, clique em Add, dê um nome e salve. Deixe API Key authentication vazio: o Make espera essa chave num cabeçalho x-make-apikey, que o ZapClaw não envia. Copie a URL que o Make gerar.
2. No ZapClaw, conecte o seu número, cole essa URL em Webhook e crie uma chave de API. Em Eventos a receber, deixe marcado só Mensagens recebidas: cada status de entrega é uma requisição separada, e cada uma roda o cenário e gasta um crédito.
3. O Make já está escutando. Mande uma mensagem de WhatsApp para o seu número de outro celular, para o Make aprender os campos de uma mensagem real. Se o módulo pegou antes o evento de teste do painel, clique em Detect new values e mande a mensagem de novo.
4. Adicione HTTP > Make a request depois do webhook e preencha como mostrado abaixo. A sua chave do ZapClaw vai num keychain do tipo API key, enviado no cabeçalho X-API-Key.
5. Clique na linha entre os dois módulos para adicionar um filtro com duas condições: event igual a message.received, e data > type igual a text. O evento de teste e qualquer outra coisa que não seja um texto recebido param ali, então as suas próprias respostas nunca entram em loop.
6. Salve e ative o cenário. Mande outra mensagem de WhatsApp do outro celular: o cenário recebe e responde.

O módulo HTTP, campo a campo

Os valores de Make a request. Nos mapeamentos, 1 é o número do módulo Custom webhook; você também pode escolher os mesmos itens no painel de mapeamento.

• Authentication type: API key. Em Credentials, crie um keychain: Key é a sua chave do ZapClaw, API key placement é o cabeçalho, e API key parameter name é X-API-Key.
• URL: https://api.zapclaw.app/api/v1/send/text, com Method em POST.
• Body content type: application/JSON, com Data structure como forma de entrada do corpo. Crie a estrutura com o gerador do Make a partir do exemplo abaixo. Assim o Make escapa sozinho as aspas e as quebras de linha de cada mensagem.
• from: {{1.account.display_phone_number}}, o seu número conectado.
• to: {{ifempty(1.data.from; 1.data.user_id)}}, o número do cliente, ou o ID de usuário de um contato que só mostra o nome de usuário.
• text: {{1.data.text.body}} responde com o mesmo texto recebido, o que prova a ida e a volta. Troque pela saída de um módulo de IA, uma consulta ao seu CRM ou uma resposta fixa.
• Parse response: Yes, para os módulos seguintes lerem a resposta do ZapClaw.

{
  "from": "15551617409",
  "to": "15555550100",
  "text": "Hello from Make"
}

Texto livre funciona dentro de 24 horas desde a última mensagem do cliente. Fora dessa janela, a Meta só aceita um template aprovado: chame POST /api/v1/send/template.

Para testar a sua chave antes de montar o cenário, faça a mesma chamada num terminal. Uma mensagem enviada responde 201.

curl -X POST https://api.zapclaw.app/api/v1/send/text \
  -H "X-API-Key: zc_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "from": "15551617409", "to": "15555550100", "text": "Hello from Make" }'

O que chega no Custom webhook

Cada mensagem chega como um evento message.received, e o Make quebra o JSON em itens que você mapeia: o texto em data.text.body, o remetente em data.from, o nome do contato em data.contact_name e o seu número em account.display_phone_number. Uma mensagem de mídia traz uma media_url que você baixa com a sua chave de API.

{
  "event": "message.received",
  "sequence": 1042,
  "timestamp": "2026-05-21T14:00:00.000Z",
  "data": {
    "from": "15555550100",
    "user_id": "US.1A2B3C4D5E6F7G8H9I0J",
    "contact_name": "Maria Silva",
    "contact_username": "maria_lima",
    "message_id": "wamid.HBg...",
    "type": "text",
    "timestamp": "1747836000",
    "text": { "body": "Hello" }
  },
  "account": {
    "phone_number_id": "964283400112599",
    "display_name": "My Business",
    "display_phone_number": "+1 555 161-7409"
  }
}

Toda requisição traz um cabeçalho X-ZapClaw-Signature, um HMAC-SHA256 do corpo bruto feito com a sua chave de assinatura: como verificar (em inglês). Para ler esse cabeçalho no cenário, marque Get request headers como Yes nas configurações avançadas do webhook.

Bom saber

• Deixe vazia a estrutura de dados do webhook. Com uma estrutura de dados nas configurações avançadas, o Make recusa com 400 toda requisição que não bate com ela, e o ZapClaw também envia atualizações de status e eventos da conta. Quem separa é o filtro.
• Não precisa do módulo Webhook response. Sem ele, o Make responde 200 Accepted assim que a requisição entra na fila, bem dentro do limite de 10 segundos do ZapClaw.
• Respostas em ordem. Por padrão, o Make roda em paralelo os cenários de um webhook instantâneo. Se as respostas precisam seguir a ordem de chegada das mensagens, ative Process data in order nas configurações do cenário.
• Mantenha o webhook num cenário. O Make desativa um webhook que ficou mais de 5 dias sem ligação com nenhum cenário, e ele passa a responder 410 Gone, que o log de entregas do ZapClaw mostra como falha.
• Não deixe um envio com erro parar o cenário. O Make desativa no primeiro erro um cenário que começa com um webhook, e as respostas param até você ativá-lo de novo. O log de entregas do ZapClaw mostra o que o webhook do Make aceitou, não o que o cenário fez. Ative Store incomplete executions nas configurações do cenário, ou clique com o botão direito no módulo HTTP e adicione um tratamento de erro como Skip ou Resume.

Quanto custa

• Grátis: 500 mensagens por mês e 1 número, sem cartão e sem prazo para acabar. No limite, o envio pausa e as mensagens novas ficam retidas até você assinar.
• Business: R$ 99 por mês, com 20.000 mensagens incluídas e números ilimitados.
• Agency: R$ 149 por mês para agências, com 3 clientes e 60.000 mensagens incluídos e números ilimitados.

A Meta cobra as tarifas de mensagem do WhatsApp direto de você, sem margem do ZapClaw. Todos os planos e preços.

Para quem é

Quem usa o Make para automatizar o WhatsApp da própria empresa ou de clientes: respostas com IA, leads enviados a um CRM, avisos de pedido, triagem de atendimento. Agências conectam os números dos clientes no plano Agency, cada cliente isolado dos outros. Não serve para disparo em massa.

Para ir além

• A API oficial do WhatsApp com o ZapClaw: o que você recebe, o preço e os requisitos.
• A mesma configuração no n8n, com um fluxo pronto para importar.
• WhatsApp no Dify, quando a resposta vem de um app de IA.
• A referência do webhook (em inglês), com cada evento e campo.
• Saindo de uma API não oficial do WhatsApp: o que muda.

Fontes

Verificado em 15 de outubro de 2026. O Make atualiza os módulos de tempos em tempos, então, se um campo parecer diferente, confira a fonte. As fontes estão em inglês.

• Make Help Center, Webhooks: filas, respostas padrão, processamento em paralelo e a desativação de webhooks sem uso.
• Make apps documentation, Webhooks: o módulo Custom webhook, a autenticação por API key, as estruturas de dados, os cabeçalhos da requisição e Detect new values.
• Make apps documentation, HTTP: o módulo Make a request e o corpo em JSON.
• Make apps documentation, API key authentication type: os campos do keychain.
• Make Help Center, Filtering, e General functions para ifempty.
• ZapClaw: webhooks, verificação de assinatura e envio de texto na documentação (em inglês).
• Make Help Center, Scenario settings e Overview of error handling: a desativação no primeiro erro, as execuções incompletas e os tratamentos Skip e Resume.