Pular para o conteúdo

GuiaPublicado em 9 min de leitura

Como criar um bot no Telegram pelo celular e pegar o token

Crie o bot no BotFather em poucos minutos, guarde o token como uma senha e ponha o bot como administrador do grupo ou canal, com as permissões certas.

Para criar um bot no Telegram, abra o @BotFather, mande /newbot e escolha um nome e um nome de usuário que termine em “bot”. Na mesma hora o BotFather responde com o token, o código que dá controle do bot. Não precisa programar nem usar computador, e criar o bot não custa nada.

Se o bot vai vender acesso a um grupo ou canal, falta mais um passo: pôr o bot como administrador, com as permissões Banir Usuários e Convidar Usuários via Link. Sem elas, ele não cria o convite de quem comprou nem tira quem venceu. A venda em si está no guia do grupo VIP no Telegram.

Como criar o bot no Telegram pelo BotFather, passo a passo

O BotFather é o bot do próprio Telegram que cria e edita bots. Tudo acontece numa conversa com ele, no app do celular ou no computador.

  1. Abra o BotFather

    No Telegram, toque na lupa e busque @BotFather. Confira que o @ é exatamente @BotFather. Abra a conversa e toque em Iniciar.

  2. Mande /newbot

    Digite /newbot e envie. O BotFather escreve em inglês: primeiro pede o nome (name), depois o nome de usuário (username).

  3. Escolha o nome

    É o nome que aparece no topo da conversa e nos contatos, como “Atendimento da Ana”. Pode ter espaço e acento, e dá para trocar depois.

  4. Escolha o nome de usuário

    É o @ do bot, usado na busca e no link t.me. Tem de terminar em “bot” (como loja_da_ana_bot ou LojaDaAnaBot), ter de 5 a 32 caracteres e usar só letras sem acento, números e sublinhado. Maiúscula e minúscula contam igual. Se o @ já tiver dono, escolha outro.

  5. Copie o token

    O BotFather responde com o link do bot e o token, uma sequência de números, dois pontos e uma mistura de letras e números, parecida com 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw (o exemplo da documentação do Telegram). Copie o token.

Prefere telas com botões? O BotFather também tem um mini app com as mesmas funções (abre em nova aba).

O @ do bot não muda depois

O nome muda quando você quiser; o nome de usuário, não. Escolha um @ que sirva para a sua marca por muito tempo. Não use “Telegram” no nome nem no @: os termos do Telegram para bots proíbem usar a marca dele.

Como guardar o token e o que fazer se vazar

O token é a senha do bot. Quem tem o token tem controle total do bot: recebe o que chega para ele, responde no lugar dele e pode ligá-lo em outro sistema. Os termos do Telegram para desenvolvedores proíbem deixar o token público e dizem que o que alguém fizer com ele conta como feito pelo dono do bot.

  • Nunca poste o token em grupo, story, vídeo, print ou comentário.
  • Cole o token só no painel da ferramenta que vai usar o bot. Ninguém de suporte precisa dele por mensagem.
  • Guarde uma cópia num gerenciador de senhas, nunca num print na galeria.

Como pegar o token de um bot que você já criou

O token não some depois de criado. No BotFather, mande /mybots, escolha o bot e toque em API Token: o token atual aparece para copiar. Só troque o token se ele vazou, porque a troca derruba o bot em todo lugar que usa o antigo.

Se o token vazou

Troque o token na hora. No BotFather, mande /mybots, escolha o bot, toque em API Token e use a opção de revogar o token atual: o BotFather mostra o token novo. A documentação do Telegram também indica o comando /token para gerar um token novo quando o atual vazou ou se perdeu.

Confira o resultado: a parte depois dos dois pontos tem de ser diferente da antiga. Se o token vier igual, a troca não aconteceu.

O token antigo para de funcionar na hora. Logo depois de trocar, cole o token novo em todo lugar que usava o antigo, ou o bot fica mudo. Na LibertyBot, o card do bot mostra Atualizar Token quando o token antigo para de valer, e é ali que você cola o novo (veja onde o token entra na LibertyBot).

Foto, descrição e comandos do bot

A foto e a descrição são o que a pessoa vê antes de tocar em Iniciar. Arrume as duas no próprio BotFather: em cada comando ele pergunta qual bot editar.

Comandos do BotFather para deixar o bot apresentável
ComandoO que mudaOnde aparece
/setnameO nome do botNo topo da conversa e nos contatos
/setdescriptionTexto de até 512 caracteresNa caixa “O que este bot pode fazer?”, com a conversa ainda vazia
/setabouttextTexto de até 120 caracteresNo perfil do bot e junto do link quando alguém compartilha o bot
/setuserpicA foto do botNo perfil e na lista de conversas
/setcommandsA lista de comandosNo menu que abre quando a pessoa digita /
/mybotsTudo acima, por botões-

Na descrição, diga em uma frase o que o bot entrega, como “Aqui você escolhe o plano e recebe o convite do grupo”. Na foto, use uma imagem quadrada que dê para reconhecer mesmo pequena.

Como adicionar o bot ao grupo como administrador

Um bot que vende acesso faz duas coisas no grupo: cria o convite de quem comprou e tira quem venceu. Para o Telegram, as duas exigem que o bot seja administrador com a permissão certa. Como membro comum, ele não faz nenhuma das duas. Como tirar alguém, na mão ou no vencimento, está em como remover membro do grupo do Telegram.

Vai usar a LibertyBot?

Conecte o token na LibertyBot antes de pôr o bot como administrador, no grupo e no canal. Ela fica sabendo do grupo pelo aviso que o Telegram manda na hora em que o bot vira administrador. O caminho está em onde o token entra na LibertyBot.

  1. Abra as informações do grupo

    Entre no grupo e toque no nome ou na foto do grupo, no topo da tela.

  2. Entre em Administradores

    No Android, toque no lápis no canto de cima e depois em Administradores. No iPhone, abra as configurações do grupo e toque em Administradores.

  3. Adicione o bot como administrador

    Toque em Adicionar Admin (em algumas versões do app, Adicionar Administrador) e busque o @ do bot.

  4. Ligue as duas permissões

    Deixe ligadas pelo menos Banir Usuários e Convidar Usuários via Link. O nome exato muda um pouco entre Android, iPhone e computador. Salve.

O erro mais comum: o bot só como membro

Adicionar o bot pelo botão de adicionar membros não basta. Ele entra, aparece na lista e não consegue gerar convite nem remover ninguém. Se o bot já está no grupo como membro, promova: em Administradores, toque em Adicionar Admin e escolha o mesmo bot.

O Telegram não deixa pôr o bot no grupo?

Mande /setjoingroups ao BotFather, escolha o bot e ligue a entrada em grupos.

Como adicionar o bot ao canal como administrador

No canal o caminho é parecido: toque no nome do canal no topo, depois em editar e em Administradores. Toque em Adicionar Admin (em algumas versões do app, Adicionar Administrador) e busque o @ do bot. No canal, adicione o bot direto como administrador, nunca como inscrito.

A lista de permissões do canal é outra. Deixe ligada a de convidar pessoas (no iPhone, Adicionar Inscritos; no Android, Adicionar Usuários ou Convidar Usuários via Link): sem ela, o bot não cria links de convite. Deixe ligada também Banir Usuários: é com ela que o bot tira quem venceu. Para vender acesso, o bot não precisa publicar no canal. O resto da montagem do canal está em como criar um canal pago no Telegram.

Para quem programa

Na Bot API, os direitos são can_invite_users e can_restrict_members. Sem eles, createChatInviteLink e banChatMember falham.

Onde o token entra na LibertyBot

A LibertyBot não cria o bot por você: você cria no BotFather, como acima, e conecta pelo token. No painel, o caminho é este:

  1. Abra Meus Robôs

    No celular, toque em Robôs na barra de baixo; no computador, abra Meus Robôs no menu. Toque em Conectar Bot: abre a tela Criar Novo Bot.

  2. Cole o token

    Cole no campo Token do Bot. A LibertyBot confere o token no Telegram e preenche o nome e o @ do bot sozinha.

  3. Escolha o fluxo

    O campo Fluxo é opcional: dá para escolher depois.

  4. Toque em Criar Bot

    O bot aparece como um card em Meus Robôs.

O token fica guardado com criptografia e não aparece de novo na tela depois de salvo. Tem vários bots? Na aba Vários bots, cole um token por linha e crie todos de uma vez. Ao conectar, a LibertyBot troca a lista de comandos do bot por /start, /suporte e /status. A lista que você montou com /setcommands no BotFather sai, então não precisa montar comandos lá.

Depois de conectado, o botão de editar do card (o lápis) troca foto, nome, descrição, descrição curta e o texto e a ordem dos comandos, e a mudança vai direto para o Telegram. A LibertyBot confere os bots a cada 5 minutos: se o token for revogado, o card fica vermelho e mostra Atualizar Token, onde você cola o token novo.

Para entregar o acesso, no plano do fluxo escolha Grupo/Canal VIP em Como entregar. A lista só mostra grupos e canais em que um bot do fluxo já é administrador. A LibertyBot fica sabendo disso pelo aviso que o Telegram manda na hora em que o bot vira administrador. Se você pôs o bot como administrador antes de conectar o token e o grupo não aparece, tire o bot de administrador, adicione de novo e toque em Atualizar.

O bot manda um link por compra, com validade, e, por padrão, no vencimento tira a pessoa do grupo sem deixá-la banida. O resto do caminho está no guia do grupo VIP no Telegram e no guia do canal pago. O que o bot de vendas para Telegram faz em cada conversa está na página inicial.

Perguntas frequentes

Criar bot no Telegram é de graça?

Sim. O Telegram diz que a plataforma de bots é gratuita para quem usa e para quem cria. O BotFather não cobra para criar nem para editar o bot.

O que é o token do bot?

É a senha do bot: uma sequência de números, dois pontos e uma mistura de letras e números que o BotFather entrega quando você cria o bot. Toda ferramenta que vai responder pelo bot precisa dele, e quem tem o token controla o bot.

Dá para trocar o @ do bot depois?

Não. O nome que aparece no topo da conversa muda com /setname, mas o nome de usuário terminado em bot fica para sempre. Se errou, crie outro bot com /newbot. O comando /deletebot apaga o bot errado e libera o @ dele, e isso não tem volta.

Posso usar o mesmo bot em dois grupos?

Sim. Um bot pode ser administrador de vários grupos e canais, e em cada um você liga as permissões de novo. Na LibertyBot, cada plano escolhe o seu grupo ou canal.

Posso ligar o mesmo bot na LibertyBot e em outra ferramenta?

Não ao mesmo tempo. O Telegram entrega as mensagens do bot num endereço só (o webhook), e a última ferramenta que se liga fica com elas. Se isso acontecer, o card do bot na LibertyBot mostra Atualizar Token. Use um bot para cada ferramenta.

Fontes (conferidas em )

Leia também

  • Guia13 min de leitura

    Como criar um grupo VIP pago no Telegram

    O caminho completo para montar um grupo VIP pago no Telegram: do grupo privado ao convite de quem pagou e à saída de quem venceu.

  • Guia9 min de leitura

    Como criar um canal pago no Telegram

    O canal privado, a escolha entre grupo e canal, a assinatura em Stars do próprio app e a cobrança em reais com um bot, com fonte do Telegram.

  • Guia9 min de leitura

    Como remover membro do grupo do Telegram, na mão ou no vencimento

    Remover pelo app, banir ou deixar o bot tirar quem não renovou: o que cada caminho faz e quando a pessoa consegue voltar pelo link.

Venda pelo Telegram sem fazer tudo na mão

O bot mostra os planos, gera o PIX, confere o pagamento no gateway e manda o convite do grupo.

Criar conta grátis

Conta grátis. R$ 0,50 por venda no PIX, 5% no cartão.