LanaChat
PT
EnglishFrançaisEspañolPortuguêsItalianoDeutschPolskiRomânăРусскийУкраїнська

Criar o bot do Telegram de uma conta (BotFather, Secretary Mode, token)

Leitura de 9 minAtualizado Markdown

Abrir no Console

Para criar o bot do Telegram de uma conta LanaChat, envie /newbot ao @BotFather no Telegram, ative o Secretary Mode do bot e depois cole no LanaChat o token que o BotFather envia. Leva três minutos, é grátis e o Telegram Premium não é necessário.

Cada conta do Telegram no LanaChat responde aos fãs com um bot próprio. Estes três passos são feitos uma vez por bot, no passo Create the bot do assistente Add account (Studio › Telegram Accounts). Em seguida, vincule o bot à conta do Telegram da criadora, no Telegram Business (última parte deste guia).

Antes de começar #

  • Telegram aberto num celular ou computador, em qualquer conta do Telegram (a sua serve: o bot não fica preso à conta que o cria).
  • Na Console: Studio › Telegram Accounts → Add account, com os passos Creator e Details concluídos. Você chega ao passo 3, Create the bot.
  • Acesso à conta do Telegram da criadora para a última parte (a vinculação no Telegram Business).

Passo 1: criar o bot com /newbot #

  1. No Telegram, procure @BotFather e abra-o. Confira o selo azul: é o único oficial.
  2. Toque em Start e envie /newbot.
  3. O BotFather pede um nome. É o nome exibido do bot, por exemplo *Julia Assistant*. Qualquer texto serve, com espaços, e você pode mudá-lo depois.
  4. O BotFather pede um nome de usuário. É o @ do bot, único em todo o Telegram. As regras:
    • De 5 a 32 caracteres: apenas letras, números e _, sem espaços nem hífen.
    • Deve terminar em bot (ou Bot), por exemplo julia_it_5_bot ou JuliaItBot.
    • Não pode ser alterado depois: escolha um que você reconheça na lista.
  5. O BotFather responde *Done! Congratulations on your new bot.* com o link do bot e o seu token.

Dica Dê ao bot o nome da conta que ele vai gerir, por exemplo julia_it_meta_5_bot para a conta *Julia IT Meta Ads 5*. Com várias contas, você vê num relance qual bot gere cada uma.

O nome de usuário já está em uso: e agora? #

O BotFather responde *Sorry, this username is already taken.* Os nomes de usuário são únicos em todo o Telegram: acrescente uma palavra ou um número e envie de novo: julia_it_5_bot, depois julia_it_5b_bot, e assim por diante. Se o BotFather responder que o nome de usuário é inválido, confira se ele termina em bot e usa apenas letras, números e _.

No assistente, marque a primeira caixa e digite o nome de usuário em Enter the bot username (com ou sem o @). O campo só o aceita se seguir as regras acima.

Passo 2: ativar o Secretary Mode (obrigatório) #

Secretary Mode é o novo nome que o BotFather dá ao Business Mode. Sem ele, o Telegram recusa o bot no Telegram Business e a conta nunca consegue se conectar.

  1. No @BotFather, envie /mybots.
  2. Escolha o bot que acabou de criar.
  3. Toque em Bot Settings, depois em Secretary Mode e depois em Turn on.
  4. O BotFather confirma: *Secretary Mode is currently enabled for @your_bot*.

Marque a caixa Turn on Secretary Mode no assistente só quando vir essa frase. A caixa está marcada como obrigatória: Next fica bloqueado sem ela.

Passo 3: colar o token no LanaChat #

O token está na mensagem *Done! Congratulations* do BotFather, depois de *Use this token to access the HTTP API*. Ele tem este formato: 12345678:AAxxxx…, ou seja, de 8 a 10 números, dois-pontos e depois 35 caracteres.

  1. No BotFather, toque no token para copiá-lo inteiro.
  2. No assistente, cole-o em Paste the token BotFather sent.
  3. O LanaChat o verifica e mostra *Token accepted. It is never shown again.* Toque em Next.

Se perdeu a mensagem, envie /mybots no @BotFather, escolha o bot e depois API Token: o BotFather o mostra de novo.

Mantenha o token em segredo #

O token é a senha do bot: quem o tiver pode ler e enviar mensagens como o bot, ou seja, na conta da criadora.

  • Cole-o apenas no LanaChat. Nunca o envie num chat, e-mail, captura de tela ou ticket de suporte. O suporte do LanaChat nunca o pede.
  • Se ele vazou, revogue-o imediatamente: no @BotFather envie /revoke e escolha o bot (ou /mybots → o bot → API Token → Revoke current token). O token antigo para de funcionar na hora e o BotFather envia um novo.
  • Depois entregue o novo token ao LanaChat: em Studio › Telegram Accounts, abra o menu Actions da linha → Replace bot token e cole-o. Ali só é aceito um novo token do mesmo bot.

Vincular o bot à conta da criadora #

O assistente passa então ao passo 4, Connect in Telegram. Na conta do Telegram da criadora (não na conta que criou o bot):

  1. Abra Settings → Telegram Business → Chat Automation (em algumas versões, Chatbots).
  2. Adicione o bot pelo seu @ (o assistente tem um botão Copy) e mantenha *All Private Chats Except…*.
  3. Em Bot permissions, ative Manage Messages (marcado como Required): o LanaChat não consegue responder sem ele.
  4. Manage Profile, Manage Gifts and Stars e Manage Stories são opcionais, recomendados. Dentro de Gifts and Stars, deixe Transfer Stars e Transfer and Upgrade Gifts desativados, a menos que queira que o LanaChat movimente dinheiro.

A janela passa sozinha para Connected as @username. Toque em Done. A IA da nova conta está desligada: ligue-a quando a criadora estiver pronta. Os status e o que fazer se a conexão ficar esperando estão em Conectar contas do Telegram.

Quais são os erros mais comuns? #

  • Secretary Mode esquecido: o bot não pode ser adicionado em Chat Automation, ou a conta fica em Waiting for Telegram. Ative-o no @BotFather (passo 2) e adicione o bot de novo no Telegram.
  • Token mal colado: *This is not a bot token: 8 to 10 digits, a colon, then 35 characters.* ou *Token not accepted*. Basta um espaço, uma quebra de linha ou um caractere faltando. Copie-o de novo no BotFather e cole-o sozinho.
  • Token de outro bot: ao substituir um token, o token de outro bot é recusado (*This token belongs to another bot*). Cole o novo token do mesmo bot.
  • Bot já usado por outra conta: o assistente mostra *This bot is already in use* e oferece Use it for this account too. Aceite só para uma conta da mesma criadora: as Stars das duas contas caem no mesmo saldo do bot. Caso contrário, crie um bot novo com /newbot.
  • Manage Messages desativado: a conta se conecta, mas o LanaChat não consegue responder. Em Chat Automation, ative Manage Messages com Reply to Messages.
  • Bot adicionado na conta do Telegram errada: o bot deve ser adicionado na conta da criadora, aquela para a qual os fãs escrevem. Uma conta do Telegram mantém um só bot por vez: adicionar um novo substitui o anterior.

FAQ #

Criar um bot do Telegram custa alguma coisa? #

Não. O @BotFather cria bots de graça, e o Telegram Premium não é necessário para um bot Secretary gerir uma conta.

Posso criar o bot pela minha própria conta do Telegram? #

Sim. O bot pertence à conta do Telegram que o criou no BotFather, mas pode ser adicionado a qualquer conta no Telegram Business. Só a última parte (Chat Automation) precisa ser feita na conta da criadora.

Preciso de um bot por conta do Telegram? #

Por padrão, sim: um bot por conta mantém separadas as Stars de cada conta. Um bot também pode gerir várias contas da mesma criadora, escolhido em Use an existing bot no passo 3.

Posso renomear o bot depois? #

O nome, sim: /mybots → o bot → Edit Bot → Edit Name. O nome de usuário (o @) não pode ser alterado: crie um bot novo e use Change bot em Edit da conta se precisar de outro.

O que faço se o meu token vazou? #

Envie /revoke ao @BotFather e escolha o bot: o token antigo para de funcionar na hora. Depois cole o novo em Studio › Telegram Accounts, linha Actions → Replace bot token.

Por que o BotFather não mostra o Secretary Mode? #

Atualize o aplicativo do Telegram, envie /mybots de novo e abra Bot Settings. Em versões antigas, a opção ainda se chama Business Mode: ative-a, é o mesmo botão.

Mais informações na página do recurso Contas do Telegram.

As últimas novidades da Lana no Telegram

Novidades e notícias, primeiro no canal.

Entrar no canal do Telegram