Webmail
Ler, enviar e organizar o email de uma caixa no navegador, com pastas, filtros e aliases.
- Categoria: Comunicação
- Estado: Disponível
- Requisitos: Uma caixa ativa de email profissional; 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.
- 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.
Como funciona na ArduMaker?
- O login valida a caixa e devolve um token válido por 24 horas, em cookie ou no cabeçalho
Email-Token. - A caixa é lida do servidor via IMAP. Listar não marca como lido; marcar como lido é uma ação à parte.
- Enviar responde de imediato com 202: o email fica registrado e sai em segundo plano.
- 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
- 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.
| 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 |