Webmail
Leer, enviar y ordenar el correo de una casilla desde el navegador, con carpetas, filtros y alias.
- Categoría: Comunicación
- Estado: Disponible
- Requisitos: Una casilla activa de 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.
- 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.
¿Cómo funciona en ArduMaker?
- El inicio de sesión valida la casilla y entrega un token que dura 24 horas, en cookie o en la cabecera
Email-Token. - La bandeja se lee del servidor por IMAP. Listar no marca como leído; abrir un mensaje se marca aparte.
- Enviar responde enseguida con 202: el correo queda registrado y sale en segundo plano.
- 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
- 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.
| 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 |