Pular para o conteúdo
apiwpp
Integração

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

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 HTTPValor
URLhttps://api.apiwpp.com/connections/SEU_CONNECTION_ID/send
MethodPOST
HeadersAuthorization = Bearer wag_live_…
Body typeRaw, com content type application/json
Request contentO JSON gerado pelo módulo Create JSON
Parse responseSim

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:

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:

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:

typeCampos úteis em dataUso típico
message.incomingmessageId, phone, o texto ou a mídiaCriar um contato ou ticket, responder
message.deliverymessageId, status, clientRefAtualizar a linha com sent, delivered, read ou failed
message.send_failedclientRef, o motivoAvisar a equipe de um envio que não vai acontecer
connection.statusstatus, reason, willReconnectAlertar 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.

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.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.