Telegram AI-chattbot: bygg för grupper och privata chattar

Piotr Grudzień
Publicerad Uppdaterad 19 min läsning
Telegram AI-chattbot med separata Agents för gruppfrågor och privata förfrågningar

En Telegram AI-chattbot kan besvara frågor utifrån ditt företags kunskap i en grupp eller en privat konversation. Quickchat AI ansluter en AI Agent till Telegram via en gemensam bot: lägg till den i en grupp, bekräfta anslutningen i din kontrollpanel och låt medlemmarna nämna boten för att ställa frågor. Den här vägen kräver varken kod eller en BotFather-token.

I den här guiden bygger vi Saltmarsh Sailing School, en fiktiv seglarskola med en medlemsgrupp och privata förfrågningar. Två Agents delar samma skolfakta: Saltmarsh Group besvarar offentliga frågor, medan Saltmarsh Sailing School hanterar privata förfrågningar om provlektioner och kopplar in en person vid återbetalningar. En förfrågan är ett ärende för kontoret, inte en bekräftad bokning.

Konceptkarta över Saltmarsh Agent som använder kunskap och instruktioner för att svara i en Telegram-grupp, hantera privata ärenden och nå Inbox Två Agents håller ansvaret åtskilt. Gruppens Agent har ingen Action för överlämning eller insamling av förfrågningar; den privata Agenten hanterar förfrågningar och personalsvar.

Följ vägen nedan. Tillägget med Google Sheets är valfritt; du kan först slutföra svar och överlämning.

ByggdelDin kontrollpunkt
1. Kunskap och instruktionerAgenten känner till kurspriset och hittar inte på fakta som saknas.
2. GruppanslutningEtt omnämnande får svar; vanliga samtal lämnas i fred.
3. Privat chattDin fullständiga länk öppnar en konversation med rätt Agent.
4. Valfria provlektionsförfrågningarObligatoriska uppgifter blir en rad som personalen kan följa upp.
5. Human HandoffEn person ansvarar för konversationen och AI:n pausar.
6. TestningDu kontrollerar svar, vägval och externa effekter var för sig.

Ladda ned Saltmarsh Telegram-paketet med exakt kunskap, Main Prompt, Action-konfiguration, utvärderingskriterier och testmeddelanden. Det är redigerbara filer för stegen nedan, inte en Agent-import med ett klick.

De körbara filerna, exakta testmeddelandena och skärmbilderna är kvar på engelska så att du kan återskapa stegen och resultaten.

Vad behöver du för att skapa en Telegram-chattbot?

Du behöver ett Quickchat AI-konto, två Agents och ett Telegram-konto med rätt att lägga till en bot i en testgrupp. Det valfria steget för att registrera förfrågningar kräver också ett Google-konto som kan godkänna Google Sheets.

  1. Skapa ett Quickchat AI-konto och verifiera e-postadressen om du blir ombedd. Free stöder personligt, icke-kommersiellt lärande. Planerna gäller per Agent, så ett företag som använder båda behöver lämpliga kommersiella planer för båda. Preview och Simulation förbrukar AI-krediter. Se de aktuella planerna.
  2. Skapa en Telegram-grupp som heter Saltmarsh Members. Använd en testgrupp så att du kan kontrollera omnämnanden, tystnad och följdmeddelanden innan du bjuder in kunder.
  3. Använd ditt eget Telegram-konto i genomgången, även för besökarens meddelanden. Du kan också hantera Inbox i Quickchat AI. Be en kollega kontrollera upplevelsen från ett annat konto innan du bjuder in kunder.
  4. Packa upp paketet. Håll skolans exempelfakta samlade; ersätt dem med egna verifierade regler före driftsättning.

Skärmbilderna från Quickchat App visar en lokalt körd app med den fiktiva Saltmarsh-konfigurationen; exempeldata för anslutningar anges i bildtexterna. Skärmbilderna från Telegram och Google Sheets visar den anslutna demonstrationens faktiska svar och sparade förfrågan. Personliga kontouppgifter är bortbeskurna eller uttryckligen dolda. Använd den avslutande checklistan för att upprepa kontrollerna med din egen kunskap och dina anslutna konton.

Steg 1: Hur lär du Telegram-chattboten om ditt företag?

Ge Agenten företagsfakta i Knowledge Base och arbetsinstruktioner i Main Prompt. När rollerna hålls åtskilda blir det lättare att rätta ett svar utan att ändra hur Agenten beter sig.

Diagram som skiljer skolfakta i Knowledge Base från svars- och vägvalsinstruktioner i Main Prompt Priser och regler är källfakta. Kortfattade svar, osäkerhet och vägval är instruktioner.

Skapa Agenten och lägg till kunskap

  1. Välj Set up manually i ett nytt konto. I ett befintligt konto väljer du först Add new AI Agent och sedan den manuella vägen.
  2. På Identity anger du Saltmarsh Group i Name your AI Agent. Klistra in paketets group-main-prompt.txt i Describe what you want your agent to do.
  3. Fortsätt konfigurationen utan att ansluta externa appar ännu. Slutför plansteget och använd Skip for now om du börjar med ett konto för lärande.
  4. Öppna Knowledge Base > Add Article. Ange Courses and trial enquiries i Create custom article, välj Create article, klistra in saltmarsh-courses.txt i Content och välj sedan Save.
  5. Upprepa med Weather, parking and personal enquiries och använd saltmarsh-policies.txt. Vänta tills båda artiklarna visar Ready.
  6. Öppna Actions & MCPs på Saltmarsh Group. Låt Human Handoff vara avstängt och lägg inte till Action för provlektionsförfrågningar.
  7. Välj Add new AI Agent och upprepa den manuella konfigurationen för Saltmarsh Sailing School, med main-prompt.txt och samma två kunskapsfiler. Den andra Agenten ska hantera privata konversationer. Välj rätt Agent i kontoväljaren innan du ändrar inställningar.

Knowledge Base i lokala Quickchat App med de två Saltmarsh-artiklarna Två korta källor gör det tydligt vilka fakta Agenten har. Ready är kontrollpunkten före ett kunskapstest.

KunskapExakta fakta i exemplet
KurserStart Sailing: två dagar, EUR 240. Day Skipper-teori: fem kvällar, EUR 310. Privatlektion: 90 minuter, EUR 95.
DatumSäsong april till oktober; datum publiceras en månad i förväg. Ingen aktuell tillgänglighet eller nästa tidpunkt anges.
UtrustningVattentät jacka, skor med sulor som inte lämnar märken och ombyte. Flytvästar tillhandahålls.
VäderÖver 25 knop eller åska: flytt till nästa tillgängliga datum utan extra kostnad. Instruktören beslutar samma morgon.
ParkeringGratis vid klubbhuset. Grindkoden skickas dagen före; själva koden saknas.
ProvlektionsförfrågningarSamla in namn, önskad veckodag och seglingserfarenhet. Kontoret bekräftar tillgänglighet och pris.

Uthyrning av våtdräkter saknas med avsikt. Det rätta svaret är att Agenten inte kan bekräfta det, i stället för ett påhittat ja eller nej. Väderregeln ger inte heller dagens prognos, och priset för privatlektioner fastställer inte priset för en provlektion.

Ställ in Main Prompt och kontrollera ett svar

  1. Öppna Identity > Main Prompt på varje Agent och kontrollera respektive Saltmarsh-prompt. Grupprompten besvarar allmänna frågor och hänvisar till den privata länken som är fäst i gruppen; den privata prompten samlar in förfrågningar och använder Human Handoff.
  2. Öppna AI Preview och fråga How much is Start Sailing?. Kontrollera att svaret anger två dagar och EUR 240.
  3. Fråga Do you rent wetsuits?. Kontrollera att svaret medger att informationen saknas.

Main Prompt-redigeraren i lokala Quickchat App med Saltmarsh-instruktioner Den privata Agentens prompt definierar insamling och överlämning. Gruppens Agent använder sin egen prompt och har båda Actions avstängda.

Actions-sidan för Saltmarsh Group i lokala Quickchat App med Human Handoff avstängt och inga egna Actions Två utsnitt ur gruppagentens verkliga inställningar. Den kan besvara kunskapsfrågor, men har ingen Action för insamling eller överlämning att köra.

Två Agents gör vägvalet tydligt. Gruppens Agent kan inte utlösa en överlämning av misstag; den privata Agenten kan lämna över en återbetalningsbegäran utan att pausa gruppen. Preview kontrollerar skolfakta, medan nästa steg verifierar varje Telegram-anslutning.

Steg 2: Hur lägger du till AI-chattboten i en Telegram-grupp?

Öppna External Apps > Telegram, lägg till den gemensamma boten i gruppen och återvänd sedan till Quickchat AI för att välja Confirm för gruppen. Agenten förblir tyst i gruppen tills du bekräftar den.

Diagram över att bjuda in boten, bekräfta rätt grupp och svara på omnämnanden eller svar Medlemskap i Telegram och bekräftelse i Quickchat AI är separata steg.

  1. Välj Saltmarsh Group i Agent-väljaren. Öppna External Apps, välj Telegram och hitta Quickchat AI bot.
  2. Välj Add to a Telegram group. Välj Saltmarsh Members i Telegram och godkänn att boten läggs till.
  3. Återvänd till Quickchat AI. Kontrollera gruppnamnet och uppgifterna under Added by i Waiting for your confirmation.
  4. Välj Confirm för rätt grupp. Den ska flyttas till Connected chats, med aktiveringsreglaget på.
  5. Skriv @ i Telegram och välj boten i listan över omnämnanden. Fråga How much is Start Sailing?. Den gemensamma botens användarnamn är normalt @QuickchatAI_bot; använd det faktiska användarnamnet som visas i din grupp.
  6. Svara direkt på svaret med What should I bring?. Skicka sedan ett separat meddelande utan omnämnande: Does anyone know the gate code?. Den gemensamma boten ska besvara svaret och vara tyst på det vanliga meddelandet.

Telegrams Add to Group-väljare med Saltmarsh Members Välj Saltmarsh Members i Telegram och återvänd sedan till Quickchat AI för att bekräfta anslutningen.

Lokala Quickchat App med Saltmarsh Members i väntan på bekräftelse Verkligt lokalt gränssnitt med förberedda grupptestdata som visar var Confirm finns. Det illustrerar kontrollen, men bevisar inte att Telegram har anslutit till en aktiv grupp.

Telegram-gruppmeddelande som nämner boten och frågar om priset på Start Sailing, följt av botens svar med två dagar och EUR 240 Den bekräftade gruppen fick det förväntade kurssvaret. Nämn boten med dess faktiska användarnamn.

Svar på botens Telegram-meddelande med frågan vad man ska ta med, följt av skolans packlista Att svara på botens meddelande fungerar utan att nämna den igen. Svaret listar de tillhandahållna uppgifterna om utrustning.

Bekräftelsen är viktig eftersom inbjudans data syns i gruppen. Quickchat AI kräver ett beslut från kontot innan gruppen behandlas som en destination för Agenten. Bekräfta inte en grupp du inte känner igen. Referensen för Telegram-anslutning beskriver samma gräns.

Slutför bekräftelsen innan du lämnar inställningarna. Om boten lämnar en obekräftad grupp ska du skapa en ny länk via Add to a Telegram group, lägga till den igen och omedelbart bekräfta den väntande gruppen i Quickchat AI. Att lägga till boten via Telegrams medlemssökning ersätter inte detta anslutningsflöde.

Märket Admin visar botens status i Telegram. Det krävs inte för vanliga svar från den gemensamma boten. Att göra den gemensamma boten till administratör ändrar inte heller regeln om omnämnanden eller svar.

Steg 3: Hur aktiverar du privata Telegram-chattar?

Aktivera Direct message link och dela hela den genererade URL:en. Länken väljer din Agent inuti den gemensamma Telegram-boten, så att kunder kan fråga privat utan att lägga till den i en grupp.

Diagram över allmänna gruppfrågor och personliga förfrågningar om provlektioner eller återbetalningar i privat chatt Gruppen är en gemensam konversation. Flytta personuppgifter och överlämningar till personal till privata meddelanden.

  1. Välj Saltmarsh Sailing School, den privata Agenten. Öppna External Apps > Telegram och aktivera Direct message link. Lämna dess gruppanslutningar tomma.
  2. Kopiera den genererade länken. Behåll parametern start=; en vanlig länk till den gemensamma boten identifierar inte din Agent.
  3. Öppna den i Telegram och tryck på Start om du blir ombedd.
  4. Fråga How much is Start Sailing? utan att nämna boten. Verifiera skolans svar och hitta konversationen i Inbox.
  5. Fäst länken i gruppens välkomstmeddelande så att människor hittar den innan de delar personliga uppgifter.

Lokala Quickchat App med reglaget Direct message link Använd länken som genereras för din egen Agent. Den lokala konfigurationen här är inget kvitto på faktisk Telegram-leverans.

Quickchat AI levererar Saltmarsh Sailing Schools välkomstmeddelande i Telegram Telegram levererade Saltmarsh-hälsningen efter Start. Kontrollera sedan ett kunskapssvar; hälsningen ensam testar inte informationshämtningen.

Två Telegram-detaljer visar Saltmarsh Members med ett fäst meddelande och dess inbjudan till privata förfrågningar Två utsnitt från samma Telegram-skärm visar den fästa inbjudan. Demolänkens start-värde är utelämnat; fäst din egen fullständiga genererade länk.

En privat chatt med den gemensamma boten är kopplad till en Agent i taget. Att öppna en annan Agents direktmeddelandelänk kan ändra kopplingen. För en egen Telegram-identitet och en separat bottråd använder du vägen med egen bot.

Att stänga av Direct message link hindrar nya anslutningar via länken. För att stoppa en befintlig ansluten chatt använder du dess aktiveringsreglage eller Disconnect. Behandla länken som en offentlig ingång, inte som en åtkomstbegränsning för konfidentiell kunskap.

Steg 4: Hur sparar du en provlektionsförfrågan i Google Sheets?

Google Sheets-integrationen skapar ett kalkylark och en Action som lägger till rader. Anpassa den Action till tre obligatoriska fält för förfrågan och kontrollera sedan den verkliga raden. Steget är valfritt och fungerar med den gemensamma Telegram-boten.

Diagram över en privat provlektionsförfrågan som samlar tre obligatoriska fält innan en rad läggs till för kontorets uppföljning Resultatet är en förfrågan som en person följer upp. Den reserverar ingen plats och fastställer inget pris för provlektionen.

Anslut Sheets och konfigurera en Action

  1. På Saltmarsh Sailing School öppnar du Actions & MCPs > Add Action > Google Sheets och väljer Connect Google Sheets. Logga in på rätt Google-konto och godkänn den begärda åtkomsten.
  2. Öppna det genererade kalkylarket Quickchat Leads. Behåll fliknamnet Leads, eftersom den genererade Action-URL:en pekar på den fliken.
  3. Ersätt rubrikraden i ordning med Name, Preferred weekday, Sailing experience, Conversation link, Channel.
  4. Öppna Actions & MCPs och redigera den genererade Action log_lead_to_google_sheet. Använd konfigurationen nedan. Ändra parametrar, begärans innehåll och kalkylarkets rubriker tillsammans så att positionerna stämmer.

API Action Name

Record trial-lesson request

What to ask the user first

FormatNameDescriptionRequired
TextnameNamnet personen har angett för denna provlektionsförfrågan. Fråga efter det om det saknas.Ja
Textpreferred_weekdayVeckodagen personen föredrar för en provlektion, till exempel tisdag. Det är ett önskemål, inte ett bekräftat datum.Ja
Textsailing_experiencePersonens egen uppgift om seglingserfarenhet, till exempel nybörjare. Fråga om den saknas; dra inga egna slutsatser.Ja

Ställ alla tre parametrar på No default och ta bort standardparametrarna för e-post och förfrågan. De tre fälten är de enda frågorna i den här konfigurationen. Ett Telegram-användarnamn är valfritt och inget tillförlitligt obligatoriskt kontaktfält; den sparade konversationslänken ger personalen en väg tillbaka till ärendet.

Metod och URL: behåll den genererade POST-URL:en. Den innehåller redan ditt kalkylarks-ID, fliken Leads och valueInputOption=RAW. Det finns inget platshållar-ID för kalkylarket att fylla i.

Headers: behåll integrationens konfiguration.

HTTP-rubrikVärde
AuthorizationBearer {{google_sheets_access_token}}
Content-Typeapplication/json

Använd följande på API Endpoint-fliken Body:

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

Använd Add AI Data för att lägga in chips för parametrar och konversationsvariabler där de behövs. De tre första värdena kommer från konversationen; de två sista tillhandahålls av 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.

Öppna Advanced settings > Run only when och lägg till telegram_chat_type equals private. Använd själva metadatanyckeln, utan metadata_ eller klammerparenteser. Det hindrar HTTP-begäran från att köras för ett gruppmeddelande även om modellen försöker. Referensen för körvillkor förklarar kontrollen.

Ställ Response filter på $.updates.updatedRows så att Action returnerar radantalet i stället för ett onödigt leverantörssvar. Låt Action vara aktiverad.

Körvillkor i lokala Quickchat App som begränsar provlektions-Action till privat Telegram-chatt Nyckeln är telegram_chat_type. Villkoret kontrolleras innan begäran skickas.

Action-redigeraren i lokala Quickchat App med fält för provlektionsförfrågan Lokal konfiguration av förfrågan. Den genererade Sheets-URL:en och OAuth-behörigheten måste komma från din egen Google-anslutning.

Kontrollera raden och sedan den ofullständiga förfrågan

Skicka detta via Agentens privata Telegram-länk:

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

Kontrollera alla tre vyer: svaret beskriver en förfrågan, Action-kortet i Inbox visar de angivna värdena och den verkliga fliken Leads innehåller motsvarande rad. Varken ett lugnande svar eller en hög Simulation-poäng bevisar att Google Sheets har tagit emot en skrivning.

Privat Telegram-förfrågan från Alex Morgan om en provlektion och svaret som bekräftar en förfrågan snarare än en bokning Agenten registrerade det angivna namnet, önskemålet om tisdag och erfarenheten som nybörjare. Kontoret behöver fortfarande bekräfta tillgänglighet och exakt pris.

Två utsnitt av Leads-raden i Google Sheets med Alex Morgan, Tuesday, beginner och telegram, med konversationslänken dold Två detaljer av samma sparade rad gör alla fem kolumner läsbara. Den kontospecifika konversationslänken är dold; de övriga fyra värdena är oförändrade.

Starta ett separat test med I would like a trial lesson. Agenten ska fråga efter de saknade fälten, en fråga i taget, innan Action körs. Prova också How much is Start Sailing?; en vanlig kursfråga får inte skapa en rad. Prompten begär en skrivning per förfrågan, men denna tilläggskonfiguration är inte ett idempotent bokningssystem. Kontrollera dubletter innan du använder den för löpande mottagning av ärenden.

Steg 5: Hur lämnar du över en Telegram-konversation till en person?

Konfigurera Human Handoff och verifiera sedan konversationens tilldelning i Inbox. En prompt som säger att kontoret kommer att svara överför inte i sig ansvaret och pausar inte AI:n.

Konceptdiagram som visar vanliga AI-svar, en överlämning som pausar AI och en medarbetare som avslutar ärendet En ändrad tilldelning är kontrollpunkten. Låt en person avsluta ärendet; verifiera en eventuell återgång till AI separat.

  1. Välj Saltmarsh Sailing School, öppna Actions & MCPs > Human Handoff och aktivera funktionen. Låt denna Action vara avstängd på Saltmarsh Group.
  2. Välj + under Handoff Rules. Ange Private enquiries som Rule Name, klistra in handoff-rule.txt i Description och slå på State. Nya rader är inaktiva från början. Regeln omfattar återbetalningar, klagomål, önskemål om en person och accepterad mänsklig hjälp hos denna privata Agent.
  3. Töm Keywords och stäng av de fördefinierade reglerna för exemplet, så att bara den egna regeln är aktiv. Spara sedan. Gruppen isoleras genom att Human Handoff är avstängt på den separata gruppagenten; den egna regeln beskriver när den privata Agenten ska lämna över.
  4. Sätt Confirmation till I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Konfigurera Human Agents’ availability för de tider teamet faktiskt bemannar och ange ett ärligt meddelande för övriga tider.
  5. Skicka I want a refund for last week. Can I speak to a person? från den privata Telegram-chatten.
  6. Hitta konversationen i Inbox, kontrollera tilldelningen, välj Assign to me och skicka Hi, I’m Alex from the office. I’ll review your request. Kontrollera att meddelandet når Telegram.
  7. Skicka ytterligare ett kundmeddelande medan personen ansvarar för konversationen. AI:n ska vara tyst. Låt operatören avsluta ärendet och markera det som löst i Inbox. Behandla återgång till AI som ett separat test.

Human Handoff-konfiguration i lokala Quickchat App för Saltmarshs privata förfrågningar Den egna regelns State är på. De fördefinierade utlösarna är avstängda, så att en regel återstår att granska.

Privat återbetalningsbegäran i Telegram och botens svar om att en person tar över konversationen Den riktiga Telegram-begäran utlöste Handoff. Inbox-tilldelningen och operatörens utgående svar verifierades separat.

I den verkliga kontrollen flyttades konversationen till Unassigned, redo för en person att ta över. Operatören valde Assign to me, skickade kontorets svar och Telegram accepterade det. Skärmbilden ovan visar överlämningssvaret, inte operatörens senare meddelande. Kontrollera både tilldelning och leverans när du upprepar testet.

Låt ärendet stanna hos operatören tills det är löst. I vårt lokala återbetalningstest tillät återgång till AI Agent ett svar innan Handoff utlöstes igen. Återgång till AI behöver ett eget lyckat uppföljningstest; det ingår inte i kriterierna för att slutföra detta flöde. Guiden för mänsklig överlämning förklarar bemanning och ansvar mer ingående.

Steg 6: Hur testar du hela Telegram-chattboten?

Använd Testing för upprepningsbara svarskontroller och verifiera sedan de faktiska Telegram-vägarna och externa effekterna separat. En modell kan svara rätt samtidigt som gruppanslutningen, kalkylarksskrivningen eller leveransen vid överlämning fortfarande är fel.

Testcykel från exakt meddelande via svarsgranskning till kvitton i Action och Inbox Granska systemet som ansvarar för resultatet: kunskap för fakta, Action-loggar för begäranden, Sheets för rader och Telegram för leverans.

Kör en upprepningsbar uppsättning svarstester

  1. Öppna Testing, skapa en datamängd med namnet Saltmarsh: knowledge checks och välj Paste messages.
  2. Klistra in simulation-messages.txt. Behåll de fristående avgränsarna --- mellan fallen.
  3. Öppna Evaluation criteria, klistra in paketets evaluation-criteria.txt och spara.
  4. Välj Run > Start Run och granska både de enskilda svaren och poängen.

Testing-datamängd i lokala Quickchat App med Saltmarsh-testmeddelanden Behåll samma frågor när du ändrar en instruktion, så att jämförelsen fortsätter att vara användbar.

Slutförda Saltmarsh-kunskapstester i lokala Quickchat App med individuella poäng Läs svaren tillsammans med poängen. Detta är lokala kunskapstester, inte Telegram-leveranstester.

Utvärderaren behöver skolans fakta för att bedöma riktigheten. Den måste också veta att transkriptet inte kan bevisa en kalkylarksrad, Telegram-leverans eller ändrad tilldelning. Vanlig textbaserad Simulation tillhandahåller inte Telegram-chattmetadata, så Action-villkoret för enbart privata chattar ska inte betraktas som trasigt när den metadatan saknas. Kör kanalberoende kontroller i den faktiska privata chatten.

Vad ändrade de lokala testerna?

Den första utformningen använde en Agent för båda ingångarna. Ett lokalt test visade att en återbetalningsbegäran i gruppen överförde den gemensamma konversationen till Human Handoff. Vi separerade agenterna och stängde av både Handoff och Actions för att registrera förfrågningar på gruppens Agent. När vi upprepade gruppkontrollerna för återbetalningar och provlektioner hänvisade svaren till den fästa privata länken, samtidigt som konversationen förblev tilldelad AI. Därför använder steg 1 både konfiguration och instruktioner för att skilja de två konversationerna åt.

De tio slutliga lokala kunskapskontrollerna fick 5/5 vardera, och båda hostade agenterna klarade samma tio fall. Dessa små körningar uppskattar inte noggrannheten i produktion. Den riktiga gruppen svarade också på frågorna om kurspris och packning och avstod sedan från att bekräfta uthyrning av våtdräkter. Behåll dessa fall med saknade fakta när du anpassar paketet; korrekta prissvar räcker inte för att testa Agentens återhållsamhet.

Telegram-svar som inte bekräftar uthyrning av våtdräkter, följt av ett meddelande om grindkoden utan omnämnande och utan synligt botsvar Saknad kunskap ger svaret ”kan inte bekräfta”. Det separata meddelandet om grindkoden riktar sig inte till boten, och inget svar på det syns i denna skärmbild.

Den riktiga privata förfrågan om en provlektion gav ett lyckat anrop till Sheets-Action med Alex Morgan, Tuesday och beginner. Google returnerade HTTP 200 och en uppdaterad rad; den sparade raden innehöll också konversationslänken och kanalen telegram. Ett separat Action-test med gruppchattmetadata skickade ingen HTTP-begäran. Kontrollera både den godkända privata förfrågan och den nekade gruppkontexten när du anpassar villkoret.

Kontrollera kanalen och dess sidoeffekter

Använd paketets tomma test-matrix.csv för att registrera dina egna observationer. Skärmbilderna ovan visar de demonstrerade resultaten; tabellen innehåller också kontroller att köra med din egen konfiguration. Anteckna den förflutna tiden när du testar tystnad och håll mänskligt övertagande skilt från en eventuell senare återgång till AI.

KontrollSkicka eller görFörväntat resultat
Omnämnande i grupp@QuickchatAI_bot How much is Start Sailing?Ett kort svar med EUR 240; motsvarande meddelanden i Inbox.
Svar till botenWhat should I bring?Packlistan, utan ett nytt omnämnande.
Vanligt samtalDoes anyone know the gate code? utan omnämnandeInget svar från den gemensamma boten.
KunskapsluckaNämn boten och fråga Do you rent wetsuits?Kan inte bekräfta; inget påhittat ja eller nej.
Personlig begäran i gruppNämn boten och be om återbetalningHänvisning till privat chatt; gruppen förblir tilldelad AI.
Privat svarÖppna hela DM-länken och fråga om prisetRätt Agent svarar utan omnämnande.
Fullständig provlektionsförfråganSkicka Alex Morgan-meddelandet från steg 4Action-parametrar och verklig Sheets-rad stämmer överens; inget bokningspåstående.
Privat överlämningBe om återbetalning och svara efter övertagandetMänsklig tilldelning, operatörens meddelande levereras, inget extra AI-svar.
VäderreglerWhat happens if the forecast says 30 knots?Kostnadsfri ombokning och instruktörens beslut; inget påstående om aktuell prognos.

När en kontroll misslyckas ändrar du en relevant inställning och kör samma meddelande igen. Rätta saknade källfakta i Knowledge Base; rätta ett för tidigt Action-anrop i beskrivningen eller de obligatoriska parametrarna; kontrollera bekräftelse och adressering först om en grupp är tyst. Spara det misslyckade resultatet så att förbättringen syns.

När bör du skapa en egen bot med BotFather?

Skapa en egen Telegram-bot när du behöver eget botnamn och egen bild, Telegram Bot API Actions eller en grupp som tar emot vanliga meddelanden. Den gemensamma boten räcker för gruppsvaren och de privata svaren ovan.

Jämförelse mellan gemensam bot och egen BotFather-bot Välj den identitet och det meddelandebeteende du behöver innan du lägger till en andra bot.

BehovGemensam Quickchat AI-botDin egen bot
Skapa en BotFather-tokenKrävs inteKrävs
Eget Telegram-namn och egen bildGemensam identitetDin bots identitet
Besvara omnämnanden och svar i gruppJaJa, när Telegram levererar dem
Besvara vanliga gruppmeddelandenGemensam bot är tystKonfigurera Telegram-sekretess eller administratörsstatus
Privata konversationerAgent-specifik startlänk i den gemensamma botenDin bots egen privata tråd
Google Sheets ActionStödsStöds
Telegram-modererings-ActionsGemensam token exponeras inteEgen token tillgänglig som System Token
  1. Öppna det verifierade BotFather-kontot i Telegram och skicka /newbot.
  2. Välj ett visningsnamn och sedan ett tillgängligt användarnamn som slutar på bot. BotFather returnerar en token. Håll den privat.
  3. Välj Saltmarsh Group om den här boten ska läggas till i en grupp. Använd Saltmarsh Sailing School endast för privata chattar. Öppna Your own bot under External Apps > Telegram och välj Connect to Telegram.
  4. Klistra in token i Bot Token och slutför anslutningen. Kontrollera att Enable your own bot är på.
  5. Öppna botens Telegram-länk och skicka /start, följt av samma fråga om kurspriset.
  6. Om du vill ta emot vanliga gruppmeddelanden använder du /setprivacy i BotFather, väljer boten och Disable, tar sedan bort den från testgruppen och lägger till den igen. En administratörsbot tar också emot vanliga meddelanden. Telegrams dokumentation om sekretessläge förklarar leveransreglerna.

Anslutningsformulär för egen bot i lokala Quickchat App med tomt Bot Token-fält Klistra bara in token i Bot Token. Fältet visas tomt så att inga inloggningsuppgifter publiceras.

Håll den gemensamma boten och din egen bot i separata grupper. Båda i samma grupp kan ge dubbla svar. Om nästa uppgift är att fästa meddelanden eller moderera medlemmar följer du den separata guiden till Telegram-grupphantering, inklusive Action-villkoren som begränsar körningen till administratörer.

Kan ChatGPT eller Claude hjälpa till att konfigurera Telegram-chattboten?

En ansluten app för Quickchat AI-kontohantering kan hjälpa till att skapa en Agent, lägga till kunskap, konfigurera inställningar som stöds och köra tester. När klienten erbjuder Telegram-konfiguration kan den aktivera den gemensamma botens Direct message link. Gruppval och bekräftelse i kontrollpanelen är fortfarande ägarens uppgifter. Vissa klienter kräver också kontrollpanelen för att aktivera direktlänken och ställa in Human Handoff, så låt assistenten granska sina tillgängliga verktyg först.

Anslut Quickchat AI-pluginen för ChatGPT eller Claude-anslutningen och bifoga paketfilerna med denna 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.

Tillgängliga verktyg varierar med klient och kontobehörigheter. Följ referensen för kontohantering för inloggning. Detta ansluter en assistent till ditt Quickchat AI-konto; det gör inte en personlig ChatGPT- eller Claude-konversation till Telegram-botens driftade backend.

Varför svarar inte Telegram-chattboten?

Kontrollera anslutningen och meddelandets väg innan du skriver om prompten. De här symptomen har olika orsaker.

FelsymtomKontrollera
Gruppen finns i listan men är tystBekräfta rätt grupp, aktivera den under Connected chats och nämn botens verkliga användarnamn eller svara på dess meddelande.
Boten lämnade före sitt första svarSkapa en ny länk via Add to a Telegram group, lägg till den igen och välj omedelbart Confirm för den väntande gruppen i Quickchat AI.
En vanlig botlänk öppnar fel AgentAnvänd hela direktmeddelandelänken, inklusive start=. Kontrollera om en annan Agents länk ändrade den gemensamma privata chatten.
AI:n stannade efter en återbetalningsbegäranGranska tilldelningen i Inbox. En överlämnad konversation är pausad tills den medvetet tilldelas på nytt.
Ingen rad i SheetsKontrollera att Action är på, alla obligatoriska fält är angivna, chatten är privat och den genererade URL:en fortfarande pekar på Leads. Granska Action-anropet och Google-anslutningen.
Egen bot missar vanliga meddelandenKontrollera sekretessläge och gruppbehörigheter; ta bort och lägg till boten igen efter ändrad sekretess.
Svaret hävdar ett datum eller en tjänst du aldrig angettGranska den sparade kunskapen med status Ready och instruktionen om osäkerhet. Kör exakt samma misslyckade fråga igen.
Tester slutade svaraKontrollera tillgängliga AI-krediter och den misslyckade begäran; tolka inte slut på krediter som ett resultat om promptens kvalitet.

Innan du bjuder in kunder ska du ersätta fiktiva fakta, granska uppdelningen mellan grupp och privat samt bemanna överlämningskön. Be en kollega kontrollera de offentliga ingångarna från ett annat konto som en sista kontroll inför lanseringen. För en annan gemenskapskanal följer Discord-chattbotguiden en liknande bygg- och testväg. För karaktärssamtal använder du Telegram-rollspelsguiden.

Valfria konfigurationskontroller: Jämför driftsättningsmetoder utifrån dina angivna krav eller jämför svar per kreditbudget utifrån en angiven budget. Kalkylatorerna granskar inte ditt konto, din webbplats eller ditt saldo.

Saltmarsh-konfiguration att kopiera

Det här är alla källfakta och instruktioner som används i guiden. Nedladdningen innehåller även Action-konfigurationen, utvärderingskriterierna och testerna.

Gruppens Agent: Main Prompt

Klistra in detta i Identity > Main Prompt på Saltmarsh Group. Låt Human Handoff och egna Actions vara avstängda på den här Agenten.

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.

Privat Agent: Main Prompt

Klistra in detta i Identity > Main Prompt på Saltmarsh Sailing School. Håll det angivna Action-namnet konsekvent med konfigurationen.

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.

Kunskap: kurser och provlektionsförfrågningar

Klistra in detta i fältet Content i den första kunskapsartikeln.

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.

Kunskap: regler och medlemsinformation

Klistra in detta i fältet Content i den andra artikeln.

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.

Human Handoff-regel

Klistra in detta under Human Handoff > Handoff Rules och konfigurera den faktiska tillgängligheten.

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.

Vanliga frågor

Hur lägger jag till en AI-chattbot i en Telegram-grupp?

Öppna External Apps i Quickchat AI, välj Telegram och Add to a Telegram group. Välj gruppen i Telegram, återvänd till Quickchat AI och välj Confirm. Medlemmar kan ställa frågor genom att nämna den gemensamma boten eller svara på något av dess meddelanden.

Svarar en Telegram AI-chattbot på varje meddelande?

Den gemensamma Quickchat AI-boten svarar på gruppmeddelanden som nämner den eller svarar på den. Vanliga gruppsamtal utlöser inget svar. Din egen bot kan ta emot vanliga gruppmeddelanden när Telegrams sekretessläge är avstängt eller boten är administratör. Testa den konfigurationen i en separat grupp.

Behöver jag BotFather eller en Telegram-bottoken?

Du behöver varken BotFather eller en token för den gemensamma boten och dess direktmeddelandelänk. Skapa en egen bot med BotFather när du behöver eget Telegram-namn och egen bild eller Actions som anropar Telegram Bot API. Vanliga Google Sheets Actions kan fungera med den gemensamma boten.

Kan kunder skriva privat till Telegram-chattboten?

Ja. Aktivera Direct message link i Quickchat AI och dela hela den genererade länken. Kunden öppnar den och trycker på Start vid behov. Länken väljer din Agent i den gemensamma boten. Att stänga av länken hindrar nya anslutningar; befintliga privata chattar har separata kontroller för aktivering och frånkoppling.

Är en Telegram AI-chattbot gratis?

Att skapa en bot med BotFather lägger inte i sig till någon AI-tjänst. Quickchat AI erbjuder planen Free för personligt, icke-kommersiellt lärande med ett begränsat antal AI-krediter. Kommersiell användning kräver en betald plan. Svar, Preview och Simulation använder AI-krediter, och externa tjänster kan ha egna kostnader.

Har Telegram AI-chattbotar?

Telegram stöder AI-botar och AI-integrationer från tredje part. Den här guiden ansluter en Quickchat AI Agent som svarar utifrån ditt företags egen kunskap. BotFather skapar botens identitet; det tillhandahåller inte kunskapen och konfigurerar inte ditt kundsupportflöde.

Kan chattboten förstå foton och filer?

Telegram-integrationen kan ta emot foton och analysera deras visuella innehåll. Andra filer kan nå konversationen som bilagor, men innehållet läses inte automatiskt. Testa de filtyper dina kunder faktiskt använder och granska både Telegram och Inbox.

Kan jag skapa en Telegram-bot för rollspel eller karaktärer?

Ja. Samma Telegram-anslutning kan användas av en Agent med en karaktärsidentitet och lämpliga instruktioner. Den här guiden använder ett företagssupportexempel; en rollspels-Agent behöver en egen prompt och egna tester.

Quickchat AI Quickchat AI Ask Quickchat AI a question