A tela Configurações do bot reúne o nome do bot no painel, a conexão com o Telegram (o token), quem administra o bot no Telegram, o perfil que aparece para quem abre a conversa e os sub-bots que usam as mesmas configurações.
Como chegar
Menu → Configuração → Configurações do bot.
Bot principal
- Nome no painel: o nome que identifica o bot dentro do painel.
- Conexão com o Telegram: mostra o @ do bot, o ID e se o token está configurado. Trocar token abre o campo Novo token do BotFather. O token precisa ser do mesmo bot (mesmo ID). Cancelar troca desiste sem mudar nada.
- Acesso no Telegram: dono e administradores podem usar os comandos de administrador do bot, como
/broadcast. Os acessos ao painel são outra coisa e ficam em Organização.- Dono no Telegram (opcional): busque por nome, @usuário ou ID. Para mudar, clique em Trocar.
- Administradores adicionais: busque e adicione quantos precisar. O X ao lado do nome remove.
A busca mostra quem já conversou com o bot no privado. Quem ainda não conversou precisa mandar /start ao bot, ou você digita o ID do Telegram da pessoa.
Clique em Salvar alterações. Recarregar dados busca o que está salvo. Com alterações pendentes, o botão vira Descartar alterações e recarregar. Se a configuração mudar em outra sessão enquanto você edita, o painel guarda o seu rascunho e pede para recarregar antes de salvar.
Quem pode mudar o quê:
- O responsável pela organização muda tudo, inclusive o token e o acesso.
- Admin da organização muda só o Nome no painel.
- Membro só lê.
Os admins do bot também podem ser promovidos pela tela Chats, com Tornar admin.
Perfil no Telegram
Como o bot aparece para quem abre a conversa. O painel salva direto no Telegram.
- Foto: Pôr foto ou Trocar foto, e a lixeira remove. O painel converte a imagem para JPEG de até 1280 px, o formato que o Telegram aceita.
- Nome: até 64 caracteres.
- Descrição curta: até 120 caracteres. Aparece no perfil e quando alguém compartilha o bot.
- Descrição: até 512 caracteres. É o que a pessoa lê antes de tocar em Iniciar.
- Botão de menu (ao lado do campo de texto): Padrão do Telegram, Lista de comandos ou Abrir uma página. Na última opção, informe o texto do botão e o link da página.
- Permissões sugeridas ao pôr o bot num grupo: marque os direitos que o Telegram já deixa marcados quando alguém adiciona o bot como admin. Usar as recomendadas marca as cinco recomendadas: Apagar mensagens, Banir e restringir membros, Convidar por link, Fixar mensagens e Gerenciar o grupo. O Porteiro, a limpeza e as mensagens só para quem pediu precisam delas.
- Converter por menção (Guest Mode): mostra se está ligado. Ligado, a pessoa responde a um post com link mencionando o bot, em qualquer chat, e o bot devolve o post com os seus links, mesmo sem estar no grupo. Para ligar, abra o Mini App do BotFather, escolha o bot e ligue Guest Mode.
- Pedidos de entrada (Join Request Queries): mostra se está ligado. Para ligar, abra o Mini App do @BotFather, escolha o bot e ligue os pedidos de entrada. Depois, em cada grupo ou canal, defina este bot como o que analisa os pedidos e escolha como a pessoa entra em Comunidade → Proteção (Quem entra). Veja Grupos.
Clique em Salvar no Telegram. Descartar desfaz o que não foi salvo. O @ do bot, apagar e transferir o bot continuam só no BotFather.
Dono e admins da organização editam o perfil.
Segurança do bot
Aparece só em bot criado pelo painel (“Disponível porque este bot foi criado pelo painel”).
- Token: se o token vazou, clique em Gerar token novo e confirme. O token antigo para na hora e o bot continua funcionando com o novo, sem você precisar ver ou copiar nada. Integrações de fora que usem o token antigo param.
- Só pessoas escolhidas podem usar o bot: ligado, só você (dono) e até 10 pessoas usam o bot. Informe os IDs do Telegram separados por vírgula e clique em Salvar acesso.
Só o dono do bot muda estas opções.
Gerenciar sub-bots
Clique em Gerenciar sub-bots para abrir a lista de outros bots do Telegram que usam estas mesmas configurações. O recurso exige o módulo Sub-bots. Veja Sub-bots.
Atalhos da conta
No fim da página ficam os links Organização e membros e Assinaturas e módulos (só para o responsável pela organização) e Meu perfil e segurança. Veja Organização e Perfil e segurança.
Trocar o token de um bot conectado pelo BotFather
- No BotFather, gere um token novo para o mesmo bot.
- Em Configurações do bot → Bot principal, clique em Trocar token.
- Cole o token em Novo token do BotFather.
- Clique em Salvar alterações.
Se aparecer “Use um token do mesmo bot”, o token colado é de outro bot.
Limites e cuidados
- O token só troca dentro do mesmo bot. Para outro bot, use Gerenciar sub-bots.
- Admin do bot não é membro da organização. Os papéis do painel estão em Equipe e papéis.
- O token e as credenciais ficam protegidos no servidor. Veja Segurança e tokens.