Novo guia: como aquecer um IP dedicado sem prejudicar sua reputação. Ler agora →
MigoSMTP
Webhooks e eventos

Saiba no instante em que algo acontece

Receba eventos assinados para cada entrega, rejeição, abertura, clique e reclamação, e reenvie o que você perdeu.

A IA resume os fluxos de eventos e sinaliza padrões incomuns de rejeição assim que aparecem.

Adicionar endpoint
URL
https://example.com/hook
Segredo
••••••••••
Salvar
Endpoint adicionado
Somente HTTPS
Verificado
Adicione um endpoint HTTPSInforme uma URL que receba requisições POST. Confirmamos que ela responde antes de enviar qualquer evento real.
Eventos assinados
deliveredMensagem aceita
bouncedDefinitivas e temporárias
complainedDenúncias de spam
clickedAtividade de links
Por evento
Por fluxo
Escolha os eventos que você querAssine apenas o que gera ação: delivered, bounced, complained, opened ou clicked.
Eventos de entrega
Eventos assinados
/hooks/mail
200 OK
Análises
200 OK
Sincronização com CRM
200 OK
Tempo real
Vários endpoints
Os eventos são distribuídos em tempo realCada evento é enviado a todos os endpoints inscritos, para que análises, CRM e alertas fiquem sempre sincronizados.
Payload
{ "event": "delivered" }
Cabeçalho de assinatura
sha256=9f2c41…
Segredo compartilhado
Com carimbo de data e hora
Comparação em tempo constante
Rejeite tudo que falhar na verificação
HMAC-SHA256
À prova de replay
Verifique cada requisiçãoCada requisição traz uma assinatura HMAC criada com o seu segredo, para que você possa provar que ela veio de nós.
Saúde do endpoint · /hooks/mail
IA
há 1h
Agora
Erros em altaA maioria das falhas é 502 após o seu último deploy.
Sugestão: enfileirar os eventos e reenviar quando /hooks/mail se recuperar
Agrupa as falhas
Pausar ou reenviar
A IA detecta cedo um endpoint com falhasEm vez de esperar as novas tentativas se esgotarem, a IA percebe a taxa de erros do seu endpoint subindo e agrupa as falhas por causa. Ela propõe uma correção e pode pausar o evento que gera ruído.
Handler de webhook
Node
Python
PHP
Go
PHP
app.post("/hook", (req, res) => {
verify(req, SECRET)
res.sendStatus(200)
})
200 OK
Confirme rápido
Idempotente
Um handler em poucas linhasVerifique a assinatura, confirme o recebimento rápido e processe depois. É tudo o que um consumidor confiável precisa.
Endpoint
Eventos
Distribuição
Assinatura
Triagem por IA
Handler
Relay SMTPAPI RESTWebhooksIPs dedicadosAssinatura DKIMInbound parseTemplatesAnálisesListas de supressãoMonitoramento de reputaçãoValidação de e-mailFunções de equipe e log de auditoriaRelay SMTPAPI RESTWebhooksIPs dedicadosAssinatura DKIMInbound parseTemplatesAnálisesListas de supressãoMonitoramento de reputaçãoValidação de e-mailFunções de equipe e log de auditoria
Recursos

Entrega de eventos confiável

Todos os resultados

Entregue, adiado, rejeitado, aberto, clicado, reclamado e cancelado.

Payloads assinados

Verifique se cada requisição veio da MigoSMTP.

Novas tentativas com backoff

As entregas que falham são repetidas automaticamente.

Replay

Reenvie eventos do log após uma indisponibilidade.

Filtros de eventos

Assine apenas os eventos de que precisa.

Logs de entrega

Veja requisição, resposta e status de cada tentativa.

Como funciona

O evento ocorreUma mensagem é entregue, adiada, rejeitada, aberta, clicada ou denunciada como spam.
A MigoSMTP assina e enviaO evento é empacotado em um payload JSON assinado e enviado ao seu endpoint HTTPS.
Seu endpoint verificaSeu handler confere a assinatura e confirma com uma resposta 2xx.
Nova tentativa e replayAs entregas que falham são repetidas, e você pode reenviar eventos do log após uma indisponibilidade.
ETAPA 1

Adicione um endpoint

Informe sua URL HTTPS e escolha os eventos.

ETAPA 2

Verifique a assinatura

Confira o cabeçalho de assinatura em cada requisição.

ETAPA 3

Processe e confirme

Retorne uma resposta 2xx para confirmar o recebimento.

Veja em ação

Uma só plataforma, do primeiro envio à caixa de entrada

Alterne entre as etapas para ver o que você controla em cada uma. Interface ilustrativa. Todos os números e endereços exibidos são dados de exemplo.

app.migosmtp.com / sendDados de exemplo
Na fila
184,320
Enviados hoje
6,418,905
Taxa
412/s
aceitomensagem para you@example.com
aceitomensagem para team@example.com
na filalote de 25.000 destinatários
aceitomensagem para ops@example.com
Operações

Mantenha seus sistemas em sintonia com o seu e-mail

Atualize seu banco de dados, dispare fluxos de trabalho e avise sua equipe sem fazer polling.

  • Seleção de eventos por endpoint
  • Novas tentativas automáticas e replay manual
  • Logs completos de requisição e resposta
  • Segredos que você pode trocar
Visão rápida
TransporteHTTPS POST
FormatoJSON
SegurançaCabeçalho de assinatura
Novas tentativasAutomática, com backoff
Visão geral

O que são webhooks e eventos?

Webhooks de e-mail são callbacks HTTP que avisam seu aplicativo quando algo acontece com uma mensagem que você enviou. A MigoSMTP envia um payload JSON assinado ao seu endpoint HTTPS para eventos como entregue, adiado, rejeitado, aberto, clicado, reclamado e cancelado. Seu sistema reage na hora, em vez de consultar a API repetidamente para saber o status. Os payloads trazem o ID da mensagem, o destinatário, o tipo de evento, o horário e, nas falhas, o motivo devolvido pelo servidor de destino. Esses campos permitem associar os eventos aos seus próprios registros sem consultas extras nem adivinhação.

Você registra um endpoint, escolhe quais eventos ele deve receber e verifica o cabeçalho de assinatura em cada requisição. Retorne uma resposta 2xx para confirmar o recebimento. Se o seu endpoint falhar, as entregas são repetidas com backoff, e você pode reenviar eventos do log após uma indisponibilidade. Os detalhes de requisição e resposta de cada tentativa são guardados para você depurar rápido. Os segredos podem ser trocados, e os filtros de eventos mantêm cada endpoint focado. As tentativas que falham mostram a requisição, a resposta e o horário, o que torna a depuração de um handler rápida e baseada em evidências.

Os dados de eventos são como um sistema de envio aprende. Atualizar a supressão, pausar uma campanha diante de um pico de reclamações ou avisar o suporte sobre um recibo rejeitado dependem de eventos entregues a tempo. Nossa camada de IA pode resumir fluxos de alto volume e sinalizar padrões incomuns, para que sua equipe perceba um problema em minutos, e não depois que um cliente reclamar. Com replay e logs, uma lacuna nos seus sistemas não vira uma lacuna nos seus dados.

Casos de uso

Casos de uso comuns de webhooks e eventos

Manter seu banco de dados sincronizado

Marque pedidos como notificados quando forem entregues e sinalize contatos quando houver uma rejeição definitiva. Os webhooks eliminam a necessidade de jobs de polling e mantêm o estado da aplicação correto.

Tratamento automático de supressão

Em eventos de rejeição ou reclamação, adicione o endereço à sua própria tabela de não enviar imediatamente, para que os outros sistemas que enviam e-mail à mesma pessoa também parem.

Alertas para as equipes de suporte

Envie um alerta no Slack ou em um ticket quando uma redefinição de senha for rejeitada. O suporte pode então contatar o cliente por outro canal antes que ele desista. Isso poupa horas de trabalho manual.

Recuperação após uma indisponibilidade

Se o seu endpoint ficou fora do ar durante um deploy, reenvie os eventos perdidos a partir do log e leve seus registros de volta ao estado correto. Nada se perde nesse intervalo.

Atualizar o status de pedidos e tickets

Marque um pedido como notificado ou um ticket de suporte como respondido assim que o evento de entrega chegar.

Alimentar seu data warehouse

Envie os eventos por stream para a sua própria análise, para que os resultados de e-mail fiquem ao lado dos dados de produto e de receita.

Como escolher

Webhooks ou polling da API?

Os dois fornecem dados de eventos. Servem a situações diferentes.

WebhooksPolling da API
Como funcionaNós enviamos os eventos ao seu endpointSeu código pergunta em intervalos programados
VelocidadeQuase em tempo realDepende do seu intervalo de polling
CargaSomente quando algo aconteceRequisições constantes, na maioria vazias
ConfiabilidadeNovas tentativas e replay cobrem as indisponibilidadesVocê precisa controlar o que já leu
Ideal paraStatus ao vivo e automaçãoPreenchimento retroativo e relatórios agendados

Muitas equipes usam webhooks para atualizações ao vivo e a API para preencher retroativamente o que perderam.

Recursos de IA

Webhooks e eventos com apoio de IA

Copilot

Resumos do fluxo de eventos

Um copilot condensa milhares de eventos em um resumo curto, como qual provedor está adiando e qual campanha gera reclamações, com links para as mensagens por trás de cada ponto.

Preditivo

Detecção de anomalias em eventos

Os modelos aprendem as taxas normais de rejeição, reclamação e adiamento e avisam quando um fluxo foge delas. Você define quem é notificado e se alguma automação é executada.

Assistência

Assistente de depuração de payloads

Cole o log de uma entrega com falha e o assistente explica a causa provável, como uma assinatura que não confere ou um timeout, e sugere uma correção para testar. A alteração é feita por você.

Pronto para agentes

Acesso a eventos pronto para agentes

Por meio de um servidor MCP, agentes de IA podem ler o histórico de eventos e os logs de entrega com escopos somente leitura. Ações de escrita exigem escopos explícitos e, se você quiser, aprovação humana.

Os recursos de IA são assistivos: eles resumem e alertam, e qualquer ação automatizada é algo que sua equipe configura e aprova.

Boas práticas

Boas práticas para webhooks e eventos

Verifique a assinatura sempre

Rejeite as requisições cujo cabeçalho de assinatura não confere. Troque o segredo periodicamente e imediatamente se ele puder ter sido exposto.

Responda rápido, trabalhe de forma assíncrona

Confirme com um 2xx assim que o payload estiver armazenado com segurança e depois processe-o a partir de uma fila. Handlers lentos causam timeouts e novas tentativas duplicadas.

Projete para duplicatas e desordem

As entregas podem se repetir e chegar fora de ordem. Use o ID da mensagem e o horário para deduplicar e para ignorar mudanças de estado obsoletas.

Assine apenas o que você usa

Filtre os eventos por endpoint. Menos requisições irrelevantes significam menos carga nos seus servidores e um monitoramento mais simples. Mantenha as integrações enxutas e fáceis de depurar.

Monitore o seu próprio endpoint

Configure alertas para falhas repetidas no log de entrega. Uma indisponibilidade silenciosa significa uma deriva silenciosa nos dados até que alguém reenvie o intervalo perdido.

Confirme rápido, processe depois

Retorne uma resposta 2xx rapidamente e passe o trabalho pesado para uma fila, para que handlers lentos não disparem novas tentativas.

Perguntas frequentes

Webhooks e eventos: perguntas frequentes

Precisa de ajuda para configurar um endpoint? Nossa equipe pode revisá-lo com você antes do lançamento.

O que é um webhook de e-mail?

Um webhook de e-mail é uma requisição HTTP que seu provedor de e-mail envia ao seu servidor quando ocorre um evento, como uma mensagem ser entregue ou rejeitada. Ele permite que seu aplicativo reaja em tempo real sem consultar a API repetidamente. Isso substitui os jobs de polling e mantém seus registros atualizados.

Como verifico a assinatura de um webhook?

Cada requisição inclui um cabeçalho de assinatura gerado com o segredo do seu endpoint. Recalcule a assinatura a partir do corpo bruto da requisição no seu lado e compare. Rejeite a requisição se forem diferentes. A documentação tem exemplos de código.

Quais eventos posso receber?

Entregue, adiado, rejeitado, aberto, clicado, reclamado e cancelado. Você pode inscrever cada endpoint em um subconjunto, de modo que um serviço receba as rejeições e outro receba os eventos de engajamento. Escolha apenas os que seus sistemas usam, como rejeições para supressão e cliques para análises, para manter o tráfego do seu endpoint pequeno e relevante.

O que acontece se o meu endpoint estiver fora do ar?

As entregas que falham são repetidas com backoff, e você pode reenviar eventos do log assim que se recuperar. Cada tentativa, com requisição e resposta, é registrada para você ver o que falhou. Verifique se o seu handler responde rápido e registra as falhas.

Os eventos de webhook são entregues em ordem?

Não conte com uma ordem estrita. Crie handlers que tolerem duplicatas e eventos fora de ordem usando o ID da mensagem e o horário. A ordem dos eventos pode variar entre provedores e novas tentativas, e uma única mensagem pode gerar vários eventos.

O que são aberturas de bots?

Alguns sistemas de e-mail buscam imagens automaticamente, o que é registrado como abertura mesmo que nenhuma pessoa tenha lido a mensagem. Separamos essas aberturas das humanas sempre que possível, mas o rastreamento de aberturas continua sendo uma estimativa. Trate as aberturas como um indicador aproximado. Considere cliques e respostas como sinais mais fortes de engajamento.

Como testo um endpoint de webhook?

Envie um evento de exemplo do painel para a sua URL e confira se o seu handler verifica a assinatura e retorna um 2xx. Veja no log de entrega a requisição e a sua resposta. Use um endpoint de staging com um segredo de teste antes da produção. Faça isso antes de apontar a produção para o endpoint.

Como a IA funciona com webhooks e eventos?

A IA pode resumir fluxos de eventos, sinalizar padrões incomuns de rejeição ou reclamação e ajudar a depurar entregas com falha. Ela recomenda ações, mas não altera a sua configuração, a menos que você crie uma regra. Revise os logs recentes antes de conectar novos endpoints.

Como testo um endpoint?

Envie um evento de exemplo do painel.

A ordem é garantida?

Crie handlers que tolerem duplicatas e eventos fora de ordem, usando o ID da mensagem e o horário para deduplicar.

Comece a enviar em minutos.

Crie uma conta, adicione seu domínio e envie seu primeiro e-mail.