criadordeagentes

Documentação

Criando seu agente

O assistente de criação tem 6 passos. Se você der F5 no meio, seu progresso é mantido (na mesma aba do navegador).

Passo 1 — Nome

Nome interno, só pra você identificar o agente na plataforma. Pode mudar depois. O nome “de verdade” do agente — o que ele usa na conversa — você define com ele no primeiro papo.

Passo 2 — Bot do Telegram

  1. 1
    Abra o @BotFather no Telegram (link no próprio passo).
  2. 2
    Mande /newbot.
  3. 3
    Escolha um nome e um username (precisa terminar em bot, ex: sofia_pessoal_bot).
  4. 4
    O BotFather responde com um token (parece 123456789:AAEhBO...). Copie e cole no campo — a gente valida na hora.
O token é a chave do seu bot. Não compartilhe com ninguém além da plataforma.

Passo 3 — Vincular seu Telegram

Pra ninguém além de você falar com o agente:

  1. 1
    Abra o seu bot recém-criado no Telegram (link no passo).
  2. 2
    Mande /start — ele ainda não responde, é normal.
  3. 3
    Volte pra plataforma e clique em “Detectar meu Telegram”.
  4. 4
    Confira se o nome detectado é você e siga em frente.

Passo 4 — O cérebro

Escolha entre Claude (Anthropic) — recomendado — ou OpenAI, e cole sua API key:

  1. 1
    Anthropic: crie em console.anthropic.com/settings/keys
  2. 2
    OpenAI: crie em platform.openai.com/api-keys

A key é validada na hora contra o provedor. Ela fica criptografada no nosso banco e só é usada pelo SEU agente.

Passo 5 — Áudio (opcional)

Pra mandar mensagens de voz pro agente, ele precisa de um serviço de transcrição. Groq é o recomendado — tem camada grátis generosa (console.groq.com/keys). Dá pra desativar e usar só texto.

Este passo é sobre o agente entenderos áudios que você manda. Respostas em áudio (voz do agente) são um recurso separado — veja a seção “Imagens, web e voz”.

Passo 6 — Confirmar

Revise tudo e clique em Criar agente. Opcional: cole uma key do fal.ai se quiser que o agente gere imagens e vídeos.

O provisionamento leva de 30 a 90 segundos. Quando a tela ficar verde, abra o bot no Telegram e mande um “oi” — ele se apresenta e faz o onboarding (nome, personalidade, suas preferências) por conversa.