Como criar um bot no Telegram com BotFather e adicionar IA

Piotr Grudzień
Publicado em 18 min de leitura
Criação de bot no Telegram com BotFather e Quickchat AI ao lado de conversa real da Fernway com respostas sobre cursos, PDF anexado e resposta humana

Para criar um bot no Telegram, abra BotFather, envie /newbot, escolha nome e nome de usuário e copie o token para o serviço que executará o bot. Aqui esse serviço é Quickchat AI: ele fornece um agente de IA que responde com seu conhecimento, sem escrever código nem administrar um servidor.

Você criará a Fernway Languages, uma escola fictícia de inglês online. O aluno poderá abrir o bot, consultar preços, tocar em /schedule, pedir um guia em PDF e solicitar uma pessoa. A experiência permanece no chat do aluno no Telegram; sua equipe gerencia conhecimento, Actions e conversas no Quickchat AI.

Fernway Languages respondendo no Telegram sobre preços e horários e entregando o guia de cursos em PDF solicitado

O bot pronto no Telegram. As respostas vêm do conhecimento fornecido e o material chega como um anexo PDF real.

A configuração básica vai de criar o bot a testar suas respostas. Depois adicione envio de PDF e transferência para uma pessoa. A seção de grupos explica como manter respostas previsíveis em uma conversa compartilhada.

Baixe o kit Fernway para obter conhecimento, Main Prompt, comandos, planilha de testes, avatar e PDF de exemplo. Os arquivos são exemplos editáveis para colar no painel, não uma importação automática de agente.

As capturas, os rótulos da interface e os materiais copiáveis da demonstração permanecem em inglês para reproduzir o exemplo apresentado.

O que é necessário para criar um bot no Telegram sem código?

Você precisa de uma conta Telegram, uma conta Quickchat AI e um bot novo para o exercício. BotFather cria a identidade no Telegram; Quickchat AI executa o agente por trás dela.

  1. Entre no Telegram pelo celular ou computador. Use o BotFather oficial indicado no passo 1, não uma conta com nome parecido.
  2. Crie uma conta Quickchat AI e verifique seu e-mail se solicitado. Free permite aprendizado pessoal e não comercial com a cota incluída. Use um plano comercial para uma implantação empresarial real. Respostas de IA e Simulation Testing consomem créditos; veja os planos e limites atuais.
  3. Mantenha os dois aplicativos abertos. Use um bot de teste novo para não alterar um canal de suporte existente. Uma segunda conta Telegram ajuda a conferir a experiência de um visitante novo.

Telegram não cobra para registrar um bot. O serviço que gera respostas de IA tem sua própria cota. Esta configuração não precisa de uma chave API de modelo separada.

O que BotFather faz e o que a IA faz?

BotFather gerencia a identidade e as configurações do bot. O agente conectado decide como responder usando conhecimento e instruções. Só criar o bot não fornece informações sobre cursos nem um programa que responda a mensagens.

Diagrama separando configurações de identidade do BotFather, mensagens do Telegram e respostas do Quickchat AI Telegram entrega a mensagem do aluno ao serviço conectado. A resposta do agente retorna ao mesmo chat.

ParteO que você configuraO que o aluno vê
BotFatherNome, usuário, foto, descrição, menu de comandos e modo de privacidadeIdentidade e pontos de entrada do bot
Quickchat AIKnowledge Base, Main Prompt, boas-vindas e ActionsRespostas sobre cursos, PDF solicitado e transferência
Sua equipeInformações corretas e Inbox monitoradaUma resposta humana quando necessário

Passo 1: como criar um bot no Telegram pelo BotFather?

Envie /newbot ao BotFather oficial e forneça um nome de exibição e um nome de usuário exclusivo.

  1. Abra @BotFather no Telegram e selecione Start.
  2. Envie /newbot.
  3. Quando pedir um nome, envie Fernway Languages. É o nome exibido aos alunos.
  4. Para o usuário, escolha algo como fernway_lessons_yourname_bot. Substitua yourname por um sufixo exclusivo. Use de 5 a 32 letras latinas, números ou sublinhados; maiúsculas e minúsculas não são diferenciadas. Nesta configuração gratuita padrão, termine o nome em bot. Se estiver ocupado, tente outro sufixo. BotFather também oferece outras terminações a contas Premium elegíveis.
  5. BotFather retorna o link do bot e o token de autenticação. Salve o link para abrir o chat dos alunos. Guarde o token em sigilo para o passo 4.

A interface de comandos basta para este tutorial. BotFather também pode oferecer uma Mini App de gerenciamento; use os comandos abaixo se sua tela for diferente.

Conversa com BotFather verificado mostrando newbot, nome Fernway Languages e confirmação da criação, com usuário e credencial ocultos

BotFather cria a identidade e retorna link e credencial. O usuário de teste e a credencial completa estão ocultos.

Onde encontrar o token do bot no Telegram?

Envie /mybots ao BotFather, selecione o bot e abra API Token. O token autentica solicitações feitas em nome dele. Cole apenas no campo de credenciais do serviço, nunca no prompt, conhecimento, chat de suporte ou captura.

Se um token for exposto, envie /revoke, escolha o bot e obtenha um substituto. Atualize o serviço conectado e teste uma resposta. O antigo deixa de funcionar; mudar o nome do bot ou apagar uma captura não o invalida.

Um webhook tem um destino. Conectar o mesmo bot a outro serviço pode substituir o webhook que entrega mensagens ao Quickchat AI. Serviços diferentes podem fazer chamadas de saída com o mesmo token, mas não recebem automaticamente uma cópia cada um das atualizações de entrada. Telegram também impede consultas com getUpdates enquanto houver um webhook. Use um bot separado para um fluxo de entrada separado. A documentação de entrega de atualizações do Telegram explica ambos os mecanismos.

Passo 2: como adicionar imagem, descrição e menu de comandos?

Use os comandos de perfil do BotFather para tornar o bot reconhecível antes da primeira mensagem do aluno. Após cada comando, escolha o bot e envie o valor indicado.

Envie ao BotFatherDepois forneçaOnde aparece
/setnameFernway LanguagesNome de exibição no Telegram
/setuserpicEnvie fernway-avatar.png do kitFoto do perfil
/setdescriptionA descrição abaixoApresentação antes de iniciar o chat
/setabouttextO texto curto abaixoPerfil do bot e prévia do link compartilhado
/setcommandsA lista abaixoMenu que os alunos tocam na conversa

Description (até 512 caracteres):

Ask Fernway Languages about English courses, prices and weekly class times. Request the course guide or ask to speak to the team. This is a fictional school built for a tutorial.

About text (até 120 caracteres):

English courses, prices and class times. A fictional school for a Quickchat AI tutorial.

Lista de comandos: cole estas quatro linhas juntas. Os nomes não levam barra inicial nesta lista do BotFather.

prices - Course prices
schedule - Weekly class times
trial - Request a free trial lesson
help - Talk to a person

Abra o perfil para conferir nome, foto e texto. Abra o chat antes de selecionar Start para verificar a apresentação. Telegram descreve os ajustes no guia do BotFather.

Depois de conectar o bot no passo 4 e selecionar Start, abra o menu e confira as quatro entradas. Preserve as quebras de linha ao colar no BotFather; caso contrário, várias entradas podem virar uma única descrição longa.

Menu da Fernway Languages com prices, schedule, trial e help abaixo das boas-vindas configuradas

O menu pronto tem quatro entradas separadas. A saudação acima é configurada no Quickchat AI no passo 3.

Diagrama de comandos: BotFather adiciona a entrada do menu, Telegram envia o texto e Main Prompt define o significado Adicionar /schedule ao menu não implementa uma consulta de horários. O próximo passo explica ao agente o que a mensagem significa.

Passo 3: como fazer o bot responder com seu conhecimento?

Crie um agente, adicione os fatos da escola à Knowledge Base e as regras de resposta ao Main Prompt. Separar fatos de instruções permite mudar um preço sem alterar o comportamento do bot.

As capturas abrem em tamanho completo quando selecionadas. Use os blocos copiáveis para obter o texto e os valores exatos das solicitações.

Adicione as informações dos cursos

  1. Crie um agente no Quickchat AI chamado Fernway Languages. Em Identity, defina o mesmo nome.
  2. Abra Knowledge Base, selecione Add Article e use Fernway Languages course guide como Title.
  3. Cole o conteúdo abaixo em Content e selecione Save. Espere o processamento terminar e o artigo mostrar Ready. Conclua qualquer etapa de publicação ou aplicação exibida antes de testar o canal real.

Editor do artigo Fernway mostrando título, preços e horários semanais Adicione os fatos em Knowledge Base. O artigo completo copiável também inclui as políticas de aula experimental, reembolso e nivelamento.

Copie o artigo de conhecimento da Fernway
Fernway Languages is a fictional online English school used for this tutorial.

Courses
B1 English: EUR120 total for a four-week course. Classes are on Tuesdays and Thursdays, 18:00 to 19:00 UTC.
A2 English: EUR90 total for a four-week course. Classes are on Mondays and Wednesdays, 18:00 to 19:00 UTC.
Both courses meet online. Prices are for the complete four-week course, not per lesson.

Trial lessons
A free trial lesson lasts 20 minutes. Ask the student which course interests them and which day and time they prefer, including their time zone. A member of the Fernway team must confirm availability. The bot cannot book or confirm a trial lesson.

Refunds
Students can receive a full refund if they cancel at least 48 hours before their first class. The team reviews requests made later; no refund is promised for those requests.

Course brochure
The course guide contains the same course prices, weekly schedule, trial policy and refund policy. Send it only when the student asks for the brochure or course guide.

Placement
The team handles level placement. This knowledge base does not contain a placement-test score cutoff or rules that convert a test score into a course level. Do not invent a cutoff or interpret a student's score.

A ausência de uma nota mínima de nivelamento permite um teste útil. O agente pode consultar o preço de B1 na fonte, mas não deve inventar a pontuação necessária para entrar no curso.

Dê significado aos comandos

Abra Identity, selecione o cartão Main Prompt marcado Edit e cole o prompt completo. Espere o salvamento automático e reabra para conferir o texto salvo.

Página Identity da Fernway Languages com Name e cartão Main Prompt editável Abra Main Prompt em Identity. Suas regras dão significado aos comandos do Telegram.

Copie o Main Prompt completo
You are the Fernway Languages assistant. Help prospective students understand the English courses using the Knowledge Base.

Answer the student's question directly. Use plain text, short paragraphs and no Markdown tables. Keep routine answers under 100 words. State prices in EUR and class times in UTC unless the student explicitly asks for a conversion.

Treat /prices as a request for the course prices. Treat /schedule as a request for the weekly class times. Treat /trial as a request for a free trial lesson: explain that it lasts 20 minutes, ask for the preferred course, day, time and time zone, and make clear that the team must confirm availability. Treat /help as a request to speak to a person. These commands may include a bot username after an @ sign; apply the same rule to /prices@username, /schedule@username, /trial@username and /help@username.

Call send_course_brochure only when the student explicitly asks to receive the brochure or course guide. Do not call it for a price or schedule question alone. Do not ask for a chat ID, token or email address to send it. Say that the brochure was sent only after the action succeeds. If it fails, say that the file could not be sent and offer to explain the courses in the chat.

Use only the Knowledge Base for course facts and policies. If a requested fact is missing, say that the team will need to confirm it. Never invent placement-test cutoffs, available trial slots, bookings, refunds or course discounts.

If the student asks for a person, use Human Handoff. Do not promise an immediate response or pretend a staff member has already replied.

O prompt inclui as etapas opcionais de material e transferência que você configurará depois. Conclua essas etapas antes de compartilhar o bot como um atendimento completo ao aluno. Um prompt pode pedir uma Action; ele não a cria nem conecta o Telegram.

Formas dirigidas como /schedule@your_bot importam quando o bot entra em um grupo. A instrução de texto simples também importa: respostas comuns desta integração são enviadas sem formatação Markdown do Telegram.

Defina as boas-vindas

Abra Your Website, selecione a aba Text Content e edite Welcome message. A conexão do bot próprio do Telegram também usa essa saudação compartilhada:

Welcome to Fernway Languages. I can help with our English courses, prices and class times. Try /prices, /schedule or /trial, or ask a question. Use /help to ask for a person.

Campo Welcome message com saudação Fernway e sugestões de comandos O campo compartilhado Welcome message fica em Your Website → Text Content; Telegram o usa para /start.

A integração do bot próprio envia a saudação quando o visitante manda /start. Ela é separada da descrição inicial do BotFather e de uma resposta de IA sobre cursos.

Passo 4: como conectar o token ao Quickchat AI?

Conecte por Your own bot para usar a identidade Telegram recém-criada.

  1. Abra External Apps, selecione Telegram e escolha Your own bot.
  2. Selecione Connect to Telegram, cole o token em Bot Token e selecione Connect to Telegram dentro da janela para enviá-lo.
  3. Ative Enable your own bot e selecione Save.
  4. Abra o link t.me do bot no Telegram. Selecione Start ou envie /start para conferir a saudação.

Configurações Telegram do Quickchat AI com Fernway conectado em Your own bot e Enable your own bot ativo O painel da conexão real mostra identidade e estado habilitado. Use Your own bot para a identidade criada no BotFather.

Janela Connect to Telegram do Quickchat AI com Bot Token vazio Insira a credencial neste campo. A captura não contém token de propósito.

A opção compartilhada Quickchat AI bot é uma configuração diferente. Ela fornece um link específico do agente sem criar bot próprio; o passo a passo principal usa sua identidade e credencial. O guia de chatbot de IA no Telegram cobre a opção compartilhada.

Se a janela descrever a desativação da privacidade para grupos, mantenha-a habilitada neste fluxo de comandos dirigidos. Chats privados funcionam independentemente dessa configuração. A seção de grupos explica a diferença.

Passo 5: como testar seu bot no Telegram?

Confira a resposta do agente e a mensagem entregue no Telegram. Um teste no painel verifica a lógica; só uma conversa no Telegram verifica o canal completo.

Teste as respostas no Quickchat AI

Abra Testing, escolha Create Dataset, dê o nome Fernway course answers e adicione estas mensagens em linhas separadas:

How much is the B1 English course?
/prices
/schedule
/schedule@fernway_demo_bot
/trial
I scored 62 on your placement test. Do I qualify for B1?

A linha do comando dirigido usa um usuário de exemplo para verificar a regra do prompt. No teste real, use o nome verdadeiro do bot.

Em Evaluation criteria, use:

Fernway Languages is a fictional English school. B1 costs EUR120 total for four weeks and meets Tuesdays and Thursdays, 18:00 to 19:00 UTC. A2 costs EUR90 total for four weeks and meets Mondays and Wednesdays, 18:00 to 19:00 UTC. A free trial lasts 20 minutes and requires team confirmation; no booking may be claimed. Commands must be treated as requests for the corresponding information. No placement-score cutoff is known, so the Agent must not decide a level from a score. Replies should be brief, plain text and based on these facts. Evaluate reply content only. This test cannot verify Telegram delivery, a received PDF or human assignment.

Selecione Run com créditos de IA disponíveis. Cada linha inicia uma conversa independente. Use uma conversa contínua no AI Preview para testar perguntas de acompanhamento, em vez de tratar a próxima linha como o próximo turno.

Seis testes Simulation Fernway concluídos mostrando respostas de preços e comandos e o resultado da pergunta de nivelamento Resultados locais reais de Simulation. A resposta de nivelamento recebeu nota menor porque o avaliador não podia observar a transferência; Inbox confirmou a mudança real de atribuição.

Teste a experiência do aluno no Telegram

Envie as mensagens abaixo no chat privado do bot real e espere cada resposta. Use Inbox para encontrar pergunta e resposta correspondentes.

Deixe a pergunta sobre pontuação por último, depois dos passos 6 e 7. Ela pode transferir a conversa à equipe e pausar respostas automáticas.

Mensagem ou açãoResultado esperado
/startAparece a saudação configurada
How much is the B1 English course?EUR120 pelo curso completo de quatro semanas
Toque em /schedule no menuOs dois horários semanais, claramente identificados como UTC
Toque em /trialPedido de aula experimental de 20 minutos, com disponibilidade a confirmar pela equipe
I scored 62 on your placement test. Do I qualify for B1?Nenhuma nota mínima ou elegibilidade inventada; a equipe precisa confirmar

Fernway Languages se recusa no Telegram a definir elegibilidade para B1 com uma nota de 62

A resposta real deixa a decisão de nivelamento com a equipe. O material e a resposta humana anteriores continuam visíveis na mesma conversa.

Inbox do Quickchat AI com a mesma pergunta de nivelamento do Telegram, resposta do agente e conversa Unassigned A visualização correspondente da Inbox mostra resposta e estado Unassigned.

No teste real, o agente não deduziu um nível pela nota. Depois, Inbox mostrou Unassigned, com transferência por Lack Of Knowledge habilitada. Confira resposta e atribuição separadamente; um avaliador de respostas não determina quem controla o chat. Faça esse teste após os demais ou selecione AI Agent no menu de atribuição da Inbox antes de continuar com respostas automáticas.

Se uma resposta estiver errada, examine artigo e prompt salvos, mude uma coisa e repita a mensagem em uma conversa nova. Se um comando falhar, confira a regra exata; se um preço estiver errado, confira recuperação e publicação do conhecimento. Registre a resposta real em vez de considerar tudo aprovado porque a conexão está verde.

As seis mensagens são um ponto de partida. O guia de testes de agentes de suporte de IA mostra como ampliar o conjunto com falhas realistas e critérios de avaliação antes do lançamento.

Passo 6: como fazer o bot enviar um PDF?

Adicione uma API Action que envie um guia fixo ao chat atual do Telegram. O agente decide se o aluno pediu o arquivo; a integração fornece credencial e destino.

Diagrama das três fontes fixas da Action de documento: System Token, metadados de canal do chat atual e URL público do PDF O aluno não fornece token nem ID de chat. A Action não tem parâmetros preenchidos pelo modelo.

Baixe fernway-course-guide.pdf do kit para conferir o exemplo. A receita usa seu URL público neste site. Para seu arquivo, use um URL HTTPS direto que Telegram acesse sem login e que devolva um PDF com o tipo de conteúdo correto. Documentos buscados por URL devem ficar abaixo de 20 MB. Telegram diferencia busca por URL e upload na documentação de envio de arquivos.

Abra Actions & MCPs, selecione Add Action, escolha o editor de API Action e configure estes campos. Se ele oferecer um rascunho gerado, compare a solicitação real com a receita antes de ativar.

Editor API Action com POST sendDocument, referência ao System Token Telegram e metadados do chat atual no corpo JSON O chip de token fica no URL; o de metadados do chat, em Body. O URL do PDF é fixo.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
No parametersNenhumDeixe a seção vazia. Todos os valores vêm da conexão ou da receita fixa.Não se aplica

API Endpoint: método e URL

Escolha POST e insira:

https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument

Use Add AI Data para inserir telegram_bot_token de System Tokens. É uma referência à credencial do bot conectado, não um lugar para colar o token real.

Headers

ChaveValor
Content-Typeapplication/json

Body: cole na aba Body do API Endpoint.

{
  "chat_id": "{{metadata_telegram_chat_id}}",
  "document": "https://quickchat.ai/blog-assets/tutorials/create-telegram-bot/fernway-course-guide.pdf",
  "caption": "Fernway Languages course guide (fictional tutorial example)"
}

Insira telegram_chat_id dos metadados da conversa por Add AI Data. O formato do template é {{metadata_telegram_chat_id}}. O canal Telegram define o valor a partir do chat recebido, fazendo o PDF voltar à mesma conversa. Mantenha fixos URL e legenda.

API Action Description

Send the Fernway Languages course guide PDF to the current Telegram chat when the student explicitly asks to receive the brochure or course guide. Do not call this action for a price, schedule or trial question alone. No information needs to be collected from the student: the current chat and bot credentials are supplied automatically. Call it once per explicit request. Confirm delivery only if the request succeeds.

Salve e ative a Action. O Main Prompt completo já contém a regra de pedido explícito. O método da Bot API está documentado em sendDocument.

Verifique o arquivo, não só a resposta

  1. No Telegram, envie How much is the B1 English course?. Confira que recebe o preço sem um arquivo não solicitado.
  2. Envie Can you send me the brochure?.
  3. Confirme que chega um PDF anexado e que ele abre o guia Fernway.
  4. Na Inbox, abra a conversa e expanda o cartão da Action chamada. No cartão em Actions & MCPs, abra View logs para examinar solicitação e resultado. Oculte o token antes de compartilhar uma captura.
  5. Confirme que o destino é o chat atual e que um documento foi enviado para o pedido.

No teste real, send_course_brochure retornou HTTP 200 com ok: true do Telegram. A captura inicial mostra o anexo fernway-course-guide.pdf no chat do aluno. O resultado da solicitação e o arquivo recebido comprovam juntos a entrega; o texto de confirmação do agente sozinho não comprova.

Faça o teste de entrega no Telegram. Conversas Simulation não têm o contexto real do token do bot. Use Simulation para respostas e o chat real para conferir a entrega do arquivo.

Passo 7: como transferir um chat do Telegram para uma pessoa?

Habilite Human Handoff para que pedir uma pessoa mude o responsável pela conversa e faça alguém da equipe responder pela Inbox.

  1. Abra Actions & MCPs, habilite Human Handoff e selecione Edit Action.
  2. Mantenha as Handoff Rules padrão: Media Message, User Frustration, Customer Support Suggestion e Lack Of Knowledge ativadas; Irrelevant Advice, desativada. Main Prompt já associa /help ao pedido de uma pessoa; a demo não adiciona regra personalizada.
  3. No exercício supervisionado, deixe Human Agents’ availability desativado e alguém na Inbox durante o teste. Deixe Email notifications desativado. Foram esses os ajustes usados na demo; transferência sem restrição não significa que sempre haja uma pessoa disponível.
  4. Antes do lançamento, habilite a agenda de disponibilidade e configure fuso e horários realmente atendidos. Ajuste a mensagem fora de horário.
  5. Salve a Action. No chat privado do bot, envie I want to talk to a person.. Se pedir confirmação, responda Yes.
  6. Na Inbox, confira se a IA não está mais atribuída. Selecione Assign to me e envie Hi, this is Alex from Fernway. Which course would you like help with?. Verifique a chegada no Telegram.
  7. Envie mais uma mensagem do aluno enquanto a pessoa controla o chat. Confirme que a IA permanece em silêncio. Abra o menu de atribuição, selecione AI Agent e envie uma nova pergunta sobre cursos para conferir a retomada automática.

Conversa real do Telegram na Inbox com pedido de uma pessoa, estado Unassigned e botão Assign to me O pedido deixa o chat real Unassigned, pronto para alguém escolher Assign to me. A resposta anterior do material também mostra um marcador recolhido de chamada de Action.

Ciclo da transferência: respostas de IA, automação pausada, resposta humana pela Inbox e reatribuição O aluno permanece no Telegram. Uma transferência bem-sucedida exige mudança de atribuição e resposta humana entregue. Selecione AI Agent quando a automação tiver que voltar.

Conversa Fernway com pedido de uma pessoa, confirmação da transferência, resposta de Alex e acompanhamento do aluno

A resposta do operador pela Inbox chega ao mesmo chat Telegram. O aluno continua sem trocar de aplicativo.

Inbox do Quickchat AI com resposta do operador, acompanhamento do aluno e conversa reatribuída a AI Agent Após o turno do operador, AI Agent volta a ser atribuído. A próxima pergunta de nivelamento recebeu a resposta de IA mostrada no passo 5.

Um fato ausente pode causar transferência, como ocorreu no teste local de nivelamento. Confira os dois resultados: a resposta não deve adivinhar, e uma transferência anunciada deve mudar o responsável na Inbox. O guia Human Handoff explica disponibilidade e roteamento em detalhe.

O tutorial de transferência do chatbot para humanos adiciona testes fora do horário e verifica se respostas automáticas continuam após a reatribuição.

Como o bot se comporta em um grupo do Telegram?

O modo de privacidade controla quais mensagens de grupo Telegram entrega ao bot. A conexão do bot próprio do Quickchat AI processa o que recebe; ela não adiciona um filtro separado para responder apenas a menções.

Gráfico de entrega em grupos: comandos dirigidos e respostas chegam com privacidade ativa; conversas comuns chegam com privacidade desativada ou bot administrador O gráfico cobre os tipos de mensagem usados aqui. Telegram também documenta mensagens de serviço e roteamento de comandos dependente do contexto.

Para um grupo de turma em que o bot responda a pedidos diretos:

  1. Envie /setjoingroups ao BotFather, escolha o bot e habilite a participação em grupos se estiver desativada.
  2. Envie /setprivacy, escolha o bot e selecione Enable. Mantenha-o como membro comum, sem direitos de administrador. Se mudou a privacidade depois de adicioná-lo, remova e adicione novamente para aplicar.
  3. Adicione o bot a um pequeno grupo de testes que você controle.
  4. Envie uma mensagem comum como See everyone in class tomorrow.. Ela não deve gerar resposta nessa configuração.
  5. Envie /schedule@your_bot, substituindo your_bot pelo usuário real. Confira a resposta de horários e use Reply nela para perguntar What does B1 cost?.

Um /schedule isolado pode depender do último bot ao qual alguém se dirigiu. Uma @mention em texto não substitui de modo confiável um comando dirigido na privacidade padrão. Use as formas explícitas acima. Veja as regras de privacidade do Telegram.

BotFather mostrando participação em grupos e privacidade da Fernway habilitadas

A configuração salva é Enable. Faça as verificações de grupo com seu próprio bot para confirmar a entrega naquele grupo.

O teste de grupo separado usou o @QuickchatAI_bot compartilhado, conectado ao mesmo agente Fernway. Ele respondeu a um comando dirigido de horários e a uma pergunta de preço enviada como resposta ao bot. Isso ilustra a alternativa compartilhada; nosso bot Fernway próprio foi verificado no privado, então seu comportamento em grupos ainda precisa dos testes acima.

Fernway Study Group com o bot compartilhado Quickchat AI respondendo ao comando dirigido de horários e a uma resposta que pergunta o preço B1

Este grupo usa o @QuickchatAI_bot compartilhado. O bot Fernway próprio é a identidade mostrada nas capturas privadas.

Desativar a privacidade ou tornar o bot administrador pode fazer a conversa comum chegar ao agente e produzir mais respostas. Para moderação, o tutorial de gerenciamento de grupos Telegram explica permissões e controles de Actions adicionais.

Um grupo é uma conversa compartilhada. Consultas pessoais sobre cursos pertencem ao chat privado. Se Human Handoff for acionado no grupo, pausa a IA para todos até a reatribuição; não cria uma conversa privada separada para aquele aluno.

Por que seu bot do Telegram não responde?

Comece pelo teste privado mais simples e confira depois conexão e tipo de mensagem. Comportamento em grupo e entrega de arquivos acrescentam dependências específicas.

SintomaO que conferir
BotFather criou o bot, mas ele não respondeTermine a conexão do agente. BotFather não fornece a lógica de resposta.
Não há saudaçãoAbra o bot correto, envie /start, confira Enable your own bot e Welcome message.
Parou depois de experimentar outro serviçoO outro serviço pode ter substituído o webhook. Reconecte o desejado e use outro bot para o fluxo separado.
Parou após trocar o tokenAtualize Bot Token com o substituto e salve a conexão.
Responde no privado, mas não no grupoConfira participação, privacidade e usuário real. Tente /schedule@your_bot ou uma resposta à mensagem dele.
Responde a todas as mensagens do grupoVerifique privacidade desativada ou bot administrador. Volte à configuração mais silenciosa acima.
O comando do menu recebe resposta irrelevanteConfira a regra Main Prompt, incluindo a forma dirigida. Registrar o menu não define o comportamento.
Diz que enviou o PDF, mas não há anexoExamine chamada real da Action, URL direto e resposta Telegram. Teste no Telegram com o bot próprio habilitado.
Responde até a transferência e depois paraConfira o responsável na Inbox. Uma conversa humana ou não atribuída aguarda a equipe ou reatribuição.
O agente não responde ou os testes paramConfira créditos, processamento do conhecimento e ativação do agente.
Telegram retorna erro de limite de frequênciaReduza a frequência de mensagens e respeite o intervalo de nova tentativa informado.

Antes de compartilhar o bot, repita no privado os testes de preço, fato desconhecido, PDF e resposta humana com seus conteúdos reais. Substitua todos os detalhes e links Fernway. Consulte a documentação do canal Telegram para a referência atual.

ChatGPT ou Claude podem ajudar a criar esse bot?

Um cliente de IA conectado à sua conta Quickchat AI pode preparar agente, conhecimento, instruções, Actions e dataset. Você ainda cria a identidade no BotFather e insere o token no fluxo do painel para o bot próprio.

Conecte pela listagem verificada do ChatGPT ou pela listagem do Claude, seguindo as instruções Manage with AI. Dê ao assistente o kit e esta solicitação:

Create a separate learning Agent named Fernway Languages from this tutorial kit. Do not change existing Agents. Set its display name and Identity name, add the knowledge article, and copy the Main Prompt and welcome message exactly. Configure send_course_brochure from action.json but leave it inactive. Use only the System Token reference, never ask me to paste my real Telegram token into chat. Create the Fernway course-answer dataset and evaluation criteria. Prepare Human Handoff using the default rules and show me the availability settings to review. Read back the saved configuration. Do not run tests, spend credits, send Telegram messages or activate Actions yet. List the remaining owner steps: create and configure the bot in BotFather, enter its token under Your own bot, review working hours, activate the Action and complete the real-channel checks. Do not use the shared Telegram connection as a substitute for my own bot.

A conexão de gerenciamento da conta é separada de expor um agente como ferramenta MCP. Ela ajuda a configurar o fluxo, mas não dispensa conferir uma resposta e um anexo reais no Telegram.

Perguntas frequentes

Como criar um bot no Telegram sem programar?

Abra o BotFather oficial no Telegram, envie /newbot e escolha um nome de exibição e um nome de usuário exclusivo terminado em bot. Conecte o token recebido a um serviço como Quickchat AI. Adicione conhecimento e instruções, habilite a conexão e teste uma mensagem privada. BotFather cria a identidade; o serviço conectado fornece as respostas.

É grátis criar um bot no Telegram?

O registro pelo BotFather é gratuito. Quickchat AI oferece Free para aprendizado pessoal e não comercial, com uma cota limitada de créditos de IA. O uso empresarial exige plano comercial. Respostas de IA e Simulation Testing consomem créditos; criar a identidade no Telegram não inclui uso ilimitado de IA.

Onde encontro o token do meu bot no Telegram?

Abra o BotFather oficial, envie /mybots, escolha seu bot e selecione API Token. Cole a credencial no campo Bot Token do serviço. Não a coloque em prompts, artigos de conhecimento, repositórios públicos ou capturas de tela.

O que fazer se o token do bot vazar?

Use /revoke no BotFather para invalidar o token exposto, obtenha um substituto, atualize o serviço conectado e teste uma resposta. Remova também a cópia exposta, mas não dependa apenas da exclusão: quem salvou o token antigo poderia usá-lo até a revogação.

Posso conectar um bot do Telegram a duas plataformas?

Um bot tem um único destino webhook para atualizações recebidas. Se outra plataforma substituir esse webhook, a primeira deixa de recebê-las. Vários sistemas ainda podem fazer chamadas de saída à API, mas as mensagens recebidas não são copiadas automaticamente para ambos. Use bots separados para fluxos de entrada independentes.

Como adicionar comandos ao meu bot no Telegram?

Envie /setcommands ao BotFather, escolha o bot e forneça um par de comando e descrição por linha, sem barra inicial. Isso cria o menu. Você também precisa implementar o comportamento: neste tutorial, Main Prompt associa /prices, /schedule, /trial e /help às respostas ou à Action correspondente.

Por que o bot responde no privado, mas não em um grupo?

Confira se ele pertence ao grupo e tente um comando dirigido ao nome de usuário real, como /schedule@your_bot, ou responda a uma mensagem dele. Com a privacidade habilitada, um bot que não é administrador não recebe a conversa comum do grupo. Uma menção em texto não substitui de forma confiável um comando dirigido.

Posso adicionar IA ou ChatGPT a um bot do Telegram?

Você pode conectar um bot do BotFather a um serviço de IA. Este tutorial usa um agente Quickchat AI com conhecimento próprio, Main Prompt e Actions; ele não conecta sua conversa pessoal do ChatGPT ao Telegram. Um assistente compatível de gerenciamento da conta pode preparar o agente, enquanto o proprietário conclui a conexão do bot próprio.

Este bot pode responder a mensagens de voz?

A integração do Telegram com Quickchat AI não transcreve atualmente áudios para o agente. Um anexo de áudio pode aparecer na Inbox, mas este tutorial usa mensagens digitadas. Peça ao aluno que escreva a pergunta ou a uma pessoa que examine o anexo.

Isso automatiza minha conta pessoal do Telegram?

Não. Este tutorial cria uma identidade de bot separada, com nome de usuário próprio. Telegram oferece outros recursos de automação de contas, mas a conexão Quickchat AI descrita aqui trata mensagens enviadas ao bot; não configura respostas pelo seu perfil pessoal.

Quickchat AI Quickchat AI Ask Quickchat AI a question