Webhooks e eventos
Cada e-mail avisa o seu sistema.
A cada entrega, abertura, clique ou devolução, a Postal manda um aviso automático para o endereço que você escolher. Seu CRM, seu ERP ou seu site ficam atualizados sem consultar nada.
- 30 tipos de evento
- Assinatura no padrão Standard Webhooks
- Até 8 tentativas em cerca de 27 horas
- Reenvio pelo painel
Como funciona
Do aviso ao reenvio
O que a Postal faz do momento em que algo acontece até o seu sistema confirmar.
Cada acontecimento vira um aviso
Você escolhe quais eventos quer receber: entregue, aberto, link clicado, devolvido, marcado como spam, resposta, e-mail recebido numa inbox e outros. Há também eventos de domínios, supressões, contatos, formulários, campanhas e inboxes, e um aviso na hora em que os envios do time são pausados. Dá para mandar tudo para um endereço só ou separar por sistema.
Ver a lista completa de eventosComo o aviso chega
Webhook é só isso: uma mensagem automática de um sistema para outro, no momento em que algo acontece.
Cada aviso chega assinado
Quem recebe consegue provar que o aviso veio da Postal e não de outra pessoa. A assinatura segue o padrão Standard Webhooks, e as bibliotecas oficiais da Postal já conferem tudo por você.
Como verificar a assinatura- Assinatura HMAC-SHA256 em cada entrega
- Os SDKs recusam avisos com mais de 5 minutos de diferença
- Cada webhook tem o seu segredo, que dá para trocar no painel (o antigo deixa de valer na hora)
webhook-id: <o mesmo em todas as tentativas>
webhook-timestamp: <segundos desde 1970>
webhook-signature: v1,<assinatura>
{
"type": "email.delivered",
"created_at": "2026-10-24T13:02:14.120Z",
"data": {
"email_id": "019a1b2c-4d5e-7f60-8a9b-0c1d2e3f4a5b",
"from": "Aurora Cosméticos <[email protected]>",
"to": ["[email protected]"],
"subject": "Seu pedido #10482 saiu para entrega",
"tags": {}
}
}Se o seu sistema cair, a Postal tenta de novo
Seu sistema responde com qualquer status 2xx para confirmar. Se não responder ou der erro, a Postal repete com esperas cada vez maiores, sempre com o mesmo identificador, para você descartar duplicatas.
- Na 8ª tentativa sem sucesso, o evento fica como falhou e dá para reenviar pelo painel
- Se as entregas falharem por 5 dias sem nenhum sucesso, o endereço é desativado e donos e admins do time recebem um e-mail
Veja o que foi entregue e reenvie o que precisar
No painel, cada webhook tem o seu histórico: o que foi enviado, quantas tentativas houve e o que o seu sistema respondeu. Corrigiu o problema? Reenvie o evento com um clique ou mande um evento de teste, mesmo com o endereço desativado.
Ver a referência da API de webhooksTeste sem enviar de verdade
Endereços de teste geram avisos reais, assinados, sem enviar e-mail e sem usar a cota. Dependem do plano.
[email protected]email.sent e email.delivered[email protected]email.bounced, bounce permanente[email protected]email.complained
Com e sem webhooks
Sem webhooks
- Seu sistema precisa consultar cada e-mail para saber o que aconteceu
- Bounces e reclamações passam despercebidos até alguém olhar o painel
- Se a consulta falha, ninguém fica sabendo
Com webhooks
- Um aviso assinado chega ao endereço que você escolheu, a cada evento
- Se o seu sistema estiver fora do ar, a Postal tenta de novo por cerca de 27 horas
- Cada entrega fica no histórico por 30 dias, com reenvio pelo painel
Perguntas frequentes
Preciso saber programar?
Para receber os avisos, alguém precisa configurar o endereço do seu sistema que os recebe, e essa parte é técnica. No painel da Postal, o resto é simples: colar a URL e marcar os eventos que você quer.
O que acontece se o meu sistema ficar fora do ar?
A Postal tenta entregar o aviso até 8 vezes, ao todo em cerca de 27 horas. Depois disso o evento fica como falhou, e você pode reenviá-lo pelo painel. Se as entregas falharem por 5 dias sem nenhum sucesso, o endereço é desativado e donos e admins do time recebem um e-mail.
Posso testar sem enviar e-mail de verdade?
Sim. O painel tem o botão Enviar evento de teste. Para ver eventos de e-mail, mande uma mensagem para os endereços de teste, como [email protected] ou [email protected], se o seu plano incluir.
Quantos endereços posso cadastrar?
Depende do plano. Ao passar do limite, a Postal avisa na hora de criar mais um. Veja os planos e preços.