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.
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.
- Entre no Telegram pelo celular ou computador. Use o BotFather oficial indicado no passo 1, não uma conta com nome parecido.
- 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.
- 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.
Telegram entrega a mensagem do aluno ao serviço conectado. A resposta do agente retorna ao mesmo chat.
| Parte | O que você configura | O que o aluno vê |
|---|---|---|
| BotFather | Nome, usuário, foto, descrição, menu de comandos e modo de privacidade | Identidade e pontos de entrada do bot |
| Quickchat AI | Knowledge Base, Main Prompt, boas-vindas e Actions | Respostas sobre cursos, PDF solicitado e transferência |
| Sua equipe | Informações corretas e Inbox monitorada | Uma 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.
- Abra @BotFather no Telegram e selecione Start.
- Envie
/newbot. - Quando pedir um nome, envie
Fernway Languages. É o nome exibido aos alunos. - Para o usuário, escolha algo como
fernway_lessons_yourname_bot. Substituayournamepor 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 embot. Se estiver ocupado, tente outro sufixo. BotFather também oferece outras terminações a contas Premium elegíveis. - 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.
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 BotFather | Depois forneça | Onde aparece |
|---|---|---|
/setname | Fernway Languages | Nome de exibição no Telegram |
/setuserpic | Envie fernway-avatar.png do kit | Foto do perfil |
/setdescription | A descrição abaixo | Apresentação antes de iniciar o chat |
/setabouttext | O texto curto abaixo | Perfil do bot e prévia do link compartilhado |
/setcommands | A lista abaixo | Menu 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.
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
- Crie um agente no Quickchat AI chamado
Fernway Languages. Em Identity, defina o mesmo nome. - Abra Knowledge Base, selecione Add Article e use
Fernway Languages course guidecomo Title. - 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.
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.
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.
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.
- Abra External Apps, selecione Telegram e escolha Your own bot.
- Selecione Connect to Telegram, cole o token em Bot Token e selecione Connect to Telegram dentro da janela para enviá-lo.
- Ative Enable your own bot e selecione Save.
- Abra o link
t.medo bot no Telegram. Selecione Start ou envie/startpara conferir a saudação.
O painel da conexão real mostra identidade e estado habilitado. Use Your own bot para a identidade criada no BotFather.
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.
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ção | Resultado esperado |
|---|---|
/start | Aparece a saudação configurada |
How much is the B1 English course? | EUR120 pelo curso completo de quatro semanas |
Toque em /schedule no menu | Os dois horários semanais, claramente identificados como UTC |
Toque em /trial | Pedido 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 |
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.
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.
API Action Name
send_course_brochure
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| No parameters | Nenhum | Deixe 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
| Chave | Valor |
|---|---|
Content-Type | application/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
- No Telegram, envie
How much is the B1 English course?. Confira que recebe o preço sem um arquivo não solicitado. - Envie
Can you send me the brochure?. - Confirme que chega um PDF anexado e que ele abre o guia Fernway.
- 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.
- 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.
- Abra Actions & MCPs, habilite Human Handoff e selecione Edit Action.
- 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
/helpao pedido de uma pessoa; a demo não adiciona regra personalizada. - 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.
- Antes do lançamento, habilite a agenda de disponibilidade e configure fuso e horários realmente atendidos. Ajuste a mensagem fora de horário.
- Salve a Action. No chat privado do bot, envie
I want to talk to a person.. Se pedir confirmação, respondaYes. - 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. - 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.
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.
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.
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.
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:
- Envie
/setjoingroupsao BotFather, escolha o bot e habilite a participação em grupos se estiver desativada. - 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. - Adicione o bot a um pequeno grupo de testes que você controle.
- Envie uma mensagem comum como
See everyone in class tomorrow.. Ela não deve gerar resposta nessa configuração. - Envie
/schedule@your_bot, substituindoyour_botpelo usuário real. Confira a resposta de horários e use Reply nela para perguntarWhat 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.
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.
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.
| Sintoma | O que conferir |
|---|---|
| BotFather criou o bot, mas ele não responde | Termine a conexão do agente. BotFather não fornece a lógica de resposta. |
| Não há saudação | Abra o bot correto, envie /start, confira Enable your own bot e Welcome message. |
| Parou depois de experimentar outro serviço | O 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 token | Atualize Bot Token com o substituto e salve a conexão. |
| Responde no privado, mas não no grupo | Confira participação, privacidade e usuário real. Tente /schedule@your_bot ou uma resposta à mensagem dele. |
| Responde a todas as mensagens do grupo | Verifique privacidade desativada ou bot administrador. Volte à configuração mais silenciosa acima. |
| O comando do menu recebe resposta irrelevante | Confira 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á anexo | Examine 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 para | Confira 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 param | Confira créditos, processamento do conhecimento e ativação do agente. |
| Telegram retorna erro de limite de frequência | Reduza 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.












