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

Markdown

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ç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, 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.

TipoFerramentas
Leituralistar_cuentas_bot_correo
Modificamcrear_cuenta_bot_correo, cambiar_token_cuenta_bot_correo
Destrutivaeliminar_cuenta_bot_correo

Funcionalidades relacionadas