A partir da aplicação
- Abra Configurações → Webhooks e clique em Criar um webhook.
- Indique o URL de notificação: um endereço
https://acessível a partir da Internet (os endereços locais ou privados são recusados). Deve responder em menos de 10 segundos. - Assinale os eventos a receber (lista completa) e confirme.
O segredo de assinatura é mostrado uma única vez. Copie-o imediatamente para um gestor de palavras-passe: serve para verificar que as chamadas vêm realmente da Mailpro. Perdeu-o? Utilize «Renovar o segredo».
O webhook fica ativo cerca de 10 minutos após a criação, o tempo de sincronização dos nossos servidores.
Testar
Na lista, menu Mais ações → Enviar um ping de teste: escolha um tipo de evento e um exemplo de dados é enviado de imediato para o seu URL. Ver histórico de entregas mostra cada tentativa (data, estado HTTP, latência, número da tentativa) e permite repetir uma entrega.
A partir da API
As mesmas operações existem para as suas integrações: POST /api/v3/Webhook (criação, devolve o segredo uma única vez), POST /api/v3/Webhook/{id}/test, GET /api/v3/Webhook/{id}/deliveries, POST /api/v3/Webhook/{id}/rotate-secret, DELETE /api/v3/Webhook/{id}. Detalhes e exemplos no portal de programadores.
Limites
- 20 webhooks por conta, 50 eventos por webhook.
- Um webhook desativado (manualmente ou após 10 falhas consecutivas) reativa-se com um clique: o que acontece em caso de falha?
- A eliminação apaga também o histórico de entregas, de forma definitiva.