Guía práctica
Añadir un dominio de envío
Añade tu dominio a Emailit, publica los registros DNS que genera, envíaselos a un desarrollador si hace falta y verifica el dominio para poder enviar.
Esta guía te explica cómo añadir un dominio de envío, publicar sus registros DNS y verificarlo. Lleva unos minutos de trabajo, más el tiempo que tarde tu proveedor de DNS en publicar los registros.
Antes de empezar
- Necesitas acceso a la configuración DNS del dominio, o a alguien que lo tenga. Puedes enviarle los registros por email.
- Decide desde qué dominio vas a enviar. Usar un subdominio como
mail.acme.commantiene tu reputación de envío separada de la de tu dominio raíz. Consulta ¿Dominio raíz o subdominio? - Comprueba que tu plan admite otro dominio. Consulta Límites de dominios.
- Para la API, usa una clave de API con Full Access. Las claves solo de envío no pueden gestionar dominios.
Reglas del nombre de dominio
- Introduce el dominio sin más:
acme.comomail.acme.com. No incluyashttp://,https://ni el prefijowww.. - Usa letras, dígitos, guiones y puntos, con un dominio de primer nivel de al menos dos letras. Emailit guarda el nombre en minúsculas.
- Se admiten subdominios de cualquier profundidad, por ejemplo
eu.mail.acme.com. Cada uno es un dominio independiente con sus propios registros. - Un nombre solo se puede añadir una vez por espacio de trabajo. Si lo añades otra vez, se devuelve
409 Domain with this name already exists.
Añadir el dominio
-
Abre Domains. Ve a Email APIDomains y selecciona Add domain.
Si el botón está desactivado, tu espacio de trabajo ha alcanzado su límite de dominios. El distintivo junto al título de la página muestra cuántos has usado.
-
Introduce el dominio. En Name, escribe el dominio desde el que envías, por ejemplo
mail.acme.com, y selecciona Create. -
Revisa los registros. Emailit abre la página del dominio en la pestaña DNS Setup. Muestra cada registro con su tipo, nombre, valor, prioridad y TTL, y un botón para copiar cada valor.
Llama a Crear un dominio con el nombre del dominio.
curl https://api.emailit.com/v2/domains \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "mail.acme.com" }'La respuesta 201 incluye el id del dominio y un array dns_records con todos los registros que tienes que publicar:
{
"object": "domain",
"id": "dom_2kq8Vt4xLm7Rz",
"name": "mail.acme.com",
"verification_status": "pending",
"manual_review_required": false,
"spf_status": "pending",
"dkim_status": "pending",
"return_path_status": "pending",
"dns_records": [
{
"required": true,
"type": "MX",
"name": "emailit.mail.acme.com",
"value": "feedback-smtp.ffdc-1.emailit.com",
"priority": 10,
"ttl": "auto",
"status": "pending",
"error": null
},
{
"required": true,
"type": "TXT",
"name": "emailit.mail.acme.com",
"value": "v=spf1 include:_spf.emailit.com ~all",
"priority": null,
"ttl": "auto",
"status": "pending",
"error": null
}
]
}La respuesta completa muestra los seis registros, incluidos DKIM, DMARC, seguimiento y entrada. También puedes definir estos campos opcionales al crear el dominio:
| Campo | Valor por defecto | Descripción |
|---|---|---|
tracking_key |
go |
Prefijo del subdominio para el CNAME de seguimiento. Consulta Dominio de seguimiento personalizado. |
inbound_key |
inbound |
Prefijo del subdominio para el registro MX de entrada. |
dmarc_reports |
false |
Añade la dirección de informes de Emailit al registro DMARC sugerido. Solo en los planes Pro, Business y Custom; en los demás, 403 plan_required. |
track_loads y track_clicks no se pueden activar al crear un dominio, porque el seguimiento necesita antes un CNAME de seguimiento verificado. Enviar true devuelve 422.
No hay un interruptor aparte para el correo saliente o entrante. Un dominio verificado puede enviar, y recibe email entrante en cuanto se publica su registro MX de entrada. La API acepta los indicadores outgoing e incoming por compatibilidad, pero no cambian el comportamiento del dominio.
Publicar los registros DNS
Añade los registros en la empresa que aloja los DNS de tu dominio. Suele ser tu registrador (GoDaddy, Namecheap) o un servicio de DNS (Cloudflare, Amazon Route 53).
| Registro | Tipo | Host | Qué hacer |
|---|---|---|---|
| Return-path | MX | emailit.<domain> |
Obligatorio. Prioridad 10. |
| SPF | TXT | emailit.<domain> |
Obligatorio. |
| DKIM | TXT | emailit._domainkey.<domain> |
Obligatorio. Pega el valor completo. |
| DMARC | TXT | _dmarc.<domain> |
Recomendado. Omítelo si el dominio ya tiene un registro DMARC. |
| Seguimiento | CNAME | go.<domain> |
Solo si quieres seguimiento de aperturas y clics. |
| Entrada | MX | inbound.<domain> |
Solo si quieres recibir email. Prioridad 10. |
La mayoría de los proveedores de DNS solo quieren en el campo del host la parte anterior a tu dominio (emailit, no emailit.acme.com). Registros DNS tiene los valores exactos, consejos para cada proveedor y los errores habituales.
Si tu dominio usa los DNS de Cloudflare, la página del dominio ofrece Set up with Cloudflare, que crea los registros por ti. Consulta Configurar los DNS con Cloudflare.
Enviar los registros a otra persona
Si otra persona gestiona tus DNS, envíale los registros por email desde el panel.
-
Abre el dominio. En Email APIDomains, selecciona el dominio.
-
Selecciona Send to email. Está en la esquina superior derecha de la tarjeta DNS Setup.
-
Introduce su dirección. En Recipient Email, escribe la dirección de tu desarrollador o de tu administrador de TI y selecciona Send Instructions.
Recibirá un email de Emailit con todos los registros y sus valores. Pídele que te avise cuando estén publicados para que puedas ejecutar la comprobación.
Comprobar los DNS y verificar
En la página del dominio, selecciona Check DNS. Emailit consulta todos los registros y actualiza el estado junto a cada uno: OK, Missing, Invalid o Not checked. Pasa el cursor por encima de Missing o Invalid para ver lo que ha encontrado Emailit.
Llama a Verificar un dominio. Puedes usar el ID del dominio o su nombre.
curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY"La respuesta contiene el dominio actualizado. Comprueba verification_status y el status y el error de cada elemento de dns_records.
El dominio queda verificado cuando SPF, DKIM y el return-path muestran OK. DMARC, el seguimiento y la entrada son opcionales y no afectan a la verificación.
Comprobar que funciona
- El dominio muestra Verified en Email APIDomains, y las columnas SPF, DKIM y Return Path muestran OK.
- Envía un mensaje de prueba desde una dirección del dominio. En la página Emails, selecciona Compose, o llama a Enviar un email.
Si el dominio muestra Pending verification, está pendiente de una revisión manual. Esto se aplica a los dominios de Pay as you go registrados hace menos de 30 días. Consulta Verificación del dominio.
Solución de problemas
| Problema | Solución |
|---|---|
| Add domain está desactivado | Has alcanzado el límite de dominios de tu plan. Elimina un dominio que no uses o amplía el límite. Consulta Límites de dominios. |
The domain must be in apex format |
Quita http://, https:// o www. y asegúrate de que el nombre termina en un dominio de primer nivel real. |
| Los registros muestran Missing después de una hora | Probablemente el host está duplicado, por ejemplo emailit.acme.com.acme.com. Introduce solo emailit en el campo del host. |
| DKIM muestra Invalid | Se ha cortado parte del valor. Vuelve a copiarlo con el botón de copiar. |
Verificación del dominio cubre más casos.