Saltar para o conteúdo
Navegar na documentação

Guias

Receber estados de entrega

Assinaturas, tentativas e deduplicação

  1. 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. 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. 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. 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 →