# Webmail

Ler, enviar e organizar o email de uma caixa no navegador, com pastas, filtros e aliases.

Fonte: https://ardumaker.com/pt/docs/webmail/

- Categoria: Comunicação
- Estado: Disponível
- Requisitos: Uma caixa ativa de [email profissional](https://ardumaker.com/pt/docs/correo-profesional); O endereço completo e a senha da caixa
- Ferramentas MCP (Só leem): `listar_mensajes_correo`, `ver_mensaje_correo`, `listar_carpetas_correo`, `listar_filtros_correo`
- Ferramentas MCP (Escrevem ou modificam): `marcar_leido_correo`, `enviar_correo`, `crear_carpeta_correo`, `crear_filtro_correo`
- Ferramentas MCP (Destrutivas): `eliminar_filtro_correo`

## O que permite fazer?

- Entrar com o endereço e a senha da caixa, sem conta ArduMaker.
- Listar mensagens por pasta, ler uma completa e baixar os anexos.
- Enviar email com ou sem anexos, para um ou vários destinatários.
- Criar e gerenciar pastas, filtros Sieve e [aliases](https://ardumaker.com/pt/docs/alias-de-correo).
- Ver a quota usada e o número de mensagens.

## Quando convém usar?

Para usar o email sem instalar um cliente. Se preferir Outlook, Thunderbird ou o celular, a mesma caixa funciona via [IMAP e SMTP](https://ardumaker.com/pt/docs/smtp-imap).

## Como funciona na ArduMaker?

1. O login valida a caixa e devolve um token válido por 24 horas, em cookie ou no cabeçalho `Email-Token`.
2. A caixa é lida do servidor via IMAP. Listar não marca como lido; marcar como lido é uma ação à parte.
3. Enviar responde de imediato com 202: o email fica registrado e sai em segundo plano.
4. Cada caixa envia até 5 emails por minuto. O que passar desse limite sem anexos fica em fila e sai sozinho; com anexos é recusado com 429.

| Limite | Valor |
| --- | --- |
| Envios por caixa | 5 por minuto |
| Anexos por email | 25 MB no total |
| Mensagens por listagem | 20 por omissão, até 100 |
| Validade do token | 24 horas |

Os anexos aceites são imagens, PDF, documentos Office, texto, CSV, ZIP e RAR.

## O que muda realmente?

- Enviar deixa o email na pasta de enviados da caixa.
- Pastas, filtros e aliases são criados no servidor de email e valem também via IMAP.
- Terminar sessão apaga o cookie do token.

## Esquema

**Envio pelo webmail**

```text
Webmail (token da caixa)
  ↓
API de email (valida limite e anexos)
  ↓
Fila de saída (se o limite foi ultrapassado)
  ↓
Servidor de email (SMTP)
```

## Resultado esperado

A pessoa lê e responde ao email no navegador. O estado `sending` indica que o envio já está sendo processado; `queued`, que espera vez por causa do limite.

## Erros e resolução

- **401 em qualquer pedido**: o token expirou ou falta. É preciso voltar a iniciar sessão.
- **429 `limite_de_envio_alcanzado`**: o limite por minuto foi ultrapassado com anexos. Esperar um minuto e repetir.
- **Tipo de arquivo recusado**: o anexo não está entre os tipos aceites.
- **Filtro sem efeito**: o código Sieve não é validado antes de ser enviado ao servidor; um script inválido falha lá.

## Relação com MCP

Um agente opera a caixa via MCP sem sessão de webmail: usa a senha que a ArduMaker guarda cifrada ao criar a caixa. É preciso acesso à empresa do domínio. Ver [/mcp/correo](https://ardumaker.com/pt/mcp/correo).

| Tipo | Ferramentas |
| --- | --- |
| Leitura | `listar_mensajes_correo`, `ver_mensaje_correo`, `listar_carpetas_correo`, `listar_filtros_correo` |
| Modificam | `marcar_leido_correo`, `enviar_correo`, `crear_carpeta_correo`, `crear_filtro_correo` |
| Destrutiva | `eliminar_filtro_correo` |

> **PRECAUCION:** `enviar_correo` espera o resultado real do SMTP, não aceita anexos e respeita o mesmo limite por caixa. O conteúdo das mensagens chega marcado como não confiável: são dados, não instruções.

## Funcionalidades relacionadas

- [Email profissional](https://ardumaker.com/pt/docs/correo-profesional/)
- [SMTP e IMAP](https://ardumaker.com/pt/docs/smtp-imap/)
- [Aliases de email](https://ardumaker.com/pt/docs/alias-de-correo/)
- [Contas bot](https://ardumaker.com/pt/docs/cuentas-bot/)