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.
Integre em qualquer linguagem que fala HTTP
A API é REST com JSON e descrita em OpenAPI 3.1. Estes guias mostram o envio e o recebimento de webhooks em cada linguagem e ferramenta, com código para copiar e adaptar.

Linguagens e ferramentas
Todos os exemplos usam os mesmos endpoints e o mesmo formato de evento: escolha o seu ponto de partida.
Tipos gerados da especificação OpenAPI 3.1 com o openapi-typescript e chamadas pelo openapi-fetch: cada rota, corpo, resposta e evento de webhook tipado, sem código escrito à mão.
Envie mensagens com curl ou Guzzle, use o cliente PHP gerado da especificação OpenAPI 3.1 e receba os eventos num script que confere a assinatura HMAC-SHA256 com hash_hmac e hash_equals.
Envie mensagens de WhatsApp a partir de Jobs do Laravel com o Http facade e clientRef, receba os eventos numa rota protegida por um middleware de assinatura HMAC e processe tudo na fila, sem duplicar.
Envie mensagens com requests, trate 400 e 429 com Retry-After e receba os eventos num endpoint Flask ou FastAPI que verifica a assinatura HMAC-SHA256 com hmac.compare_digest.
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.
Sem app nativo da apiwpp no Make: o envio usa o módulo HTTP "Make a request", os eventos chegam num Custom webhook, e o cenário de exemplo transforma cada nova linha da planilha numa mensagem.
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.
Antes de começar
Você precisa de uma chave de API do projeto (wag_live_…) com o escopo messages:send, enviada no cabeçalho Authorization: Bearer, e de um número conectado. O teste grátis de 7 dias libera 1 número com os recursos do plano PRO, sem cartão.
Os clientes TypeScript e PHP são gerados da especificação OpenAPI e, enquanto não estão publicados nos registros de pacotes, são entregues pelo suporte ou gerados por você. n8n, Make e Zapier não têm um nó ou app nativo da apiwpp: a integração usa a requisição HTTP e o webhook genéricos de cada ferramenta.
Referência completa da API
Guias de início rápido, pareamento, envio, idempotência, erros e limites, mais a referência interativa de cada endpoint.
Continue explorando
- Recursos →Tudo que a API faz: conexão, envio, webhooks e fila.
- Casos de uso →Como cada tipo de empresa usa o WhatsApp pela API.
- Comparativos →API oficial, gerenciada ou self-hosted, lado a lado.
- Glossário →Os termos técnicos, em definições curtas.
- Blog →Guias, tutoriais e boas práticas.
- Documentação →Guias da API e referência OpenAPI em português.