# Enviar correo desde tus apps

> Haz que las apps de un proyecto envíen correo (formularios de contacto, avisos, recibos, newsletters) con tu dominio, sin configurar ningún otro proveedor. Se cobra por correo enviado.

Tu web o tu app puede mandar correo con tu propio dominio —el aviso de un formulario de contacto, la confirmación de un pedido, una newsletter— sin que contrates otro servicio de envío. Dilohost da a cada proyecto una credencial propia y la pone en la app por ti.

Es distinto de los [buzones](/docs/correo/buzones): un buzón es para que una persona lea y escriba correo; esto es para que lo mande un programa. Lo que mandan las personas desde sus buzones no se mide ni se cobra aparte.

## Antes de empezar

- **Un plan de pago.** El plan Gratis no envía correo desde apps. Cuánto permite cada plan: [Planes y precios](/docs/cuenta/planes).
- **El correo activado en el dominio** y verificado, como en [Buzones de correo](/docs/correo/buzones). No hace falta crear ningún buzón.
- **Un proyecto con la app** que va a enviar.

## 1. Activar el envío del proyecto

<p class="prompt">Haz que la app del proyecto tienda envíe correo con mitienda.es, con los remitentes pedidos y no-reply.</p>

`email.smtp_enable` **pide confirmación** y te enseña el precio antes de hacer nada. Los remitentes son las direcciones con las que podrá firmar la app (`pedidos@mitienda.es`, `no-reply@mitienda.es`). Elige las que de verdad vayas a usar: puedes cambiarlas cuando quieras.

## 2. Dársela a la app

<p class="prompt">Conecta el envío de correo a la app web del proyecto tienda.</p>

`email.smtp_connect` guarda la credencial en las variables de la app sin enseñar la contraseña, ni a ti ni al agente. La app recibe:

| Variable | Valor |
|---|---|
| `MAIL_HOST` / `SMTP_HOST` | `mail.dilohost.es` |
| `MAIL_PORT` / `SMTP_PORT` | `587` (con STARTTLS) |
| `MAIL_USERNAME` / `SMTP_USER` | el usuario técnico del proyecto, `app-<proyecto>@tudominio.es` |
| `MAIL_PASSWORD` / `SMTP_PASSWORD` | la contraseña, solo dentro de la app |
| `MAIL_FROM_ADDRESS` / `SMTP_FROM` | el primer remitente que declaraste |

Laravel lo lee solo. En otros frameworks, usa las variables `SMTP_*`. La app se reinicia con las variables nuevas.

## 3. Remitentes

El `From` de cada correo tiene que ser el usuario técnico o uno de los remitentes declarados. Cualquier otro se rechaza al enviar, aunque sea de tu propio dominio.

<p class="prompt">Añade el remitente facturas al envío de correo del proyecto tienda.</p>

`email.smtp_senders` **sustituye** la lista (hasta 10). No puedes usar una dirección que ya sea un buzón u otro remitente del dominio, y nunca la de otra cuenta.

## Cuánto cuesta

Se cobra **por correo enviado**, a la tarifa pública que ves en [Planes y precios](/docs/cuenta/planes). **Cada destinatario cuenta como un correo**: un mensaje a tres personas son tres. Entra en el crédito mensual de tu plan y en tu tope de gasto, como el resto del uso; `billing.usage` y el panel lo enseñan como «Correo enviado por apps».

## Límites y protección

| Qué | Cómo funciona |
|---|---|
| Correos por hora | Cada plan tiene un máximo por proyecto ([Límites](/docs/referencia/limites)). Si una app lo supera, su envío **se para solo** y recibes un aviso; vuelve cuando baje de la mitad. |
| Crédito o tope de gasto | Si se acaba el crédito sin saldo, o llegas al tope, el envío se para junto con tus apps y vuelve al recargar, subir el tope o empezar el mes. |
| Cuenta suspendida o proyecto en la papelera | El envío queda parado; vuelve al reactivar o restaurar. |
| Rebotes o quejas | Si en 7 días demasiados correos rebotan (direcciones que no existen) o se marcan como spam, te avisamos y, si sigue, **paramos el envío de las apps de ese dominio**. Tus buzones y tu cuenta no se tocan. No vuelve solo: escribe a hola@dilohost.es cuando hayas limpiado la lista. |

Una parada **por límite por hora** no la levanta una recarga: cada motivo se levanta por su lado.

En el panel, **Correo → Envío desde tus apps** muestra por proyecto lo enviado este mes, la última hora, el porcentaje de rebotes y quejas, y si está enviando o parado y por qué.

## Newsletters y correo comercial

Puedes mandar correo comercial a personas que lo hayan pedido. Hace falta su consentimiento y un enlace para darse de baja en cada envío (la cabecera `List-Unsubscribe`). La reputación de un dominio se mide por sus rebotes y quejas: **a partir del 3 % de rebotes o el 0,05 % de quejas te avisamos, y al 5 % o al 0,1 % paramos el envío de las apps de ese dominio** para proteger su reputación y la de los demás. Con menos de 100 envíos en 7 días no se mide. Un rebote temporal (buzón lleno) no cuenta; sí las direcciones que no existen.

## Formularios para webs sin servidor

Si tu web es solo frontend (HTML estático, un sitio generado, una landing), no puede guardar una credencial de correo ni hablar SMTP. Para eso Dilohost aloja el formulario: tu web lo manda a una dirección de Dilohost y te llega por correo, sin ninguna credencial en la web.

<p class="prompt">Crea un formulario de contacto para el proyecto tienda que salga como pedidos y me llegue a mi correo. Solo debe aceptarse desde https://mitienda.es.</p>

`form.create` te da la dirección del formulario (`https://dilohost.es/f/<código>`) y `form.guide` el HTML o el `fetch()` listos para pegar. Tú fijas **a quién llega** (una sola dirección) y **con qué remitente sale** (uno de los del proyecto); quien rellena el formulario no puede cambiar ninguna de las dos cosas.

- **Cuenta como correo enviado desde tus apps**: se cobra igual (0,40 € cada 1.000) y entra en el crédito y el tope.
- **Limita los orígenes.** Con `origins` solo tu web puede usarlo. Sin ellos, cualquiera que tenga la dirección puede mandar mensajes que pagas tú.
- **Protección contra abusos**: 6 envíos por minuto y persona, 120 por hora y formulario, un campo oculto `_gotcha` como trampa para robots, y el límite por hora y el corte por reputación del proyecto.
- Los envíos se guardan 90 días y se borran solos.
- Puedes pausarlo (`form.update` con `active=false`) o borrarlo (`form.delete`).
- **También desde el panel:** en **Formularios** los creas y editas, copias la dirección y el código para tu web, mandas un mensaje de prueba y ves los últimos envíos.

## Cambiar la contraseña

<p class="prompt">Cambia la contraseña del envío de correo del proyecto tienda.</p>

`email.smtp_connect` con `rotate` genera una contraseña nueva y actualiza **todas** las apps donde estaba. No hay que tocar nada más.

## Quitar el envío

`email.smtp_disable` borra la credencial (pide confirmación). Las apps que la usan dejan de poder enviar; lo ya enviado se cobra. Un dominio con apps enviando no se puede desactivar hasta que las quites.

## Problemas frecuentes

| Síntoma | Causa y arreglo |
|---|---|
| La app dice «sender not allowed» o recibe un 501 | El `From` no es un remitente declarado. Añádelo con `email.smtp_senders`. |
| No envía nada y `email.smtp_status` dice «parado» | Mira el motivo: límite por hora, crédito o tope, cuenta suspendida o papelera. |
| Falla la autenticación tras cambiar la contraseña | La app no se ha reiniciado con la nueva: `email.smtp_connect` con `rotate` la actualiza sola. |
| El dominio «aún no puede enviar» | Está verificándose; `email.status` te dice cuándo (minutos). |

## Relacionado

- [Buzones de correo](/docs/correo/buzones)
- [Variables de entorno](/docs/publicar/variables)
- [Planes y precios](/docs/cuenta/planes)
- [Límites](/docs/referencia/limites)
