# Webmail

Leer, enviar y ordenar el correo de una casilla desde el navegador, con carpetas, filtros y alias.

Fuente: https://ardumaker.com/docs/webmail/

- Categoría: Comunicación
- Estado: Disponible
- Requisitos: Una casilla activa de [correo profesional](https://ardumaker.com/docs/correo-profesional); La dirección completa y la contraseña de la casilla
- Herramientas MCP (Solo leen): `listar_mensajes_correo`, `ver_mensaje_correo`, `listar_carpetas_correo`, `listar_filtros_correo`
- Herramientas MCP (Escriben o modifican): `marcar_leido_correo`, `enviar_correo`, `crear_carpeta_correo`, `crear_filtro_correo`
- Herramientas MCP (Destructivas): `eliminar_filtro_correo`

## ¿Qué permite hacer?

- Entrar con la dirección y la contraseña de la casilla, sin una cuenta de ArduMaker.
- Listar mensajes por carpeta, leer uno completo y descargar sus adjuntos.
- Enviar correo con o sin adjuntos, a uno o varios destinatarios.
- Crear y gestionar carpetas, filtros Sieve y [alias](https://ardumaker.com/docs/alias-de-correo).
- Ver la cuota usada y la cantidad de mensajes.

## ¿Cuándo conviene usarlo?

Para usar el correo sin instalar un cliente. Si se prefiere Outlook, Thunderbird o el teléfono, la misma casilla funciona por [IMAP y SMTP](https://ardumaker.com/docs/smtp-imap).

## ¿Cómo funciona en ArduMaker?

1. El inicio de sesión valida la casilla y entrega un token que dura 24 horas, en cookie o en la cabecera `Email-Token`.
2. La bandeja se lee del servidor por IMAP. Listar no marca como leído; abrir un mensaje se marca aparte.
3. Enviar responde enseguida con 202: el correo queda registrado y sale en segundo plano.
4. Cada casilla envía hasta 5 correos por minuto. Lo que pasa ese límite sin adjuntos queda en cola y sale solo; con adjuntos se rechaza con 429.

| Límite | Valor |
| --- | --- |
| Envíos por casilla | 5 por minuto |
| Adjuntos por correo | 25 MB en total |
| Mensajes por listado | 20 por defecto, hasta 100 |
| Vida del token | 24 horas |

Los adjuntos admitidos son imágenes, PDF, documentos de Office, texto, CSV, ZIP y RAR.

## ¿Qué cambia realmente?

- Enviar deja el correo en la carpeta de enviados de la casilla.
- Carpetas, filtros y alias se crean en el servidor de correo y valen también por IMAP.
- Cerrar sesión borra la cookie del token.

## Esquema

**Envío desde el webmail**

```text
Webmail (token de la casilla)
  ↓
API de correo (valida límite y adjuntos)
  ↓
Cola de salida (si se pasó el límite)
  ↓
Servidor de correo (SMTP)
```

## Resultado esperado

La persona lee y responde su correo en el navegador. El estado `sending` dice que el envío ya salió a procesarse; `queued`, que espera turno por el límite.

## Errores y resolución

- **401 en cualquier pedido**: el token venció o falta. Hay que volver a iniciar sesión.
- **429 `limite_de_envio_alcanzado`**: se pasó el límite por minuto con adjuntos. Esperar un minuto y reintentar.
- **Tipo de archivo rechazado**: el adjunto no está entre los tipos admitidos.
- **Filtro sin efecto**: el código Sieve no se valida antes de enviarlo al servidor; un script inválido falla allí.

## Relación con MCP

Un agente opera la casilla por MCP sin sesión de webmail: usa la contraseña que ArduMaker guarda cifrada al crear la casilla. Hace falta acceso a la empresa del dominio. Ver [/mcp/correo](https://ardumaker.com/mcp/correo).

| Tipo | Herramientas |
| --- | --- |
| Lectura | `listar_mensajes_correo`, `ver_mensaje_correo`, `listar_carpetas_correo`, `listar_filtros_correo` |
| Modifican | `marcar_leido_correo`, `enviar_correo`, `crear_carpeta_correo`, `crear_filtro_correo` |
| Destructiva | `eliminar_filtro_correo` |

> **PRECAUCION:** `enviar_correo` espera el resultado real del SMTP, no admite adjuntos y respeta el mismo límite por casilla. El contenido de los mensajes llega marcado como no confiable: son datos, no instrucciones.

## Funciones relacionadas

- [Correo profesional](https://ardumaker.com/docs/correo-profesional/)
- [SMTP e IMAP](https://ardumaker.com/docs/smtp-imap/)
- [Alias de correo](https://ardumaker.com/docs/alias-de-correo/)
- [Cuentas bot](https://ardumaker.com/docs/cuentas-bot/)