Dominios
Verifica un dominio de envío, añade sus registros DNS y configúralo para el rastreo, la recepción y el calentamiento.
Todo email debe enviarse desde un dominio que tu equipo haya verificado. Cualquier otra dirección en from se rechaza con 422. Añade y verifica dominios en el panel, en Dominios, o con la API.
Añadir y verificar un dominio
curl -X POST https://api.billionsend.com/domains \
-H "Authorization: Bearer $BILLIONSEND_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "mail.example.com" }'
La respuesta lista los registros DNS que debes añadir en tu proveedor de DNS. Un subdominio como mail.example.com es una buena opción para un dominio de envío. Cuando los registros estén activos, pulsa Verificar en la página del dominio o llama a POST /domains/{id}/verify.
| Registro | Para qué sirve |
|---|---|
DKIM (dos CNAME, bs1._domainkey y bs2._domainkey) |
Firma tu correo para que los proveedores sepan que es tuyo. |
| MAIL FROM (MX y TXT) | Una dirección de rebote en tu propio dominio, para que SPF se alinee. |
| DMARC (TXT, recomendado) | Indica a los proveedores qué hacer con el correo que no pasa las comprobaciones. No bloquea el envío. |
DKIM y MAIL FROM deben estar verificados antes de que puedas enviar. En Cloudflare, mantén estos registros en Solo DNS (nube gris).
La página del dominio muestra cada registro como encontrado, ausente o con valor distinto, comprobado en directo contra el DNS público. GET /domains/{id} devuelve lo mismo en records[]. Cada registro tiene un status (not_started, pending, verified o failed), un valor live con lo que responde ahora el DNS público y un detail breve cuando algo va mal.
Las claves DKIM rotan solas
BillionSend crea una clave DKIM para cada dominio y la sustituye cada 180 días, alternando entre los dos CNAME. Añades los registros una vez y no vuelves a tocarlos. Puedes desactivar la rotación automática en la pestaña Configuración del dominio.
Región
POST /domains acepta un region opcional. Un dominio vive en una sola región. Para moverlo, elimínalo y vuelve a añadirlo en la otra región; sus registros DNS cambian.
Límites del plan
| Free | Starter | Pro y Scale | |
|---|---|---|---|
| Dominios de envío por equipo | 3 | 10 | Ilimitados |
Al pasar el límite, POST /domains responde 403 plan_limit_reached. Un nombre de dominio que ya tiene otro equipo responde 409.
Calentamiento de un dominio nuevo
Un dominio recién registrado envía un volumen diario limitado mientras construye su reputación. El tope depende de la antigüedad del dominio registrado (example.com para mail.example.com) y se cuenta por día UTC:
| Antigüedad del dominio | Emails por día |
|---|---|
| Menos de 1 día | 100 |
| De 1 a menos de 7 días | 300 |
| De 7 a menos de 30 días | 2000 |
| 30 días o más | Solo el límite de tu plan |
- Un dominio que envía bien, con pocos rebotes y sin quejas, sube de escalón antes.
- El tope se aplica además de tu plan. Mejorar de plan no lo levanta.
- Tus dominios nuevos comparten un único volumen diario: añadir otro dominio nuevo no suma volumen.
- El correo que supera el tope no se pierde. Aparece como En espera y sale al día siguiente, empezando por el más antiguo. Si ya hay mucho correo en espera, un envío responde
429 daily_quota_exceeded; reintenta cuando cambie el día UTC.
La página del dominio muestra «Calentando: N/día hoy» mientras se aplica un tope. Consulta Límites de envío para ver todas las protecciones del envío.
Configuración
Una vez verificado el dominio, tienes disponibles estos ajustes:
- Seguimiento de aperturas y clics. Ambos están desactivados por defecto. Actívalos en la pestaña Enlaces del dominio, o con
open_trackingyclick_trackingenPATCH /domains/{id}. Consulta Rastreo. - Subdominios propios de rastreo y de baja. Sirve los enlaces rastreados y los enlaces de baja desde tu propio dominio. Requiere un plan de pago. Consulta Rastreo.
- Página de baja. El aspecto de la página que ven tus destinatarios: nombre, logo, colores y textos. Defínelo en la pestaña Marca del dominio, o con
unsubscribe_pageenPATCH /domains/{id}. Consulta Bajas. - TLS obligatorio. Entrega solo a servidores que admiten TLS. Defínelo en la pestaña Configuración.
- Nombre del remitente, dirección del remitente y reply-to por defecto. Defínelos en la pestaña Configuración.
Recepción
Un dominio verificado también puede recibir correo. Actívalo con Activar la recepción en la página del dominio, o con PATCH /domains/{id}:
{ "capabilities": { "receiving": "enabled" } }
- Solo un dominio verificado puede activar la recepción.
POST /domainscon"receiving": "enabled"responde422: añade el dominio, verifícalo y después activa la recepción. - Al activarla se añaden dos registros de
Recepción: registros MX que apuntan amx1.billionsend-dns.comymx2.billionsend-dns.com, ambos con prioridad10. Publica los dos, para que un remitente que encuentre uno caído reintente con el otro. No afectan al envío. Si el dominio ya recibe correo en otro sitio, pon los registros MX en un subdominio comoinbound.example.com, porque un registro MX con número más bajo se quedaría con el correo. - Un nombre solo puede recibir en un equipo. Un nombre en el que ya recibe otro equipo responde
409. - Por defecto solo reciben correo las direcciones de tus bandejas de entrada. Catch-all acepta todas las direcciones del dominio. Requiere un plan de pago y se activa en el panel o con
receiving_catch_allenPATCH /domains/{id}.
Subdominio compartido
Cada equipo recibe también un subdominio en un dominio compartido de BillionSend, donde sus bandejas de entrada compartidas obtienen sus direcciones. Aparece al final de GET /domains con shared: true. Ya está verificado y es de solo lectura: PATCH, verificar y DELETE responden 403 forbidden, y no cuenta para el límite de dominios. Solo puede enviar desde las direcciones propias de tus bandejas de entrada.
Eliminar un dominio
DELETE /domains/{id}, o Eliminar en la página del dominio, se rechaza con 409 en dos casos:
- Un tema o segmento está ligado al dominio. Elimínalo, o pon su
domain_idennull. - Un envío masivo programado o en curso usa el dominio. Cancélalo, o espera a que termine de salir.
Eliminar un dominio también elimina sus bandejas de entrada. Las bajas de los destinatarios de ese dominio se conservan, y vuelven a aplicarse si añades de nuevo el mismo nombre.
Claves de API y dominios
Una clave de API se puede limitar a un dominio. Esa clave solo puede enviar desde ese dominio, y cualquier otro from responde 403 restricted_api_key. Solo lee el correo recibido en ese dominio, solo ve y modifica ese dominio en /domains (cualquier otro dominio responde 404), y las claves que crea quedan limitadas al mismo dominio. Los webhooks, las supresiones, las plantillas y el resto de lo que pertenece a todo el equipo responden 403 restricted_api_key; la página de claves de API los lista. Una clave también se puede limitar a una bandeja de entrada.