WhatsApp no Make (Integromat) com a apiwpp: módulo HTTP e webhook
Envie mensagens de WhatsApp no Make (antigo Integromat) com o módulo HTTP e receba eventos num Custom webhook. Cenário: nova linha na planilha vira mensagem.
Atualizado em
O Make, que antes se chamava Integromat, liga aplicativos por cenários de módulos. Não existe um app nativo da apiwpp no Make: a integração usa o módulo HTTP › Make a request para enviar mensagens e o módulo Webhooks › Custom webhook para receber os eventos que a apiwpp envia. Com eles, qualquer gatilho que o Make conhece (planilha, formulário, loja virtual, CRM) pode virar uma mensagem de WhatsApp, e cada resposta do cliente pode voltar para o seu sistema.
O que você precisa
- Uma conta na apiwpp: o teste grátis de 7 dias libera 1 número com os recursos do plano PRO, sem cartão.
- Um número conectado ao projeto, por QR code ou código de pareamento.
- Uma chave de API do projeto com o escopo
messages:send, e o identificador da conexão. - Uma conta no Make com acesso aos módulos HTTP e Webhooks.
A chave de API dá acesso ao projeto: prefira guardá-la num lugar reaproveitável do Make, como uma variável ou conexão da organização, em vez de copiá-la em vários cenários.
Enviar uma mensagem com o módulo HTTP
A apiwpp recebe o envio em POST /connections/{id}/send, com JSON no corpo. Para não ter problema com aspas e quebras de linha no texto, monte o corpo com o módulo JSON › Create JSON e passe o resultado ao módulo HTTP:
| Campo do módulo HTTP | Valor |
|---|---|
| URL | https://api.apiwpp.com/connections/SEU_CONNECTION_ID/send |
| Method | POST |
| Headers | Authorization = Bearer wag_live_… |
| Body type | Raw, com content type application/json |
| Request content | O JSON gerado pelo módulo Create JSON |
| Parse response | Sim |
A estrutura do JSON tem três campos:
{
"to": "5511988887777",
"message": "Olá, Maria! Seu pedido 1234 foi confirmado.",
"clientRef": "pedido-1234"
}
O campo to leva só dígitos, com o código do país e o DDD. Antes de enviar, a apiwpp pergunta ao WhatsApp em qual endereço o número está registrado, então contas antigas sem o nono dígito recebem normalmente.
A resposta é 202 com jobId, scheduledAt (milissegundos unix) e position: a mensagem entrou na fila do número. Além de texto, o corpo aceita media (imagem, vídeo, áudio, documento ou figurinha por URL https pública), location e template com variáveis, como mostra a documentação.
Cenário de exemplo: nova linha na planilha vira mensagem
Um uso comum é avisar clientes a partir de uma planilha que a equipe já preenche:
- Google Sheets › Watch New Rows: o gatilho lê as linhas novas, com as colunas nome, telefone, pedido e status.
- JSON › Create JSON: monta o corpo com
to= telefone,message= o texto com o nome e o pedido, eclientRef=pedido-seguido do número do pedido. - HTTP › Make a request: envia, com a configuração da tabela acima.
- Opcional: Google Sheets › Update a Row grava o
jobIdda resposta numa coluna, para saber o que já foi enviado.
O clientRef evita a mensagem repetida: se o cenário processar a mesma linha de novo, a apiwpp responde 200 com o job original e "duplicate": true, sem enviar outra vez. Ele fica reservado por 7 dias e volta nos eventos de entrega, ligando cada status à linha certa.
Os telefones da planilha precisam estar só com dígitos. Uma coluna com parênteses, traços ou espaços pode ser limpa no próprio mapeamento, com a função de substituição do Make.
Tratar erros e respeitar a fila
Os erros vêm em JSON com o campo error. Por padrão, o módulo HTTP trata respostas 4xx e 5xx como erro; adicione uma rota de tratamento de erro ao módulo para decidir o que fazer:
400: corpo inválido ou número desconectado. Corrija o dado ou espere o número voltar.429comnew_recipient_cap_reached: o número chegou ao teto de destinatários novos das últimas 24 horas. Nada foi para a fila, e o cabeçalhoRetry-Afterdiz quantos segundos esperar. Marque a linha para reenviar depois, com o mesmoclientRef.
A fila de cada número segue um ritmo que reduz o risco de bloqueio: por padrão, 3 mensagens por minuto, 60 por hora e 200 por dia, com 3 a 8 segundos entre envios e no máximo 100 destinatários novos por 24 horas. Nos primeiros 14 dias depois de conectar, os limites começam menores e sobem por etapas. Uma planilha com 500 linhas não sai em 5 minutos, e isso é proposital. Veja fila com ritmo anti-bloqueio.
Receber eventos com um Custom webhook
Para o caminho de volta, crie um cenário que começa com Webhooks › Custom webhook. O Make gera uma URL; configure essa URL como o endereço de webhook do projeto na apiwpp. O projeto tem um único endereço, que recebe os eventos de todos os números dele; se o Make cuida só de uma parte, crie um projeto separado para ele, sem custo.
Todo evento chega no mesmo envelope:
{
"type": "message.incoming",
"connectionId": "8b1d4e7f-2c3a-4f5b-9e6d-7a8b9c0d1e2f",
"tenantId": "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61",
"externalId": "loja-42",
"timestamp": "2026-09-25T12:00:02.000Z",
"data": { "messageId": "3EB0C767D26A1D8A3F52", "phone": "+5511988887777" }
}
Na primeira vez, use Redetermine data structure e envie um evento de teste para o Make aprender os campos. O webhook do Make responde na hora, o que atende ao prazo da apiwpp: um status 2xx em até 10 segundos.
Mapear os campos do envelope
Depois do webhook, um Router com filtros no campo type separa os caminhos:
type | Campos úteis em data | Uso típico |
|---|---|---|
message.incoming | messageId, phone, o texto ou a mídia | Criar um contato ou ticket, responder |
message.delivery | messageId, status, clientRef | Atualizar a linha com sent, delivered, read ou failed |
message.send_failed | clientRef, o motivo | Avisar a equipe de um envio que não vai acontecer |
connection.status | status, reason, willReconnect | Alertar quando o número cair sem reconexão automática |
Os campos de fora do envelope (connectionId, externalId) dizem de qual número e de qual cliente do seu sistema veio o evento. Tipos que o cenário não conhece devem seguir sem ação: a lista de eventos só cresce. A entrega é pelo menos uma vez, então confira se o messageId já foi gravado antes de criar um registro. A lista completa está em webhooks assinados.
Cada entrega assinada traz os cabeçalhos X-Sales-Timestamp e X-Sales-Signature (HMAC-SHA256). Conferir a assinatura exige o corpo bruto e os cabeçalhos; se o cenário não fizer essa verificação, mantenha a URL do webhook em segredo e troque-a se ela vazar. Veja o que é HMAC.
Perguntas frequentes
Existe um app da apiwpp no Make?
Não. A integração usa os módulos genéricos do Make: HTTP › Make a request para enviar e Webhooks › Custom webhook para receber. Eles cobrem tudo o que a API faz por HTTP e por webhook.
Por que as mensagens do cenário não saem todas de uma vez?
Porque cada número tem uma fila com ritmo anti-bloqueio. A API aceita o envio na hora e responde com a posição e o horário previsto; a fila envia aos poucos, dentro dos limites por minuto, hora e dia.
Posso enviar um PDF ou uma imagem pelo Make?
Sim, desde que o arquivo esteja numa URL https pública. Use o campo media no JSON, com o tipo (document, image, video, audio ou sticker) e a URL; para documentos, informe também o mimetype.
Como o cenário sabe se a mensagem foi lida?
Pelo evento message.delivery, que chega no Custom webhook com o status e o mesmo clientRef que você enviou. Com ele, o cenário atualiza a linha certa da planilha.
Outras integrações
Todos: Integrações →Sem app nativo da apiwpp no Zapier: a ação POST do Webhooks by Zapier envia a mensagem com o cabeçalho Authorization, o gatilho Catch Hook recebe os eventos, e a fila do número dita o ritmo.
Não há nó nativo da apiwpp no n8n: o envio usa o nó HTTP Request com uma credencial Header Auth, e os eventos chegam num nó Webhook, filtrados pelo campo type e com a assinatura conferida.
Envie mensagens com o fetch nativo do Node.js, sem dependências, e receba os eventos num endpoint Express que verifica a assinatura HMAC-SHA256 de cada entrega.