Pular para o conteúdo principal

Atendimento ao cliente

Guia do BotFather: como criar um bot no Telegram e obter o token

O BotFather é o bot oficial do Telegram para criar e gerenciar bots. Veja cada passo, do /newbot até um token funcionando, as configurações de um bot para empresas, o que fazer se o token vazar e como ligar o bot à caixa de entrada da equipe.

Equipe MonoChat Atualizado: 4 min de leitura

Nesta página
  1. Passo 1: crie o bot com /newbot
  2. Passo 2: guarde o token com segurança
  3. Passo 3: configure o perfil que o cliente vê
  4. Passo 4: divulgue o bot
  5. Passo 5: conecte o bot ao MonoChat
  6. Erros comuns
  7. Fontes

O BotFather (@BotFather) é o bot oficial do Telegram para criar e gerenciar bots. Você manda /newbot, escolhe um nome e um nome de usuário, e ele responde com o token do seu bot: a chave que permite a um software como o MonoChat receber e enviar mensagens como o seu bot. Leva uns dois minutos; os detalhes abaixo são o que mantém o bot seguro e funcionando depois.

Passo 1: crie o bot com /newbot

  1. No Telegram, procure @BotFather e abra a conta com o selo azul de verificação.
  2. Envie /newbot.
  3. Envie o nome que os clientes verão no chat, por exemplo “Clínica Sorriso Pinheiros”. Dá para trocar depois com /setname.
  4. Envie o nome de usuário: de 5 a 32 caracteres, letras latinas sem acento nem ç, números e sublinhado, terminando em “bot”, como sorrisopinheiros_bot ou SorrisoPinheirosBot. Não diferencia maiúsculas e não pode ser alterado depois, então escolha como escolheria um domínio.
  5. O BotFather confirma com uma mensagem que traz o link do bot (t.me/sorrisopinheiros_bot) e o token, no formato 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw.

Se o nome de usuário já estiver em uso, tente uma variação com a sua cidade ou um sublinhado; nomes de usuário são únicos em todo o Telegram.

Passo 2: guarde o token com segurança

O token é a senha do bot. Quem tem o token consegue ler as mensagens que chegam ao bot e enviar mensagens em nome dele.

  • Guarde no seu gerenciador de senhas, nunca em chat, e-mail ou documento compartilhado.
  • Cole somente na ferramenta que roda o bot.
  • Se vazou, ou se um ex-funcionário ou agência tinha acesso, envie /token ao BotFather para gerar um novo e atualize a ferramenta.
  • Para ver seus bots e as configurações, envie /mybots quando quiser.

Passo 3: configure o perfil que o cliente vê

Estes comandos do BotFather definem o que o cliente vê antes da primeira mensagem:

ComandoO que configuraDica para bot de empresa
/setuserpicFoto do perfilSeu logo, quadrado e legível em tamanho pequeno
/setdescriptionO texto em “O que este bot pode fazer?” (até 512 caracteres)O que dá para perguntar e quando uma pessoa responde
/setabouttextA linha do perfil e dos links compartilhados (até 120 caracteres)Uma frase e seu horário de atendimento
/setcommandsO menu que aparece ao digitar ”/“/start, /help e dois ou três seus, como /agendar ou /pedido
/setprivacyQuais mensagens de grupo o bot recebeDeixe a privacidade ligada se o bot não precisa ler tudo
/setjoingroupsSe o bot pode ser adicionado a gruposDesligue para um bot de atendimento individual

Passo 4: divulgue o bot

O bot não consegue puxar conversa: a pessoa precisa abrir e tocar em Começar, ou adicioná-lo a um grupo. Por isso o link é o seu canal de crescimento:

  • Coloque t.me/<usuario> no site, na nota fiscal, na embalagem e nas redes sociais, ou mostre como QR code no balcão.
  • Acrescente um parâmetro para saber a origem: t.me/sorrisopinheiros_bot?start=instagram chega ao bot como /start instagram. Aceita letras, números, _ e -, até 64 caracteres.

Passo 5: conecte o bot ao MonoChat

O MonoChat conecta o seu bot pelo token, sem código:

  1. No MonoChat, vá em Configurações › Chat › Canais e clique em Conectar.
  2. Escolha Telegram Bot.
  3. Cole o token do BotFather em Chave do bot do Telegram e clique em Salvar.

As mensagens para o seu bot passam a chegar na caixa de entrada da equipe, ao lado do WhatsApp, do Instagram e dos outros canais. Dali você coloca um assistente de IA que responde com o seu próprio conteúdo, passa conversas para a equipe e envia transmissões no Telegram para todos que iniciaram o bot.

Erros comuns

  • Ligar um bot a duas ferramentas. O bot recebe as atualizações por webhook ou por polling, não pelos dois; a segunda ferramenta “rouba” as mensagens da primeira sem avisar. Um bot por ferramenta.
  • Apagar em vez de renomear. /deletebot apaga o bot, libera o nome de usuário e não tem volta. Para mudar a marca, troque o nome e a foto.
  • Passar o bot para uma agência de vez. A transferência (/mybots › seu bot › Transfer ownership) só é possível para quem já usou o bot e é definitiva. Mantenha o bot numa conta da empresa.
  • Enviar rápido demais. O Telegram pede que os bots não passem de cerca de uma mensagem por segundo num chat, 20 por minuto num grupo e cerca de 30 por segundo em envios em massa.

Nosso guia de Telegram para empresas compara bots com contas Business, canais e grupos.

Você pode começar grátis em app.monochat.ai.

Fontes

Perguntas frequentes

Perguntas frequentes

Onde encontro o token do meu bot do Telegram?

O BotFather envia o token na mensagem que confirma a criação do bot. Se você perdeu ou acha que outra pessoa tem acesso, envie /token ao BotFather para gerar um novo e cole na ferramenta que roda o seu bot.

O BotFather é gratuito?

Sim. Criar e gerenciar bots com o BotFather não custa nada, e o bot pode enviar mensagens grátis para quem o iniciou. Só são cobradas as transmissões pagas acima de cerca de 30 mensagens por segundo, em Telegram Stars.

Posso mudar o nome de usuário do bot depois?

Não. O nome de usuário terminado em "bot" fica fixo assim que o BotFather cria o bot. O nome de exibição, a descrição, o texto "Sobre" e a foto podem ser alterados quando quiser.

O que acontece se alguém pegar o token do meu bot?

A pessoa passa a controlar o bot: lê as mensagens que ele recebe e envia mensagens em nome dele. Envie /token ao BotFather na hora para gerar um novo e troque o token em todas as ferramentas que usam o bot.

Por que meu bot parou de responder depois que liguei a uma segunda ferramenta?

O bot recebe as mensagens por um único webhook ou por polling, nunca pelos dois. Quando a segunda ferramenta configura o próprio webhook, a primeira deixa de receber. Ligue cada bot a uma ferramenta só e crie um segundo bot para testes.

Primeiro mês de Growth por nossa conta

Gerencie WhatsApp, Instagram e Messenger em uma só caixa de entrada

Comece grátis com o MonoChat: caixa de entrada da equipe, assistentes de IA, modelos de mensagem e campanhas nas APIs oficiais da Meta.

Um código por empresa • 30 dias para resgatar • Sem cartão de crédito

US$ 150 para começar.

Resgatar