Correos desde tu dominio: envío transaccional incluido en tu plan

Cuántos correos trae cada plan

Plan	Correos al día	Al mes, aproximado
Nébula	50	1.500
Órbita	100	3.000
Galaxia	300	9.000
Cosmos	1.000	30.000

Para que te hagas una idea de lo que vale: la capa gratis de SendGrid y de Mailgun es de 100 correos al día, y su primer plan de pago cuesta entre $15 y $20 al mes. Aquí va incluido y ya configurado.

Para que no haya confusión: qué son y qué no son

Son los correos que tu página escribe sola a tus clientes. «Recibimos tu pedido», «aquí está tu factura», «restablece tu contraseña», «tu envío va en camino». Salen a nombre de tu dominio, firmados, y llegan a la bandeja de entrada en vez de a la carpeta de spam — la configuración la dejamos lista nosotros, porque tu DNS ya vive aquí.

No son un buzón donde tú entras a leer. No hay webmail ni una cuenta tipo tunombre@tudominio.com para revisar mensajes; para eso te sigue sirviendo el Gmail o el correo que ya uses. Lo que resolvemos es lo otro: que tu web pueda hablar con tus clientes sin que contrates ni configures un servicio de envío aparte, que por separado cuesta entre $15 y $20 al mes.

Dicho en una frase: esto no es tu correo, es el correo de tu web.

Qué incluye tu plan

Todos los planes de pago traen correos incluidos cada día enviados desde tu propio dominio: confirmaciones de pedido, facturas, avisos, recuperación de contraseña. Salen firmados con DKIM y con SPF y DMARC configurados — nosotros escribimos esos registros por ti, porque tu DNS ya vive con nosotros. No copias nada, no verificas nada.

El plan de vista previa (gratis) no incluye correos: es la vitrina para enseñar tu página, no la operación del negocio.

Activarlo: un botón

1. Entra a tu panel → Mis dominios → tu dominio.
2. En la tarjeta «Correos desde tu dominio», presiona Activar correos de mi dominio.
3. Listo. El alta y los registros DNS quedan hechos en segundos.

Enviar desde tu app

Tu código llama a nuestro endpoint con el token de tu sitio (el mismo de la consola de base de datos, botón «Ver token» en tu panel):

POST https://yapanel.yadominios.com/api/hosting/correo/enviar
Content-Type: application/json

{
  "sitio": "mi-sitio",
  "token": "el token de tu sitio",
  "from": { "address": "avisos@tudominio.com", "name": "Tu Negocio" },
  "to": [{ "address": "cliente@ejemplo.com" }],
  "subject": "Tu pedido quedó confirmado",
  "text": "Versión en texto plano (inclúyela siempre)",
  "html": "<p>Versión HTML</p>"
}

Respuesta exitosa:

{
  "success": true,
  "message_id": "<…@tudominio.com>",
  "enviados_hoy": 12,
  "incluidos_por_dia": 100,
  "es_extra": false
}

Las reglas

• El remitente (from) debe ser de un dominio conectado a tu sitio. Cualquier buzón sirve: avisos@, pedidos@, facturas@.
• Incluye siempre text además de html: mejora la entrega.
• Solo correo transaccional. Nada de boletines ni campañas masivas.
• El token va en una variable de entorno de tu sitio, nunca en el código.

Si eres una IA integrando el envío: léelo entero antes de escribir código

Esta sección existe porque una IA ya perdió una hora adivinando formatos. Todo lo de abajo está verificado con envíos reales, no copiado de ninguna otra documentación — y otras documentaciones (incluida la del binding de Workers) usan formatos que AQUÍ NO APLICAN.

La forma exacta que funciona

POST https://yapanel.yadominios.com/api/hosting/correo/enviar
Content-Type: application/json

{
  "sitio": "nombre-del-sitio",
  "token": "el token del sitio (variable de entorno, jamás en el código)",
  "from": { "address": "avisos@tudominio.com", "name": "Tu Negocio" },
  "to": [{ "address": "cliente@ejemplo.com" }],
  "reply_to": "soporte@tudominio.com",
  "subject": "…",
  "text": "versión en texto (SIEMPRE)",
  "html": "<p>versión HTML (opcional)</p>"
}

Lo que NO debes hacer (cada punto ya rompió a alguien)

Error	Qué pasa	Lo correcto
Usar replyTo en camelCase	invalid_request_schema — le costó una hora a una IA real	reply_to, guion bajo, como TEXTO plano
reply_to como lista de objetos	invalid_request_schema	Texto plano: "reply_to": "soporte@…"
Remitente de un dominio que no es del sitio	403 from_ajeno — es un candado de seguridad, no un bug	El from debe ser del dominio conectado a TU sitio
Llamar a Cloudflare directo con una llave de la cuenta	Esa llave puede enviar como CUALQUIER dominio de la plataforma; no se entrega	Usa este endpoint con el token de tu sitio
Mandar solo html sin text	Peor entrega; algunos clientes de correo no lo muestran	Incluye siempre los dos
Reintentar en bucle un error	Quema el cupo del día y no arregla nada	Lee el código de error de la tabla siguiente y actúa una vez

Los errores del endpoint, con su salida

HTTP	Código	Qué significa	Qué haces
401	token_invalido / sin_token	El token no es de este sitio o no existe	Genera uno con «Ver token» en el panel y ponlo en la variable de entorno
401	token_reemplazado	Tu token era válido pero alguien generó uno nuevo desde el panel. El mensaje dice cuándo. No es un fallo de tu código ni de la base.	Pídele el token nuevo al dueño del sitio. No reintentes con el viejo: no va a volver a funcionar.
403	plan_sin_correo	El sitio está en vista previa	El dueño debe pasar a un plan de pago
403	from_ajeno	El remitente no es de un dominio del sitio	Cambia el from al dominio conectado
429	limite_alcanzado	Se enviaron los 100 del día sin autorización de extras	NO reintentes: espera a mañana o que el dueño autorice extras en su panel
502	proveedor	El proveedor rechazó el mensaje	Lee el detalle del error: suele ser el formato del mensaje

La respuesta exitosa siempre trae enviados_hoy: úsalo para no llegar al límite a ciegas.

¿Y si paso de los 100 del día?

Tú decides, y por defecto la respuesta es la segura:

Situación	Qué pasa
Sin autorizar correos extra (lo normal)	Al correo 101 el envío se pausa hasta el día siguiente. Cero cobros sorpresa.
Con «correos extra» autorizado (menú ⋮ de tu sitio)	Sigue enviando sin cortes y el excedente se factura a $1 por cada 1.000 correos.

La respuesta del endpoint siempre te dice cuántos van hoy (enviados_hoy) para que tu app lo muestre si quiere.

Dónde ves tus correos: el botón «Correos» de tu sitio

En el panel, en la tarjeta de tu sitio, tienes un botón Correos. Ahí está todo lo que necesitas saber sin preguntarle a nadie:

• Las cuentas del día: cuántos salieron, cuántos se cayeron, cuántos te quedan de los 100 incluidos y cuántos llevas en los últimos 30 días. Con una barra que se pone ámbar al 80% — te enteras de que te estás quedando corto antes de quedarte corto, no después.
• Cada correo, con su contenido. Asunto, a quién fue, a qué hora, y al tocarlo se abre y lees el mensaje tal cual se envió. Es la respuesta a la pregunta que de verdad se hace: «¿le llegó el aviso a este cliente y qué decía?».
• Los que fallaron, con el motivo en español. Van en la misma lista y en orden de reloj, marcados en rojo. Un envío que no salió es justo el que hay que poder mirar.

Los mensajes se guardan 30 días; las cuentas de enviados y de errores no caducan. El cuerpo se guarda recortado si es enorme (el correo sale completo igual).