Os webhooks permitem que a sua aplicação receba notificações automáticas do Mailpro quando ocorrem eventos específicos: um email foi aberto, um link foi clicado, um bounce foi registado, ou um subscritor cancelou a subscrição. Ao contrário de polling (consultar a API periodicamente), os webhooks entregam a informação imediatamente quando o evento ocorre — com latência tipicamente inferior a 1 segundo.
Eventos disponíveis via webhook
email.delivered: Confirmação de entrega pelo servidor de destino.
email.opened: O destinatário abriu o email. Inclui timestamp, dispositivo e cliente de email.
email.clicked: Um link foi clicado. Inclui o URL específico, timestamp e informação do dispositivo.
email.bounced: O email não foi entregue. O payload inclui o tipo de bounce (hard ou soft) e o código de erro SMTP.
email.complained: O destinatário marcou o email como spam. Este evento deve desencadear a remoção imediata do contacto das suas listas de marketing.
email.unsubscribed: O destinatário cancelou a subscrição. A sua aplicação deve processar este evento imediatamente para garantir conformidade com o RGPD.
Como configurar webhooks no Mailpro
Na secção de definições da API do Mailpro, configure um URL de endpoint na sua aplicação que receberá os pedidos HTTP POST com os payloads de evento. O Mailpro assina cada pedido com um segredo partilhado — verifique sempre esta assinatura antes de processar o payload, para garantir que o pedido é genuinamente do Mailpro.
Casos de uso práticos em Portugal
CRM em tempo real: Quando um potencial cliente abre um email de proposta comercial, o webhook atualiza automaticamente o registo no CRM e pode enviar uma notificação à equipa de vendas para follow-up imediato.
Conformidade RGPD automática: Ao receber um evento de cancelamento de subscrição, a sua aplicação remove imediatamente o contacto de todas as listas e regista a data/hora do cancelamento — sem intervenção manual.
Pontuação de leads: Atribua pontos a eventos de engagement (abertura = 1 ponto, clique = 3 pontos, clique em página de preços = 10 pontos) e atualize automaticamente a pontuação no CRM para priorizar follow-up comercial.
Limpeza automática de lista: Hard bounces são processados imediatamente via webhook, removendo o endereço das suas listas e protegendo a reputação do seu remetente.
Ver também: Integração API, Entregabilidade, CRM e Email