Email-in con Mailgun

Mailgun es el otro proveedor de análisis de correo de uso frecuente. La configuración es un poco más compleja que la de Postmark (Rutas vs. servidores entrantes), pero funciona bien a escala.

Qué configurará

• Un dominio verificado en Mailgun.
• Una Ruta en ese dominio que apunte a Nura24.

Paso 1 — Agregar y verificar un dominio

En Mailgun, Sending → Domains → Add new domain.

Puede elegir:

• Usar un subdominio de su dominio existente — mg.acme.com. Agregue los registros DNS que Mailgun le indique (TXT para SPF, DKIM y además MX). Verifique.
• Usar el dominio sandbox de Mailgun para pruebas — sandboxabc123.mailgun.org. Limitado a destinatarios autorizados; no es para producción.

Mailgun requiere que el dominio esté verificado antes de que las Rutas puedan coincidir con él.

Paso 2 — Crear la Ruta

Receiving → Routes → Create Route.

• Prioridad: 10 (o el orden que corresponda si tiene varias rutas).
• Expresión de filtro: match_recipient("^tickets\+(.+)@your-mg-domain\.com$") — coincide con cualquier dirección tickets+<token>@… en su dominio verificado de Mailgun.
• Acciones:
  • forward("https://api.nura24.com/email/inbound?secret=<su-clave-de-plataforma>") — envía el mensaje analizado por POST a nosotros.
  • Opcionalmente también store() si desea conservar una copia en Mailgun para depuración.
• Descripción: "Tickets entrantes Nura24" o lo que le ayude a recordar.

Guarde la ruta.

Paso 3 — Registros MX

Los registros MX del dominio deben apuntar a los servidores de Mailgun. Mailgun le muestra los registros exactos cuando verificó el dominio en el paso 1; si usó un nuevo subdominio, ya los habrá configurado.

Si desea que el correo existente en acme.com siga funcionando, no apunte el MX del dominio raíz a Mailgun. Use un subdominio separado (mg.acme.com o inbox.acme.com) cuyo MX sea el de Mailgun.

Paso 4 — Probar

Envíe un correo a tickets+<su-token-de-bandeja>@su-dominio-mg.com. La pestaña Logs de Mailgun muestra el correo entrante; la acción de la Ruta debería ejecutarse; el ticket aparece en su espacio de trabajo en segundos.

Paso 5 — Informar a Nura24

Configuración → Tickets → confirme que la dirección mostrada coincide con su tickets+<token>@su-dominio-mg.com.

Problemas frecuentes con Mailgun

• Limitaciones del dominio sandbox — si está usando el sandbox de Mailgun durante las pruebas, solo los destinatarios autorizados por Mailgun pueden enviarle correos. Los clientes reales no pueden hacerlo. Para producción se necesita un dominio personalizado verificado.
• Modo MIME vs. analizado — la acción de Ruta forward() publica en el formato analizado de "Mensajes almacenados" de Mailgun. Nuestro analizador gestiona esto; no necesita cambiar ninguna otra configuración.
• Autenticación de webhooks — Mailgun firma los webhooks con HMAC. Actualmente usamos el secreto compartido en lugar de la verificación HMAC — páselo en la consulta o en el encabezado como se muestra en el ejemplo anterior.

Precios

Las Rutas de Mailgun se facturan por cantidad de correos entrantes. Consulte su precio actual — tienen un nivel Flex gratuito para volumen bajo.