Receba Notificações Instantâneas com Webhooks de Email
Integre webhooks de API de email para receber atualizações em tempo real sobre aberturas, cliques, rejeições e mais.
Webhooks de email são callbacks HTTP acionados por eventos de email. Eles permitem que seu aplicativo receba dados em tempo real sem polling. Com os webhooks de API de email do Emailer, você pode automatizar fluxos de trabalho e manter-se informado instantaneamente.
Gerador de código de envio de e-mail
Preencha os campos e copie um snippet pronto para executar no seu idioma.
Streaming de Eventos em Tempo Real
Receba notificações de webhook de eventos de email instantaneamente à medida que ocorrem. Chega de polling ou atrasos – seu aplicativo permanece sincronizado com cada envio, abertura, clique e rejeição.
Filtros de Payload Personalizados
Filtre quais eventos de email disparam seu webhook. Inscreva-se apenas nos eventos importantes – como rejeições ou denúncias de spam – reduzindo tráfego e processamento desnecessários.
Repetição e Registro
O Emailer repete automaticamente as entregas de webhook com falha usando backoff exponencial. Um registro detalhado mostra tentativas de entrega, códigos de status e payloads para solução de problemas.
O que são webhooks de email?
Webhooks de email são mensagens automatizadas enviadas de um serviço de email (como o Emailer) para o seu servidor quando eventos específicos ocorrem. Em vez de fazer polling constante por atualizações, seu sistema recebe passivamente dados de eventos via requisições HTTP POST. Eventos de email comuns incluem rejeições, aberturas, cliques, denúncias de spam e entregas.
Cada payload de webhook contém dados estruturados (JSON) com detalhes sobre o evento, como endereço do destinatário, timestamp, tipo de evento e metadados da campanha. Isso permite que você acione ações personalizadas em tempo real sem intervenção manual ou chamadas de API.
Como os webhooks de eventos de email melhoram a entregabilidade e o engajamento
Ao se inscrever em webhooks de eventos de email, você pode detectar instantaneamente rejeições duras e remover endereços inválidos da sua lista, preservando a reputação do remetente. Um webhook de API de email para aberturas e cliques permite segmentar assinantes engajados e reengajar os inativos.
Reações automatizadas a denúncias de spam via webhooks ajudam a identificar problemas de qualidade da lista precocemente. Loops de feedback em tempo real reduzem as taxas de reclamação e melhoram a colocação na caixa de entrada. Em última análise, os webhooks de email transformam dados brutos de eventos em insights acionáveis para um melhor desempenho das campanhas.
Configurando webhooks de API de email com o Emailer
Para configurar webhooks de API de email no Emailer, navegue até a seção Webhooks em Configurações. Insira a URL do seu endpoint (deve aceitar requisições POST), selecione os eventos aos quais deseja se inscrever (ex.: enviado, entregue, aberto, clicado, rejeitado, denunciado) e, opcionalmente, defina uma chave secreta para validação HMAC.
Após salvar, o Emailer começará imediatamente a enviar requisições HTTP POST para seu endpoint para cada evento inscrito. Você também pode especificar o timeout de resposta e a política de repetição. Para envios de alto volume, considere usar um manipulador de webhook dedicado para evitar gargalos.
Melhores práticas para lidar com webhooks de email
Sempre verifique a autenticidade do webhook validando a assinatura HMAC incluída no cabeçalho `X-Emailer-Signature`. Isso impede que atores maliciosos enviem eventos falsos. Além disso, certifique-se de que seu endpoint responda com 200 OK o mais rápido possível para confirmar o recebimento.
Projete seu consumidor de webhook para ser idempotente: armazene um ID de evento único e ignore duplicatas. Implemente backoff exponencial para entregas com falha (o Emailer repete até 3 vezes). Por fim, registre todos os webhooks recebidos para depuração e trilhas de auditoria.
Gerenciamento Automatizado de Cancelamento de Inscrição
Use webhooks de email para detectar instantaneamente rejeições e denúncias de spam. Remova automaticamente esses contatos das suas listas para manter uma reputação de remetente saudável.
E-mails de Acompanhamento Personalizados
Dispara um e-mail de acompanhamento quando alguém abre sua campanha mas não clica. Com os dados de webhook de eventos de email, você pode enviar mensagens sensíveis ao contexto para aumentar as conversões.
Detecção de Fraude
Monitore padrões incomuns em eventos de email (ex.: aberturas rápidas de diferentes IPs) via webhooks de API de email. Sinalize atividades suspeitas e evite abuso de conta ou credential stuffing.
FAQ
Qual é a diferença entre webhooks e polling de API?
Webhooks enviam dados para o seu servidor imediatamente quando um evento ocorre, enquanto o polling exige que seu servidor solicite atualizações periodicamente. Webhooks são mais eficientes e fornecem notificações em tempo real, tornando-os ideais para eventos de email sensíveis ao tempo.
Como verifico webhooks de email do Emailer?
O Emailer assina cada payload de webhook com uma chave secreta usando HMAC-SHA256. A assinatura é passada no cabeçalho `X-Emailer-Signature`. Calcule o HMAC do corpo da requisição bruta usando sua chave secreta e compare com esse cabeçalho para garantir a autenticidade.
Posso usar webhooks de email para múltiplos eventos?
Sim. Nas configurações de webhook do Emailer, você pode se inscrever em qualquer combinação de eventos, como enviado, entregue, aberto, clicado, rejeitado e denunciado. Você também pode criar webhooks separados para diferentes grupos de eventos.
O que acontece se meu servidor estiver indisponível quando um webhook for enviado?
O sistema de webhook do Emailer repete a entrega até três vezes com atrasos crescentes (aproximadamente 5 minutos, 15 minutos e 1 hora). Se todas as tentativas falharem, o evento é registrado e você pode verificar os logs de webhook para detalhes.
Como testar webhooks de email antes de ir ao ar?
Use uma ferramenta de teste de webhook como RequestBin ou Webhook.site para capturar payloads recebidos. No Emailer, defina seu endpoint de webhook para essa URL de teste, envie um e-mail de teste e inspecione a estrutura do payload e os cabeçalhos.
Pronto para integrar webhooks de email?
Inicie seu teste gratuito e configure webhooks de eventos de email em minutos.
Crie sua conta grátis