# Contas bot

Endereços de email para programas, com caixa real e token próprio, usados com a API de email.

Fonte: https://ardumaker.com/pt/docs/cuentas-bot/

- Categoria: Comunicação
- Estado: Disponível
- Requisitos: Um domínio de [email profissional](https://ardumaker.com/pt/docs/correo-profesional) verificado; Um plano de email do tipo bot
- Ferramentas MCP (Só leem): `listar_cuentas_bot_correo`
- Ferramentas MCP (Escrevem ou modificam): `crear_cuenta_bot_correo`
- Ferramentas MCP (Destrutivas): `cambiar_token_cuenta_bot_correo`, `eliminar_cuenta_bot_correo`

## O que permite fazer?

Uma conta bot é um endereço para um programa enviar e receber email. Tem uma caixa real no servidor, mas ninguém entra com senha: a ArduMaker gera a senha ao acaso, guarda-a cifrada e nunca a expõe.

- Ser remetente da [API de email](https://ardumaker.com/pt/docs/email-api).
- Receber respostas e lê-las por API ou MCP.
- Autenticar-se com o seu próprio token `bot_` no cabeçalho `Email-Bot-Token`.

## Quando convém usar?

Quando o email é tratado por uma aplicação e não por uma pessoa: avisos de um sistema, um bot que responde, um endereço `no-reply@`.

## Como funciona na ArduMaker?

1. Escolhe-se domínio, nome, parte local e um plano do tipo bot. Opcionalmente, 6, 12 ou 18 meses pré-pagos.
2. A ArduMaker cria primeiro a caixa no servidor; se falhar, não fica um bot a meio.
3. O bot é guardado com o hash do token e associado a um serviço cobrado por mês.
4. A resposta traz o token uma única vez.

Para programas novos convém usar uma chave da [API de email](https://ardumaker.com/pt/docs/email-api), que pode cobrir vários bots; o token por bot continua a funcionar.

## O que muda realmente?

- Criação: caixa no servidor, bot na ArduMaker e serviço faturável.
- Regenerar o token: o anterior deixa de servir e a sessão aberta é cortada.
- Só o nome visível pode mudar. Endereço e plano não: para isso cria-se outro bot.
- Remoção: o bot e o serviço são removidos; a caixa fica marcada como apagada mas o email que contém não é eliminado.

## Resultado esperado

Um endereço pronto para enviar e receber a partir de código. Se se voltar a criar um bot com o mesmo endereço, reutiliza a caixa.

## Erros e resolução

- **409 `bot_ya_existe`**: já existe um bot ativo com esse endereço no domínio.
- **404 `plan_not_found`**: o plano não existe ou não admite contas bot.
- **400 `solo_el_nombre`**: tentou-se mudar o endereço ou o plano.
- **Token perdido**: não se pode recuperar; é preciso regenerá-lo.

## Relação com MCP

Requer acesso à empresa do domínio. Ver [/mcp/correo](https://ardumaker.com/pt/mcp/correo). Com o `account_id` devolvido na criação, a caixa do bot lê-se com as ferramentas do [webmail](https://ardumaker.com/pt/docs/webmail).

| Tipo | Ferramentas |
| --- | --- |
| Leitura | `listar_cuentas_bot_correo` |
| Modificam | `crear_cuenta_bot_correo`, `cambiar_token_cuenta_bot_correo` |
| Destrutiva | `eliminar_cuenta_bot_correo` |

> **PRECAUCION:** Uma conta bot é um serviço pago: o agente deve confirmar com a pessoa antes de a criar.

## Funcionalidades relacionadas

- [API de email](https://ardumaker.com/pt/docs/email-api/)
- [Email profissional](https://ardumaker.com/pt/docs/correo-profesional/)
- [Webmail](https://ardumaker.com/pt/docs/webmail/)
- [Consumo de serviços](https://ardumaker.com/pt/docs/consumo-de-servicios/)