Cuentas bot

Direcciones de correo para programas, con casilla real y token propio, que se usan con la API de correo.

Categoría: Comunicación
Estado: Disponible
Requisitos: Un dominio de correo profesional verificado; Un plan de correo de tipo bot
Herramientas MCP (Solo leen): listar_cuentas_bot_correo
Herramientas MCP (Escriben o modifican): crear_cuenta_bot_correo
Herramientas MCP (Destructivas): cambiar_token_cuenta_bot_correo, eliminar_cuenta_bot_correo

¿Qué permite hacer?

Una cuenta bot es una dirección para que un programa envíe y reciba correo. Tiene una casilla real en el servidor, pero nadie entra con contraseña: su clave la genera ArduMaker al azar, se guarda cifrada y no sale del backend.

Ser remitente de la API de correo.
Recibir respuestas y leerlas por API o por MCP.
Autenticarse con su propio token bot_ en la cabecera Email-Bot-Token.

¿Cuándo conviene usarlo?

Cuando el correo lo maneja una aplicación y no una persona: avisos de un sistema, un bot que contesta, una dirección no-reply@.

¿Cómo funciona en ArduMaker?

Se elige dominio, nombre, parte local y un plan de tipo bot. Opcionalmente, 6, 12 o 18 meses de prepago.
ArduMaker crea primero la casilla en el servidor; si falla, no queda un bot a medias.
Se guarda el bot con el hash de su token y se asocia un servicio que se cobra por mes.
La respuesta trae el token una sola vez.

Para programas nuevos conviene usar una llave de la API de correo, que puede cubrir varios bots; el token por bot sigue funcionando.

¿Qué cambia realmente?

Alta: casilla en el servidor, bot en ArduMaker y servicio facturable.
Regenerar el token: el anterior deja de servir y se corta la sesión que tenía abierta.
Solo se puede cambiar el nombre visible. Dirección y plan no cambian: para eso se crea otro bot.
Baja: se da de baja el bot y su servicio; la casilla se marca como borrada pero el correo que contiene no se elimina.

Resultado esperado

Una dirección lista para enviar y recibir desde código. Si se vuelve a crear un bot con la misma dirección, reutiliza su casilla.

Errores y resolución

409 `bot_ya_existe`: ya hay un bot activo con esa dirección en el dominio.
404 `plan_not_found`: el plan no existe o no admite cuentas bot.
400 `solo_el_nombre`: se intentó cambiar la dirección o el plan.
Token perdido: no se puede recuperar; hay que regenerarlo.

Relación con MCP

Requiere acceso a la empresa del dominio. Ver /mcp/correo. Con el account_id que devuelve el alta, la casilla del bot se lee con las herramientas del webmail.

Tipo	Herramientas
Lectura	`listar_cuentas_bot_correo`
Modifican	`crear_cuenta_bot_correo`, `cambiar_token_cuenta_bot_correo`
Destructiva	`eliminar_cuenta_bot_correo`