Dall'applicazione
- Aprite Impostazioni → Webhook e fate clic su Crea un webhook.
- Indicate l'URL di notifica: un indirizzo
https://raggiungibile da Internet (gli indirizzi locali o privati sono rifiutati). Deve rispondere entro 10 secondi. - Selezionate gli eventi da ricevere (elenco completo) e confermate.
Il secret di firma viene mostrato una sola volta. Copiatelo subito in un gestore di password: serve a verificare che le chiamate arrivino davvero da Mailpro. Perso? Usate «Rinnova il secret».
Il webhook è attivo circa 10 minuti dopo la creazione, il tempo necessario ai nostri server per sincronizzarsi.
Testare
Nell'elenco, menu Altre azioni → Invia un ping di test: scegliete un tipo di evento e un esempio di dati viene inviato subito al vostro URL. Visualizza cronologia consegne mostra ogni tentativo (data, stato HTTP, latenza, numero di tentativo) e permette di riprovare una consegna.
Dall'API
Le stesse operazioni esistono per le vostre integrazioni: POST /api/v3/Webhook (creazione, restituisce il secret una sola volta), POST /api/v3/Webhook/{id}/test, GET /api/v3/Webhook/{id}/deliveries, POST /api/v3/Webhook/{id}/rotate-secret, DELETE /api/v3/Webhook/{id}. Dettagli ed esempi nel portale sviluppatori.
Limiti
- 20 webhook per account, 50 eventi per webhook.
- Un webhook disattivato (manualmente o dopo 10 errori consecutivi) si riattiva con un clic: cosa succede in caso di errore?
- L'eliminazione cancella anche la cronologia delle consegne, in modo definitivo.