@BotFather

Quer criar um bot no Telegram e não sabe por onde começar?

Vem com a gente!

Abaixo está um roteiro didático, pensado para leigos, com todos os passos e os principais comandos do BotFather.

1) O que é o @BotFather?

O @BotFather é o “pai” de todos os bots do Telegram.

É um bot oficial (com selo verificado) que você usa para criar, configurar e administrar os seus próprios bots: gerar token, colocar foto, descrição, comandos, privacidade em grupos e muito mais.

2) Pré-requisitos

Ter o app do Telegram (celular, desktop ou web).
Ter uma conta no Telegram.
Ter um nome e um @username em mente para o seu bot.

🔎 Dica: o @username do bot precisa terminar com “bot” (ex.: MeuAssistente_bot).

3) Criando seu primeiro bot (do zero)

Abra o Telegram e pesquise por @BotFather (ícone com selo azul).
Toque em Start (ou envie /start).
Envie /newbot.
O BotFather vai pedir:

Nome do bot (o nome “bonito” que aparece no topo do chat).
@username do bot (único e precisa terminar com “bot”).

Se der tudo certo, o BotFather enviará uma mensagem com:

O link do seu bot: https://t.me/SEU_USERNAME
O token de API (uma sequência parecida com 123456:ABC-...).

⚠️ Guarde o token com cuidado!

Ele é a “senha” do seu bot.

Se vazar, qualquer pessoa pode controlar o seu bot.

4) Testando o bot

Toque no link t.me/SEU_USERNAME que o BotFather enviou.
Abra o chat com o seu bot e envie /start.

📌 Observação importante:

o bot ainda não fala sozinho.

Ele só começa a responder quando você conecta esse token a algum sistema (seu código ou uma plataforma como QuanthraAI, ou frameworks como python-telegram-bot / node-telegram-bot-api).

Aqui focaremos nas configurações pelo BotFather.

5) Personalizando o bot com o BotFather (passo a passo)

A) Revisar/editar seu bot pelo menu

Envie /mybots → selecione o bot → Edit Bot (ou Bot Settings).
Ali você encontra as mesmas opções dos comandos abaixo, só que por botões.

B) Principais comandos do BotFather (explicados e com mini-tutorial)

`/setname` — mudar o Nome do bot

Envie /setname.
Escolha o bot.
Envie o novo Nome (ex.: “Meu Assistente”).

`/setdescription`— adicionar a Descrição curta

Envie /setdescription.
Escolha o bot.
Escreva uma frase ou parágrafo curto explicando o que o bot faz.

Essa descrição aparece na página do bot antes do usuário iniciar a conversa.

`/setabouttext` — texto Sobre (bio do perfil)

Envie /setabouttext.
Escolha o bot.
Envie um texto curto (aparece no perfil do bot, dentro do chat).

`/setuserpic` — definir foto de perfil

Envie /setuserpic.
Escolha o bot.
Envie uma imagem quadrada (o Telegram vai ajustar/cortar).

`/setcommands` — cadastrar a lista de comandos

Isso mostra um menu de comandos para o usuário (aquele ícone “/” no campo de texto).

Envie /setcommands.
Escolha o bot.
Envie a lista no formato um por linha:

start - Inicia a conversa
help - Mostra ajuda e contatos
preco - Consulta tabela de preços
contato - Falar com um atendente

✅ Dica: mantenha comandos curtos e descritivos; a descrição ajuda o usuário a entender para que serve cada um.

`/token` — recuperar o token atual

Envie /token → selecione o bot → o BotFather reexibe o token.

`/revoke` — revogar e gerar novo token

Se o token vazou ou você desconfia disso:
Envie /revoke → selecione o bot → o token antigo é invalidado e você recebe um novo.

`/setprivacy` — Privacidade em grupos

Controla o que o bot pode “ver” quando adicionado a grupos:

Envie /setprivacy.
Escolha o bot.
Selecione:

Enable (recomendado): o bot só vê mensagens que começam com / (comandos) ou menções diretas a ele.
Disable: o bot vê todas as mensagens do grupo (use apenas se for realmente necessário).

🔒 Dica: deixe Enable para evitar comportamento indesejado em grupos.

`/setjoingroups` — permitir/impedir que o bot entre em grupos

Envie /setjoingroups → escolha o bot → Enable/Disable.

Útil se o seu bot é apenas para uso 1-a-1.

`/setinline` — ativar modo inline

Permite usar o bot sem abrir o chat dele, digitando no qualquer chat:

@SEU_USERNAME <sua consulta>

Envie /setinline.
Escolha o bot.
Enable/**Disable`.

Precisa que seu código/plataforma implemente respostas inline.

`/deletebot` — apagar o bot

Envie /deletebot → selecione o bot → confirme.

⚠️ Irreversível. Só use se tiver certeza.

6) Checklist rápido pós-criação (o “basiquinho” que funciona)

/setname — ajuste o Nome amigável.
/setdescription e /setabouttext — explique claramente o propósito.
/setuserpic — adicione um avatar reconhecível.
/setcommands — crie um menu de comandos útil.
/setprivacy — deixe Enable (especialmente se o bot entrar em grupos).

7) Boas práticas de segurança e organização

Nunca compartilhe seu token em grupos, prints, vídeos ou repositórios públicos.
Se o token vazar, rode /revoke imediatamente.
Habilite a verificação em duas etapas na sua conta Telegram (Configurações › Privacidade e Segurança).
Use um ambiente separado (ex.: um projeto dedicado) para armazenar o token.
Se o bot for para grupos, mantenha /setprivacy → Enable por padrão.
Documente seus comandos e mantenha tudo atualizado no /setcommands.

8) “Por que meu bot não responde?”

Alguns motivos comuns:

Você ainda não conectou o token a um backend (código) ou a uma plataforma (ex.: QuanthraAI).
O bot está em grupo com privacidade Enable e você não usa / nos comandos.
Os /setcommands não aparecem: feche e reabra o Telegram, ou toque no ícone “/” no campo de digitação.
A foto não atualizou: é cache; tente aguardar alguns minutos.
@username indisponível: tente variações, use underscore _ e garanta que termina com bot.

9) Tabela-resumo (cola) dos principais comandos do BotFather

Criando um Bot no Telegram

@BotFather Telegram