Cadastre no painel um endpoint HTTPS do seu sistema para receber os retornos.
Webhooks de status
Receba no seu sistema o status das mensagens do WhatsApp.
Configure uma URL para receber eventos padronizados de criação, entrega, leitura e erro e consulte o histórico das entregas pela API, independentemente da conexão escolhida.
Fluxo
O WPP Marketing avisa seu sistema quando o status muda.
Webhooks de status são úteis para auditoria, conciliação, dashboards internos, suporte e regras do seu próprio sistema.
O webhook informa o resultado de uma mensagem; ele não é uma solicitação de envio. Use a Messaging API para enviar mensagens e a Events API para acionar automações com eventos comerciais suportados.
Ative apenas os status que seu sistema precisa consumir para evitar ruído operacional.
Criação, entrega, leitura ou erro são normalizados da mesma maneira, independentemente da conexão escolhida.
Seu endpoint processa o payload e o histórico de entregas fica disponível no painel e em GET /webhooks.
Eventos disponíveis e consulta das entregas.
Os quatro eventos usam o mesmo contrato em qualquer conexão, e a API permite consultar o resultado de cada tentativa de entrega.
POST
MESSAGE_CREATED
Mensagem foi criada no fluxo e recebeu identificador para acompanhamento.
Criação
POST
MESSAGE_DELIVERED
Mensagem foi entregue ao destino quando o canal retorna confirmação.
Entrega
POST
MESSAGE_READ
Mensagem foi lida, quando a confirmação de leitura está disponível.
Leitura
POST
MESSAGE_ERROR
Mensagem encontrou erro de envio, validação ou processamento.
Erro
GET
/webhooks
Consulta o histórico de entregas com status, tentativas, resposta HTTP e paginação. Requer o escopo webhooks:read.
Logs
Boas práticas
Prepare seu endpoint para receber eventos repetidos e fora de ordem.
Webhooks são entregas entre sistemas. Seu backend deve responder rápido, registrar logs e processar com idempotência.
Cadastre uma URL HTTPS pública e habilite os eventos no painel. O contrato atual não envia assinatura HMAC; defina a proteção e a validação adequadas ao receptor sem pressupor uma assinatura que não existe.
Responda HTTP 2xx em até 15 segundos e processe tarefas demoradas em fila interna. Redirecionamentos não são seguidos.
Use o id do evento, também enviado em Webhook-Id, para evitar processamento duplicado e aceite eventos fora de ordem. Webhook-Attempt informa o número da tentativa. Somente os eventos habilitados são registrados e enviados.
Consulte tentativas e respostas HTTP em GET /webhooks com webhooks:read. Registros concluídos, entregues ou com falha final, são mantidos por 30 dias. Proteja dados pessoais e conteúdo das mensagens nos seus próprios logs.
Falhas de conexão, timeout e respostas 408, 425, 429 ou 5xx podem gerar até sete tentativas no total, com intervalos de 1, 5 e 15 minutos, 1, 6 e 24 horas. Retry-After é respeitado até 24 horas. Outros erros 4xx encerram a entrega.
Webhooks de status são retorno do WPP Marketing. Para enviar eventos comerciais da loja, use Events API.
Quer acompanhar entregas e erros no seu sistema?
Configure uma URL no painel, escolha os status e acompanhe as entregas no relatório de webhooks.