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 de fila, criação, entrega, leitura, erro, número não encontrado, expiração e logout.
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.
Ative apenas os status que seu sistema precisa consumir para evitar ruído operacional.
Entrega, leitura, erro, expiração, número inválido ou logout são detectados na operação.
O endpoint processa o payload, registra log e atualiza seu próprio painel ou regra interna.
Eventos de retorno disponíveis.
Esses status ajudam seu sistema a saber o que aconteceu depois que uma mensagem entrou no fluxo do WhatsApp.
POST
QUEUE
Mensagem entrou na fila de processamento.
Fila
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
POST
LOGOUT
Conexão do WhatsApp foi encerrada e pode exigir ação da operação.
Conexão
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.
Use URL segura, pública e estável para receber os eventos de retorno.
Responda HTTP 200 ou 204 após receber o evento e processe tarefas demoradas em fila interna.
Use identificadores de mensagem e evento para evitar duplicidade em reentregas.
Registre payload, data, status HTTP e resultado do processamento para auditoria.
Use eventos de erro, número não encontrado e logout para alertar suporte ou operação.
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 de webhook no painel e escolha quais status devem voltar para sua aplicação.