Telegram

Neste guia, vamos conectar seu Assistente de IA ao Telegram em dois passos:

1. Criar um bot do Telegram com o BotFather
2. Conectar o bot ao Quickchat AI

Se travar, vá para Solução de problemas e FAQs ou fale conosco.

Passo 1 — Crie seu bot do Telegram

Os bots do Telegram são criados pelo BotFather, o bot oficial do Telegram para gerenciar bots. Tudo acontece dentro de um chat normal do Telegram, então não há nenhum portal de desenvolvedor no qual se cadastrar.

1. Abra o Telegram e inicie um chat com o @BotFather (procure o selo azul de verificação).
2. Envie /newbot.
3. Escolha um nome para o seu bot. É o nome de exibição que as pessoas veem no chat, por exemplo “Acme Support”.
4. Escolha um nome de usuário. Ele deve ser único e terminar em bot, por exemplo acme_support_bot.

O BotFather responde com o seu token do bot, uma sequência parecida com 5175890488:AAEI8qpz.... Você vai colá-lo no Quickchat no próximo passo, então mantenha o chat aberto.

Cuidado

Trate o token do bot como uma senha. Qualquer pessoa que o tenha pode controlar o seu bot. Se ele vazar, envie /revoke ao BotFather para invalidar o token antigo e gerar um novo.

Dica

Você pode personalizar o seu bot a qualquer momento pelo BotFather: /setdescription, /setabouttext, /setuserpic (foto de perfil) e /setcommands. Envie /help para ver a lista completa.

Passo 2 — Conecte seu bot ao Quickchat AI

1. Abra o App do Quickchat AI e vá em External Apps.
2. Clique em Telegram.
3. Ative a integração e cole o seu token do bot.
4. Salve.

Pronto. Seu Assistente de IA já está online no Telegram! 🎉

Experimente

Abra seu bot no Telegram (o BotFather fornece um link t.me/<nome_do_seu_bot>) e envie /start. Seu Assistente de IA responde com a mensagem de boas-vindas e depois responde a tudo o que você perguntar.

Cada conversa também aparece na sua Caixa de entrada do Quickchat AI, onde você pode ler a transcrição completa, ver o nome do visitante no Telegram e assumir o controle da IA a qualquer momento.

Solução de problemas e FAQs

Meu bot não responde.

• Verifique se a integração do Telegram está ativada e se o token do bot foi colado corretamente (sem espaços extras). Na dúvida, faça /revoke no BotFather e cole o novo token.
• Envie /start ao bot primeiro. É assim que o Telegram ativa o chat.
• Um bot se conecta a um único Assistente de IA. Não reutilize o mesmo token em vários Agentes Quickchat AI.

O bot funciona em grupos?

• Sim, mas por padrão os bots do Telegram funcionam em modo de privacidade (privacy mode): o bot só vê as mensagens que o mencionam diretamente ou que começam com /. Para que seu Assistente de IA responda a todas as mensagens de um grupo, abra o BotFather, envie /setprivacy, escolha seu bot e selecione Disable; depois remova o bot do grupo e adicione-o novamente.

Como altero a mensagem de boas-vindas?

• A mensagem enviada no /start é a saudação do seu Assistente de IA, configurada no App do Quickchat AI. Atualize-a lá e ela se aplica a todos os canais, incluindo o Telegram.

Posso conectar um bot que eu já tenho?

• Com certeza. Abra-o no BotFather, execute /token para recuperar o token (ou /revoke para redefini-lo) e cole-o na integração do Telegram. Não é preciso criar um novo bot.

O bot consegue lidar com imagens e arquivos?

• As fotos são analisadas pelo seu Agente de IA, que pode descrevê-las e responder a perguntas sobre o conteúdo. Para outros arquivos (PDFs, documentos), o Agente sabe que um arquivo foi enviado e qual o seu nome, mas não lê o conteúdo. Detalhes em Imagens e arquivos.

Assista ao vídeo

Play

Precisa de ajuda?

Ainda travado? Fale com a gente no Discord ou entre em contato, e ajudaremos você a colocar seu bot no ar.