Guias
Receber estados de entrega
Assinaturas, tentativas e deduplicação
- 1
Prepara um endpoint HTTPS
Usa um endereço público com certificado válido. Endereços privados e redirecionamentos não são suportados.
- 2
Regista o endpoint
Cria um endpoint de webhook com o evento message.status. Guarda o segredo de assinatura de forma segura quando for devolvido.
- 3
Valida e confirma a receção
Verifica a assinatura HMAC e o timestamp com o corpo original do pedido. Responde HTTP 2xx em até 8 segundos e processa depois, de forma assíncrona.
- 4
Trata as repetições
Deduplica pelo ID do evento. Os eventos podem repetir-se ou chegar fora de ordem; consulta o estado quando necessário. Revê as tentativas antes de repetir manualmente.
Pronto para construir o pedido?
Abre a referência completa para consultar os parâmetros obrigatórios, copiar código e confirmar os limites.
Abrir referência API →