Desde la aplicación
- Abra Configuraciones → Webhooks y haga clic en Crear un webhook.
- Indique la URL de notificación: una dirección
https://accesible desde Internet (se rechazan las direcciones locales o privadas). Debe responder en menos de 10 segundos. - Marque los eventos a recibir (lista completa) y confirme.
El secreto de firma se muestra una sola vez. Cópielo de inmediato en un gestor de contraseñas: sirve para comprobar que las llamadas provienen realmente de Mailpro. ¿Lo perdió? Use «Renovar el secreto».
El webhook está activo unos 10 minutos después de su creación, el tiempo que tardan nuestros servidores en sincronizarse.
Probar
En la lista, menú Más acciones → Enviar un ping de prueba: elija un tipo de evento y se envía de inmediato un ejemplo de datos a su URL. Ver historial de entregas muestra cada intento (fecha, estado HTTP, latencia, número de intento) y permite reintentar una entrega.
Desde la API
Las mismas operaciones existen para sus integraciones: POST /api/v3/Webhook (creación, devuelve el secreto una sola 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}. Detalles y ejemplos en el portal para desarrolladores.
Límites
- 20 webhooks por cuenta, 50 eventos por webhook.
- Un webhook desactivado (manualmente o tras 10 fallos consecutivos) se reactiva con un clic: ¿qué ocurre en caso de fallo?
- La eliminación borra también el historial de entregas, de forma definitiva.
Mailpro y los webhooks
Más allá de configurar un webhook: integre el email en su producto
El SMTP y la API de Mailpro entregan su correo transaccional y de marketing con eventos en tiempo real, para que su app siempre sepa qué ha pasado.