Telegram

Uma visita ao BotFather, uma colagem

O Telegram só permite criar bots dentro do próprio Telegram, conversando com uma conta chamada @BotFather. Isso vale para qualquer serviço, não só para o ProxyAI. Por isso a janela abre com um tutorial curto que leva cerca de noventa segundos e uma colagem.

Abra Configurações → Canais na barra lateral do painel e, no cartão Telegram, escolha Configurar.

O tutorial no topo, Crie o seu bot (cerca de 90 segundos), oferece:

1. Um botão Abrir BotFather que leva direto a esse chat.
2. Um toque para copiar o comando /newbot e enviá-lo lá.
3. Um pedido do nome de exibição, qualquer um que você quiser.
4. Um pedido do nome de usuário; o Telegram exige que ele termine em bot, por exemplo acme_suporte_bot.
5. A resposta do BotFather, que contém o código que você cola aqui.

O tutorial desaparece depois que você salva um bot, então um canal já configurado mostra apenas suas configurações.

Trate esse código como uma senha. Se ele vazar, envie /revoke ao BotFather, pegue o novo código e salve aqui.

Preencha a janela

Token do bot: cole o código que o BotFather enviou. É o único campo obrigatório.

Nome de usuário do bot: sem o @. O ProxyAI verifica o nome de usuário real no Telegram ao salvar, então um pequeno erro aqui se corrige sozinho.

Modo de privacidade: informa ao ProxyAI o que esperar nos grupos. A configuração em si fica no BotFather, não aqui.

• Privacidade de grupo ativada (padrão do Telegram): em grupos, o bot só vê comandos, respostas às próprias mensagens e mensagens que o mencionam com @.
• Todas as mensagens do grupo: o bot vê tudo o que é dito em um grupo. Para isso valer de fato, primeiro envie /setprivacy ao BotFather e escolha Disable, depois remova o bot de cada grupo e adicione-o de novo. Um bot que é administrador do grupo sempre vê tudo, de qualquer forma.

Botão de menu e Teclado inline: você pode definir estes agora, mas as respostas do bot ainda não mostram botões, então não espere nenhuma mudança visível no Telegram hoje.

O que acontece ao salvar

O ProxyAI verifica o código com o Telegram e conecta o seu bot para você. Não há nada para colar de volta no BotFather.

Se o salvamento falhar:

• Token inválido: o código foi substituído ou cancelado depois que você o copiou. Gere um novo no BotFather.
• Falha no webhook: o código estava certo, mas a conexão não foi concluída, geralmente uma falha passageira. Salve de novo.

Teste

Abra o seu bot no Telegram, envie uma mensagem e confira a resposta. Depois adicione-o a um grupo e confirme que ele se comporta como você escolheu no Modo de privacidade. É a configuração mais mal interpretada: alterá-la no BotFather não afeta os grupos em que o bot já está; remova e adicione o bot de novo nesses grupos.

Respostas muito longas são cortadas para caber no limite de mensagem do Telegram, em vez de falharem no envio.