# Cuentas bot

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

Fuente: https://ardumaker.com/docs/cuentas-bot/

- Categoría: Comunicación
- Estado: Disponible
- Requisitos: Un dominio de [correo profesional](https://ardumaker.com/docs/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](https://ardumaker.com/docs/email-api).
- 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?

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

Para programas nuevos conviene usar una llave de la [API de correo](https://ardumaker.com/docs/email-api), 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](https://ardumaker.com/mcp/correo). Con el `account_id` que devuelve el alta, la casilla del bot se lee con las herramientas del [webmail](https://ardumaker.com/docs/webmail).

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

> **PRECAUCION:** Una cuenta bot es un servicio pago: el agente debe confirmarlo con la persona antes de crearla.

## Funciones relacionadas

- [API de correo](https://ardumaker.com/docs/email-api/)
- [Correo profesional](https://ardumaker.com/docs/correo-profesional/)
- [Webmail](https://ardumaker.com/docs/webmail/)
- [Consumo de servicios](https://ardumaker.com/docs/consumo-de-servicios/)