Necesitará una cuenta de Mailgun y acceso al DNS de su dominio.
Documentación propia de Mailgun: Cómo añadir y verificar un dominio · Claves de API · Registrarse
1. Añada su dominio de envío a Mailgun
En el panel de control de Mailgun, vaya a Send → Domains → Add New Domain e introduzca un subdominio, por ejemplo mail.yourdomain.com.
⚠️ La recomendación propia de Mailgun es utilizar un subdominio, y aquí es más importante que con otros proveedores: Mailgun establece sus propios registros SPF y DKIM en lo que usted le proporcione, y apuntarlo a su dominio raíz significa que esos registros convivirán junto a aquellos de los que dependen los buzones de correo de su empresa.
Elija la región que coincida con el lugar donde desea que residan sus datos: US o EU. Anótela; la necesitará en el paso 4, y es el error más común de todos.
2. Publique los registros DNS que Mailgun le proporciona
Mailgun le muestra una lista. Añada cada uno de ellos en su proveedor de DNS.
| Type | Host | Purpose |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | Clave pública DKIM |
CNAME | email.mail.yourdomain.com | Seguimiento y gestión de rebotes |
MX | mail.yourdomain.com | Recepción de rebotes (los dos hosts MX de Mailgun) |
⛔ Si su subdominio de envío ya tiene un registro SPF, edítelo; no añada un segundo. Un dominio con dos registros SPF TXT falla el SPF por completo, lo cual es peor que no tener ninguno.
A continuación, pulse Verify DNS Settings en Mailgun. Puede tardar hasta una hora en ponerse verde.
⭐ Añada los registros MX aunque solo vaya a enviar. Son la forma en que Mailgun recopila los rebotes. Sin ellos, una dirección errónea rebota a ninguna parte, Mailgun no puede suprimirla y usted seguirá pagando por enviar a una dirección que nunca recibirá nada.
3. Obtenga su clave de API
Send → Sending → Domain settings → API keys, o la página API Keys de su cuenta.
Utilice una clave de envío restringida a este dominio si su plan la ofrece, en lugar de la clave de API privada de su cuenta. Una clave de envío solo puede enviar; la clave privada puede leer sus registros y modificar su cuenta. No hay razón para que nosotros conservemos la segunda.
4. Conéctelo en Zinn®
Abra Email sending en su panel de control y complete:
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com (un dominio, no una dirección)
- Mailgun sending domain — el mismo dominio que añadió en Mailgun
- Region —
us o eu, coincidiendo con el paso 1
- Mailgun API key — la clave del paso 3
⛔⛔ Asegúrese de elegir la región correcta. Las cuentas de Mailgun alojadas en EU se gestionan desde un host de API completamente diferente. Enviar la clave de una cuenta de EU al host de US devuelve «401 Unauthorized», lo que parece exactamente una clave incorrecta. Si su clave es definitivamente correcta y recibe un error 401, este es casi siempre el motivo.
5. Envíe la prueba e introduzca el código
Pulse Send test message, utilizando una bandeja de entrada en un dominio diferente; una dirección de Gmail es ideal. Lea el código de esa bandeja de entrada e introdúzcalo. Su correo cambiará inmediatamente.
Cuando no funciona
401 Unauthorized — región incorrecta (consulte más arriba) o ha pegado una clave de una cuenta de Mailgun diferente. Regenere la clave en lugar de volver a escribirla; es fácil omitir el prefijo key-.
El mensaje de prueba nunca llega — consulte la página Logs de Mailgun. Si Mailgun no tiene constancia del mismo, la credencial o el nombre de dominio son incorrectos. Si Mailgun lo aceptó y falló después, el motivo se indicará allí con claridad, y casi siempre se debe al DNS.
«Domain not found» — el campo Mailgun sending domain debe ser exactamente el dominio tal como lo lista Mailgun, incluido el subdominio. yourdomain.com y mail.yourdomain.com son dos dominios diferentes para Mailgun.
Funcionó y luego dejó de hacerlo — compruebe si ha finalizado su periodo de prueba gratuita. Las cuentas de prueba de Mailgun solo pueden enviar a destinatarios autorizados, por lo que el mensaje de prueba a su propia dirección sigue funcionando mientras que todo lo dirigido a sus clientes falla de forma silenciosa.