Este módulo integra los eventos de mail_tracking con los webhooks de Mailgun.
Mailgun es un servicio que proporciona una infraestructura de envío de correo electrónico a través de un servidor SMTP o mediante API. También puedes consultar esa API para ver estadísticas de tus correos enviados, o proporcionar hooks que procesen los cambios de estado en tiempo real, que es la función utilizada aquí.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Conecta Odoo a Mailgun para que los correos enviados se rastreen automáticamente: la entrega, las aperturas, los clics, los rebotes y las quejas de spam se registran, y puedes consultar o forzar el estado de correo de un contacto desde el formulario del partner.
Este módulo vincula el seguimiento de correo electrónico de Odoo con el servicio de envío Mailgun. Una vez que introduzcas tus claves de Mailgun en Ajustes, Odoo puede registrar webhooks de Mailgun para que los cambios de estado de los correos enviados (entregado, abierto, clicado, dado de baja, reclamado, fallido, rechazado) se importen automáticamente en los registros de seguimiento de correo.
Dónde aparece: - Ajustes: una sección Mailgun con campos para la clave de API, la clave de firma de webhook, la clave de validación, el endpoint de API, el dominio y el dominio de webhooks, además de botones para registrar o anular el registro de los webhooks de Mailgun. - Formulario de contacto: un área Mailgun con botones para comprobar el correo electrónico contra la lista de rebotes de Mailgun, comprobar la validez del correo electrónico, establecer rebotado y quitar rebotado. - Formulario de seguimiento de correo electrónico: un botón 'Re-sync Mailgun' para obtener de nuevo los eventos desde la API de Mailgun para ese mensaje.
Reglas de negocio y comportamiento automático: - Los eventos entrantes de Mailgun se emparejan con la base de datos de Odoo y el registro de seguimiento correctos; los duplicados se ignoran gracias a un ID de evento de Mailgun único. - Las llamadas de webhook se rechazan si son demasiado antiguas, ya se han procesado o tienen una firma incorrecta. - Cuando un correo electrónico rebota, se publica un mensaje en el registro del contacto con el motivo y el evento. - La comprobación de validez marca el contacto como rebotado y publica una advertencia cuando la dirección no es válida o falla la verificación del buzón.
Toca mail.tracking.email, mail.tracking.event, res.partner, res.config.settings y el servidor de correo saliente.
Depende de
Modelos y campos (4)
- res.partner · amplía un modelo existente
- mail.tracking.email · amplía un modelo existente
- mail.tracking.event · amplía un modelo existentemailgun_id (Mailgun Event ID)
- res.config.settings · amplía un modelo existentemail_tracking_mailgun_domain (Mailgun domain), mail_tracking_mailgun_api_key (Mailgun API key), mail_tracking_mailgun_api_url (Mailgun API endpoint), mail_tracking_mailgun_enabled (Enable mail tracking with Mailgun), mail_tracking_mailgun_validation_key (Mailgun validation key), mail_tracking_mailgun_webhooks_domain (Mailgun webhooks domain), mail_tracking_mailgun_webhook_signing_key (Mailgun webhook signing key)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 8 confirmadas, 1 sin información de 9 versiones.
Fuentes · Odoo 19.0
Confirmado el 2026-11-03 en la rama 19.0 de OCA/mail.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Instalación
Fuente · Odoo 19.0Si utilizas una instalación multi-base de datos (con o sin la opción dbfilter) en la que /web/databse/selector devuelve una lista de más de una base de datos, entonces necesitas añadir el addon mail_tracking_mailgun a la lista de addons de carga amplia (por defecto, solo el addon web), estableciendo la opción --load.
Ejemplo: --load=web,mail_tracking,mail_tracking_mailgun
Configuración
Fuente · Odoo 19.0Para configurar este módulo, debe:
- Ir a Mailgun, crear una cuenta y validar su dominio de envío.
- Volver a Odoo.
- Ir a Settings \> General Settings \> Discuss \> Enable mail tracking with Mailgun.
- Rellenar todos los valores. El único obligatorio es la API key.
- Opcionalmente, hacer clic en Unregister Mailgun webhooks y aceptar.
- Hacer clic en Register Mailgun webhooks.
También puede configurar el timeout para mailgun con este parámetro del sistema:
mailgun.timeout: Establézcalo en un número de segundos.
En tus pantallas de estado de seguimiento de correo (explicadas en el módulo mail_tracking), verás una información más precisa, como el estado 'Received' o 'Bounced', que normalmente no son detectados por los servidores SMTP normales.
También es posible hacer algunas comprobaciones a las direcciones de correo de los contactos contra la API de Mailgun:
- Comprobar si el correo del contacto está en la lista de rebotados de Mailgun.
- Comprobar la validez del buzón del contacto.
- Forzar el correo del contacto en la lista de rebotados de Mailgun o eliminarlo de ella.
También es posible comprobar manualmente el seguimiento de un mensaje de Mailgun cuando el webhook no pudo ser capturado. Para ello, ve al formulario de seguimiento de ese mensaje y pulsa el botón Check Mailgun. Es importante tener en cuenta que los eventos de seguimiento tienen una vida útil bastante corta, por lo que después de 24h no serán recuperables.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.