Chatbot de IA no Telegram: grupos e mensagens privadas sem código

Um chatbot de IA no Telegram pode responder a perguntas com base no conhecimento da sua empresa, em grupos ou conversas privadas. O Quickchat AI conecta um AI Agent ao Telegram por meio de um bot compartilhado: adicione-o a um grupo, confirme a conexão no painel e os membros poderão mencioná-lo para fazer perguntas. Esse caminho dispensa código e token do BotFather.

Neste tutorial, montamos a Saltmarsh Sailing School, uma escola fictícia com um grupo de membros e atendimento privado. Dois Agents compartilham as mesmas informações: Saltmarsh Group responde a perguntas públicas, enquanto Saltmarsh Sailing School recebe pedidos privados de aulas experimentais e chama uma pessoa para tratar de reembolsos. O pedido é uma solicitação à secretaria, não uma reserva confirmada.

Dois Agents mantêm a responsabilidade separada. O Agent do grupo não tem Action de transferência ou registro; o privado atende solicitações e respostas da equipe.

Siga o percurso abaixo. A extensão com Google Sheets é opcional; você pode concluir primeiro as respostas e a transferência para pessoas.

Baixe o kit Saltmarsh para Telegram com o conhecimento, Main Prompt, receita de Action, critérios de avaliação e mensagens de teste exatos. São arquivos editáveis para as etapas abaixo, não uma importação de Agent em um clique. Os materiais copiáveis da demonstração e as capturas de tela permanecem em inglês.

O que você precisa para criar um chatbot no Telegram?

Você precisa de uma conta no Quickchat AI, dois Agents e uma conta no Telegram com permissão para adicionar um bot a um grupo de teste. O registro opcional de solicitações também exige uma conta Google que possa autorizar o Google Sheets.

1. Crie uma conta no Quickchat AI e verifique o e-mail se solicitado. Free permite aprendizado pessoal, não comercial. Os planos se aplicam por Agent; uma empresa que usa ambos precisa de cobertura comercial adequada para os dois. Preview e Simulation consomem créditos de IA. Consulte os planos atuais.
2. Crie um grupo no Telegram chamado Saltmarsh Members. Use um grupo de teste para verificar menções, silêncio e mensagens de acompanhamento antes de convidar clientes.
3. Use sua própria conta do Telegram para seguir o tutorial, inclusive para enviar as mensagens do visitante. Você também pode operar o Inbox do Quickchat AI. Antes de convidar clientes, peça a um colega que verifique a experiência com outra conta.
4. Descompacte o kit. Mantenha as informações de exemplo da escola juntas e substitua-as por suas políticas verificadas antes da implantação.

As capturas do Quickchat App mostram um aplicativo executado localmente com a configuração fictícia Saltmarsh; os dados de teste de conexão estão identificados nas legendas. As capturas do Telegram e do Google Sheets mostram as respostas reais e a solicitação salva da demonstração conectada. Os dados pessoais da conta foram cortados ou ocultados de forma explícita. Use a lista final para repetir as verificações com seu próprio conhecimento e suas contas conectadas.

Etapa 1: como ensinar seu negócio ao chatbot do Telegram?

Coloque os fatos da empresa na Knowledge Base e as instruções de funcionamento no Main Prompt. Separar essas funções facilita corrigir uma resposta sem mudar o comportamento do Agent.

Preços e políticas são fatos das fontes. Brevidade, incerteza e encaminhamento são instruções.

Crie o Agent e adicione seu conhecimento

1. Em uma conta nova, escolha Set up manually. Em uma conta existente, selecione primeiro Add new AI Agent e depois o caminho manual.
2. Em Identity, digite Saltmarsh Group em Name your AI Agent. Cole group-main-prompt.txt do kit em Describe what you want your agent to do.
3. Continue a configuração sem conectar aplicativos externos ainda. Conclua a etapa do plano, usando Skip for now se estiver começando com a conta de aprendizado.
4. Abra Knowledge Base > Add Article. Digite Courses and trial enquiries em Create custom article, selecione Create article, cole saltmarsh-courses.txt em Content e clique em Save.
5. Repita com Weather, parking and personal enquiries, usando saltmarsh-policies.txt. Aguarde os dois artigos exibirem Ready.
6. Abra Actions & MCPs em Saltmarsh Group. Mantenha Human Handoff desativado e não adicione a Action de pedidos experimentais.
7. Selecione Add new AI Agent e repita a configuração manual para Saltmarsh Sailing School, com main-prompt.txt e os mesmos dois arquivos de conhecimento. Esse segundo Agent atenderá conversas privadas. Selecione o Agent desejado no seletor da conta antes de alterar suas configurações.

Duas fontes curtas deixam claro quais fatos o Agent possui. Ready é o ponto de verificação antes de testar o conhecimento.

O aluguel de roupas de neoprene foi omitido intencionalmente. A resposta correta é que o Agent não pode confirmar, sem inventar um sim ou não. Da mesma forma, a regra climática não informa a previsão de hoje, e o preço da aula particular não determina o preço da aula experimental.

Defina o Main Prompt e confira uma resposta

1. Abra Identity > Main Prompt em cada Agent e confira seu prompt Saltmarsh. O prompt do grupo responde a perguntas gerais e indica o link privado fixado no grupo; o privado coleta solicitações e usa Human Handoff.
2. Abra AI Preview e pergunte How much is Start Sailing?. Confira se a resposta informa dois dias e EUR 240.
3. Pergunte Do you rent wetsuits?. Confira se a resposta reconhece a informação ausente.

O prompt do Agent privado define coleta e transferência. O Agent do grupo usa um prompt separado e mantém as duas Actions desativadas.

Dois recortes das configurações reais do Agent do grupo. Ele responde a perguntas de conhecimento, mas não tem Action de coleta ou transferência para executar.

Dois Agents tornam o encaminhamento explícito. O Agent do grupo não tem uma transferência que possa acionar por engano; o privado pode transferir um pedido de reembolso sem pausar o grupo. Preview verifica os fatos da escola; as próximas etapas verificam cada conexão do Telegram.

Etapa 2: como adicionar o chatbot de IA a um grupo do Telegram?

Abra External Apps > Telegram, adicione o bot compartilhado ao grupo e volte ao Quickchat AI para selecionar Confirm. O Agent permanece em silêncio naquele grupo até sua confirmação.

Entrar no grupo do Telegram e confirmar no Quickchat AI são etapas separadas.

1. Selecione Saltmarsh Group no seletor de Agents. Abra External Apps, selecione Telegram e encontre Quickchat AI bot.
2. Selecione Add to a Telegram group. No Telegram, escolha Saltmarsh Members e aprove a inclusão do bot.
3. Volte ao Quickchat AI. Em Waiting for your confirmation, confira o nome do grupo e as informações de Added by.
4. Selecione Confirm no grupo esperado. Ele deve passar para Connected chats, com a chave de ativação ligada.
5. No Telegram, digite @ e escolha o bot no seletor de menções. Pergunte How much is Start Sailing?. O nome de usuário do bot compartilhado normalmente é @QuickchatAI_bot; use o nome realmente exibido no seu grupo.
6. Responda diretamente à resposta com What should I bring?. Depois envie uma mensagem separada, sem menção: Does anyone know the gate code?. O bot compartilhado deve responder à resposta direta e permanecer em silêncio na mensagem comum.

Escolha Saltmarsh Members no Telegram e volte ao Quickchat AI para confirmar a conexão.

Interface local real com um grupo de teste inserido, mostrando onde Confirm aparece. A imagem ilustra o controle; não comprova entrada em um grupo real do Telegram.

O grupo confirmado recebeu a resposta esperada sobre o curso. Mencione o bot pelo nome de usuário real dele.

Responder à mensagem do bot funciona sem uma nova menção. A resposta lista os fatos sobre equipamentos fornecidos nas fontes.

A confirmação importa porque os dados do convite aparecem no grupo. O Quickchat AI exige uma decisão na conta antes de tratar o grupo como destino do Agent. Não confirme um grupo que não reconhece. A referência de conexão do Telegram explica esse limite.

Conclua a confirmação antes de sair da configuração. Se o bot sair de um grupo não confirmado, gere um novo link Add to a Telegram group, adicione-o novamente e confirme imediatamente o grupo pendente no Quickchat AI. Adicionar o bot pela busca de membros do Telegram não substitui esse fluxo de conexão.

O selo Admin informa o status do bot no Telegram. Ele não é obrigatório para respostas normais do bot compartilhado. Torná-lo administrador também não muda sua regra de responder somente a menções ou respostas diretas.

Etapa 3: como habilitar conversas privadas no Telegram?

Ative Direct message link e compartilhe a URL gerada completa. O link seleciona seu Agent dentro do bot compartilhado, permitindo perguntas privadas sem adicioná-lo a um grupo.

O grupo é uma conversa compartilhada. Leve dados pessoais e transferências para a equipe às mensagens privadas.

1. Selecione Saltmarsh Sailing School, o Agent privado. Abra External Apps > Telegram e ative Direct message link. Deixe suas conexões de grupo vazias.
2. Copie o link gerado. Preserve o parâmetro start=; um link simples para o bot compartilhado não identifica seu Agent.
3. Abra o link no Telegram e pressione Start se solicitado.
4. Pergunte How much is Start Sailing? sem mencionar o bot. Verifique a resposta da escola e encontre a conversa em Inbox.
5. Fixe o link na mensagem de boas-vindas do grupo para que as pessoas o encontrem antes de compartilhar informações pessoais.

Use o link gerado para seu próprio Agent. A configuração local mostrada não é um comprovante de entrega real no Telegram.

O Telegram entregou as boas-vindas da Saltmarsh após Start. Confira uma resposta baseada no conhecimento em seguida; a saudação sozinha não testa a recuperação de informações.

Dois recortes da mesma tela do Telegram mostram o convite fixado. O valor start do link de demonstração foi omitido; fixe seu próprio link gerado completo.

Uma conversa privada com o bot compartilhado fica vinculada a um Agent por vez. Abrir o link de outro Agent pode trocar esse vínculo. Para ter uma identidade própria no Telegram e uma conversa exclusiva com seu bot, siga o caminho do bot próprio.

Desativar Direct message link impede novas conexões por ele. Para interromper uma conversa já conectada, use a chave de ativação daquela conversa ou Disconnect. Trate o link como entrada pública, não como restrição de acesso a conhecimento confidencial.

Etapa 4: como salvar uma solicitação de aula experimental no Google Sheets?

A integração com Google Sheets cria uma planilha e uma Action de acréscimo de linhas. Adapte-a para registrar três campos obrigatórios do pedido e verifique a linha real. Essa etapa é opcional e funciona com o bot compartilhado do Telegram.

O resultado é uma solicitação para uma pessoa acompanhar. Não reserva uma vaga nem define o preço da aula experimental.

Conecte o Sheets e configure uma Action

1. Em Saltmarsh Sailing School, abra Actions & MCPs > Add Action > Google Sheets e selecione Connect Google Sheets. Entre na conta Google desejada e aprove o acesso solicitado.
2. Abra a planilha Quickchat Leads gerada. Mantenha a aba chamada Leads, pois a URL gerada para a Action aponta para ela.
3. Substitua o cabeçalho, nesta ordem, por Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. Abra Actions & MCPs e edite a Action gerada log_lead_to_google_sheet. Use a receita abaixo. Altere parâmetros, corpo da requisição e cabeçalhos da planilha juntos para manter as posições correspondentes.

API Action Name

Record trial-lesson request

What to ask the user first

Defina os três parâmetros como No default e remova os parâmetros padrão de e-mail e solicitação. Esses três campos são as únicas perguntas desta receita. O nome de usuário no Telegram é opcional e não é confiável como contato obrigatório; o link da conversa registrado permite à equipe voltar à solicitação.

Método e URL: mantenha a URL POST gerada. Ela já contém o ID da sua planilha, a aba Leads e valueInputOption=RAW. Não há um ID de exemplo para substituir.

Cabeçalhos: mantenha a configuração da integração.

Na aba Body de API Endpoint, use:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

Use Add AI Data para inserir os blocos de parâmetros e variáveis da conversa onde necessário. Os três primeiros valores vêm da conversa; os dois últimos são fornecidos pelo Quickchat AI.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

Abra Advanced settings > Run only when e adicione telegram_chat_type equals private. Use a chave de metadados simples, sem metadata_ nem chaves. Isso impede a requisição HTTP para mensagens de grupo, mesmo que o modelo tente executá-la. A referência de condições de execução explica a verificação.

Defina Response filter como $.updates.updatedRows para retornar a quantidade de linhas em vez de uma resposta desnecessária do provedor. Mantenha a Action ativada.

A chave simples é telegram_chat_type. A condição é verificada antes de enviar a requisição.

Configuração local da receita. A URL do Sheets gerada e a autorização OAuth devem vir da sua própria conexão Google.

Confira a linha e depois o pedido incompleto

Envie esta mensagem pelo link privado do Agent no Telegram:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

Confira as três superfícies: a resposta descreve uma solicitação, o cartão da Action no Inbox mostra os valores fornecidos e a aba Leads real contém a linha correspondente. Nem uma resposta tranquilizadora nem uma nota alta na Simulation comprovam uma gravação no Google Sheets.

O Agent registrou o nome fornecido, a preferência por terça-feira e o nível iniciante. A disponibilidade e o preço exato ainda precisam da confirmação da secretaria.

Dois detalhes da mesma linha salva mantêm as cinco colunas legíveis. O link da conversa específico da conta está oculto; os outros quatro valores não foram alterados.

Inicie um teste separado com I would like a trial lesson. O Agent deve perguntar pelos campos ausentes, um por vez, antes de executar a Action. Teste também How much is Start Sailing?; uma pergunta comum sobre o curso não deve criar uma linha. O prompt pede uma gravação por solicitação, mas esta receita de acréscimo não é um sistema de reservas idempotente. Inspecione duplicatas antes de usá-la na operação.

Etapa 5: como transferir uma conversa do Telegram para uma pessoa?

Configure Human Handoff e verifique a atribuição da conversa em Inbox. Um prompt que diz que a secretaria responderá não transfere a responsabilidade nem pausa a IA sozinho.

A mudança de atribuição é o ponto de verificação. Conclua o caso com uma pessoa; verifique separadamente qualquer retorno à IA.

1. Selecione Saltmarsh Sailing School, abra Actions & MCPs > Human Handoff e ative-o. Mantenha essa Action desativada em Saltmarsh Group.
2. Em Handoff Rules, selecione +. Digite Private enquiries em Rule Name, cole handoff-rule.txt em Description e ative State. Novas linhas começam inativas. A regra cobre reembolsos, reclamações, pedidos para falar com uma pessoa e aceitação de ajuda humana neste Agent privado.
3. Limpe Keywords e desative as regras predefinidas deste exemplo, deixando apenas a regra personalizada ativa, depois salve. O isolamento do grupo resulta de manter Human Handoff desativado no Agent separado do grupo; a regra personalizada descreve quando o Agent privado deve transferir.
4. Defina Confirmation como I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Configure Human Agents’ availability para os horários realmente cobertos pela equipe e uma mensagem honesta fora do expediente.
5. Na conversa privada do Telegram, envie I want a refund for last week. Can I speak to a person?.
6. Em Inbox, encontre a conversa, confira a atribuição, selecione Assign to me e envie Hi, I’m Alex from the office. I’ll review your request. Confira se a mensagem chega ao Telegram.
7. Envie outra mensagem como cliente enquanto a pessoa controla a conversa. A IA deve permanecer em silêncio. Deixe o operador concluir e resolver o caso no Inbox. Trate o retorno à IA como um teste separado.

O State da regra personalizada está ligado. Os gatilhos predefinidos estão desligados, restando uma regra para revisar.

O pedido real no Telegram acionou Handoff. A atribuição no Inbox e a resposta enviada pelo operador foram verificadas separadamente.

Na verificação real, a conversa passou para Unassigned, pronta para uma pessoa assumir. O operador selecionou Assign to me, enviou a resposta da secretaria, e o Telegram a aceitou. A captura acima mostra a resposta de transferência; ela não mostra a mensagem posterior do operador. Confira a atribuição e a entrega ao repetir o teste.

Mantenha este caso com o operador até a resolução. No teste local de reembolso, devolver a conversa ao AI Agent permitiu uma resposta antes de Handoff ser acionado novamente. O retorno à IA exige um teste de acompanhamento bem-sucedido próprio; ele não faz parte dos critérios de conclusão deste fluxo. O guia de transferência para pessoas detalha a equipe e a responsabilidade pelo atendimento.

Etapa 6: como testar o chatbot completo do Telegram?

Use Testing para verificações repetíveis das respostas e depois confira separadamente os caminhos reais do Telegram e os efeitos externos. Um modelo pode responder corretamente enquanto a conexão do grupo, a gravação na planilha ou a entrega após transferência ainda falha.

Inspecione o sistema responsável pelo resultado: conhecimento para fatos, registros da Action para requisições, Sheets para linhas e Telegram para entrega.

Execute um conjunto repetível de testes de resposta

1. Abra Testing, crie um conjunto chamado Saltmarsh: knowledge checks e escolha Paste messages.
2. Cole simulation-messages.txt. Mantenha os separadores --- isolados entre os casos.
3. Abra Evaluation criteria, cole evaluation-criteria.txt do kit e salve.
4. Selecione Run > Start Run e inspecione as respostas individuais e as notas.

Mantenha as mesmas perguntas ao mudar uma instrução para que a comparação continue útil.

Leia as respostas além da nota. São testes locais de conhecimento, não testes de entrega no Telegram.

O avaliador precisa dos fatos da escola para julgar a precisão. Também precisa saber que a transcrição não comprova uma linha na planilha, entrega no Telegram ou mudança de atribuição. A Simulation de texto padrão não fornece metadados da conversa do Telegram; a ausência desses metadados não significa que a condição de Action privada está quebrada. Execute verificações dependentes do canal na conversa privada real.

O que os testes locais mudaram?

O desenho inicial usava um Agent para as duas entradas. Um teste local mostrou que um pedido de reembolso no grupo transferia a conversa compartilhada para Human Handoff. Separamos os Agents e desativamos Handoff e Actions de registro no Agent do grupo. Ao repetir as verificações de reembolso e aula experimental no grupo, as respostas apontaram para o link privado fixado e mantiveram a IA responsável. Por isso a Etapa 1 usa a configuração, além das instruções, para separar as duas conversas.

As dez verificações locais finais de conhecimento receberam 5/5 cada, e ambos os Agents hospedados passaram pelos mesmos dez casos. Essas pequenas execuções não estimam a precisão em produção. O grupo real também respondeu às perguntas de preço do curso e itens para levar, depois se recusou a confirmar o aluguel de neoprene. Mantenha os casos com informações ausentes ao adaptar o kit; preços corretos, sozinhos, não testam a cautela do Agent.

A falta de conhecimento produz “não posso confirmar”. A mensagem separada sobre o código do portão não se dirige ao bot, e nenhuma resposta a ela aparece nesta captura.

O pedido privado real de aula experimental produziu uma chamada bem-sucedida da Sheets Action com Alex Morgan, Tuesday e beginner. O Google retornou HTTP 200 e uma linha atualizada; a linha salva também continha o link da conversa e o canal telegram. Um teste separado da Action com metadados de grupo não enviou requisição HTTP. Confira o pedido privado aceito e o contexto de grupo recusado ao adaptar essa condição de execução.

Confira o canal e seus efeitos

Use o test-matrix.csv vazio do kit para registrar suas observações. As capturas acima mostram os resultados demonstrados; a tabela também inclui verificações para executar com sua própria configuração. Registre o tempo decorrido ao testar o silêncio e mantenha a tomada de controle por uma pessoa separada de qualquer retorno posterior à IA.

Quando um teste falhar, altere uma configuração relevante e repita a mesma mensagem. Corrija fatos ausentes na Knowledge Base; chamadas prematuras da Action em sua descrição ou parâmetros obrigatórios; grupos silenciosos conferindo primeiro confirmação e endereçamento. Preserve o resultado com falha para tornar a melhoria visível.

Quando criar seu próprio bot com o BotFather?

Crie um bot próprio quando precisar de nome e imagem próprios, Actions da Telegram Bot API ou um grupo que receba mensagens comuns. O bot compartilhado basta para os fluxos de grupo e respostas privadas acima.

Escolha a identidade e o comportamento das mensagens antes de adicionar um segundo bot.

1. Abra a conta verificada do BotFather no Telegram e envie /newbot.
2. Escolha um nome de exibição e um nome de usuário disponível terminado em bot. O BotFather retorna um token. Mantenha-o privado.
3. Selecione Saltmarsh Group se este bot for adicionado a um grupo. Use Saltmarsh Sailing School apenas para conversas privadas. Em External Apps > Telegram, abra Your own bot e selecione Connect to Telegram.
4. Cole o token em Bot Token e conclua a conexão. Confirme que Enable your own bot está ativado.
5. Abra o link do bot no Telegram, envie /start e a mesma pergunta sobre o preço do curso.
6. Para receber mensagens comuns do grupo, use /setprivacy no BotFather, selecione seu bot, escolha Disable e depois remova e adicione o bot novamente ao grupo de teste. Um bot administrador também recebe mensagens comuns. A documentação de privacidade do Telegram explica as regras de entrega.

Cole o token apenas em Bot Token. O campo aparece vazio para não publicar credenciais.

Mantenha o bot compartilhado e seu bot em grupos separados. Ambos no mesmo grupo podem produzir respostas duplicadas. Para fixar anúncios ou moderar membros, siga o tutorial de gerenciamento de grupos do Telegram, incluindo suas condições de Actions restritas a administradores.

ChatGPT ou Claude podem ajudar a configurar o chatbot do Telegram?

Um aplicativo conectado de gerenciamento de conta do Quickchat AI pode criar Agents, adicionar conhecimento, configurar opções compatíveis e executar testes. Quando o cliente disponibiliza a configuração do Telegram, ele pode ativar o link de mensagem direta do bot compartilhado. A seleção do grupo e a confirmação no painel continuam sendo etapas do proprietário. Alguns clientes também exigem o painel para ativar o link privado e configurar Human Handoff; por isso, peça ao assistente que verifique primeiro as ferramentas disponíveis.

Conecte o plugin Quickchat AI para ChatGPT ou o conector Claude e forneça os arquivos do kit com este prompt:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

A disponibilidade das ferramentas varia conforme o cliente e as permissões da conta. Siga a referência de configuração de gerenciamento de conta para entrar. Isso conecta um assistente à sua conta Quickchat AI; não transforma uma conversa pessoal no ChatGPT ou Claude no backend hospedado do bot do Telegram.

Por que o chatbot do Telegram não responde?

Confira a conexão e o caminho da mensagem antes de reescrever o prompt. Estes sintomas têm causas diferentes.

Antes de convidar clientes, substitua os fatos fictícios, revise a separação entre grupo e privado e tenha equipe para a fila de transferências. Peça a um colega que verifique os pontos de entrada públicos com outra conta como última checagem antes do lançamento. Para outro canal de comunidade, o tutorial de chatbot do Discord segue um caminho semelhante de criação e teste. Para conversas com personagens, use o guia de roleplay no Telegram.

Verificações opcionais: compare métodos de implantação com seus requisitos declarados ou compare respostas por orçamento de créditos com um orçamento informado. Essas calculadoras não inspecionam sua conta, site ou saldo.

Configuração Saltmarsh para copiar

Estas são as fontes e instruções completas usadas neste tutorial. O download também inclui a receita de Action, critérios de avaliação e testes.

Agent do grupo: Main Prompt

Cole em Identity > Main Prompt de Saltmarsh Group. Mantenha Human Handoff e Actions personalizadas desativados nesse Agent.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

Agent privado: Main Prompt

Cole em Identity > Main Prompt de Saltmarsh Sailing School. Mantenha o nome da Action consistente com a receita.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

Conhecimento: cursos e pedidos experimentais

Cole no campo Content do primeiro artigo de conhecimento.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

Conhecimento: políticas e informações para membros

Cole no campo Content do segundo artigo.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

Regra de Human Handoff

Cole em Human Handoff > Handoff Rules e configure a disponibilidade real.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

Perguntas frequentes

Como adicionar um chatbot de IA a um grupo do Telegram?

No Quickchat AI, abra External Apps, selecione Telegram e escolha Add to a Telegram group. Selecione seu grupo no Telegram, volte ao Quickchat AI e use Confirm. Os membros podem perguntar mencionando o bot compartilhado ou respondendo a uma mensagem dele.

Um chatbot de IA no Telegram responde a todas as mensagens?

O bot compartilhado do Quickchat AI responde às mensagens de grupo que o mencionam ou respondem a ele. Conversas comuns não acionam respostas. Seu próprio bot pode receber mensagens comuns quando o modo de privacidade do Telegram está desativado ou quando é administrador. Teste essa configuração em um grupo separado.

Preciso do BotFather ou de um token de bot do Telegram?

Você não precisa do BotFather nem de token para o bot compartilhado e seu link privado. Crie um bot próprio com o BotFather quando precisar de nome e imagem personalizados no Telegram ou de Actions que chamem a Telegram Bot API. Actions comuns do Google Sheets funcionam com o bot compartilhado.

Os clientes podem enviar mensagens privadas ao chatbot do Telegram?

Sim. Ative Direct message link no Quickchat AI e compartilhe o link gerado completo. O cliente abre o link e pressiona Start se solicitado. O link seleciona seu Agent dentro do bot compartilhado. Desativá-lo impede novas conexões; conversas privadas existentes têm controles separados de ativação e desconexão.

Um chatbot de IA no Telegram é gratuito?

Criar um bot no BotFather não adiciona um serviço de IA por si só. O Quickchat AI oferece um plano Free para aprendizado pessoal, não comercial, com créditos de IA limitados. Uma implantação comercial exige plano pago. Respostas, Preview e Simulation usam créditos de IA, e serviços externos podem ter custos próprios.

O Telegram tem chatbots de IA?

O Telegram aceita bots de IA e integrações de terceiros. Este tutorial conecta um Agent do Quickchat AI que responde com o conhecimento da sua empresa. O BotFather cria a identidade do bot; não fornece esse conhecimento nem configura seu fluxo de atendimento.

O chatbot entende fotos e arquivos?

A integração do Telegram pode receber fotos e analisar seu conteúdo visual. Outros arquivos podem chegar à conversa como anexos, mas seu conteúdo não é lido automaticamente. Teste os tipos de arquivo que seus clientes usam e inspecione o Telegram e o Inbox.

Posso criar um bot de roleplay ou personagem no Telegram?

Sim. A mesma conexão do Telegram pode atender um Agent com identidade de personagem e instruções adequadas. Este tutorial usa um exemplo de atendimento empresarial; um Agent de roleplay precisa de seu próprio prompt e testes.