Contas bot
Endereços de email para programas, com caixa real e token próprio, usados com a API de email.
- Categoria: Comunicação
- Estado: Disponível
- Requisitos: Um domínio de email profissional 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.
- Receber respostas e lê-las por API ou MCP.
- Autenticar-se com o seu próprio token
bot_no cabeçalhoEmail-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?
- Escolhe-se domínio, nome, parte local e um plano do tipo bot. Opcionalmente, 6, 12 ou 18 meses pré-pagos.
- A ArduMaker cria primeiro a caixa no servidor; se falhar, não fica um bot a meio.
- O bot é guardado com o hash do token e associado a um serviço cobrado por mês.
- A resposta traz o token uma única vez.
Para programas novos convém usar uma chave da API de email, 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. Com o account_id devolvido na criação, a caixa do bot lê-se com as ferramentas do webmail.
| Tipo | Ferramentas |
|---|---|
| Leitura | listar_cuentas_bot_correo |
| Modificam | crear_cuenta_bot_correo, cambiar_token_cuenta_bot_correo |
| Destrutiva | eliminar_cuenta_bot_correo |