En Telegram AI-chatbot kan besvare spørgsmål ud fra din virksomheds viden i en gruppe eller en privat samtale. Quickchat AI forbinder en AI Agent med Telegram via en fælles bot: tilføj den til en gruppe, bekræft forbindelsen i dit kontrolpanel, og medlemmerne kan nævne botten for at stille spørgsmål. Denne fremgangsmåde kræver hverken kode eller et BotFather-token.
I denne vejledning bygger vi Saltmarsh Sailing School, en fiktiv sejlerskole med en medlemsgruppe og private henvendelser. To Agents deler de samme oplysninger om skolen: Saltmarsh Group besvarer offentlige spørgsmål, mens Saltmarsh Sailing School håndterer private forespørgsler om prøvetimer og inddrager en person ved tilbagebetalinger. En forespørgsel er en henvendelse til kontoret, ikke en bekræftet booking.
To Agents holder ansvaret adskilt. Gruppeagenten har ingen Action til overdragelse eller registrering af forespørgsler; den private Agent håndterer henvendelser og svar fra medarbejdere.
Følg forløbet nedenfor. Udvidelsen med Google Sheets er valgfri; du kan først færdiggøre svar og overdragelse.
| Byggetrin | Dit kontrolpunkt |
|---|---|
| 1. Viden og instruktioner | Agenten kender kursusprisen og opfinder ikke manglende fakta. |
| 2. Gruppeforbindelse | En omtale får svar; almindelig samtale får lov at fortsætte uforstyrret. |
| 3. Privat samtale | Dit fulde link åbner en samtale med den rette Agent. |
| 4. Valgfrie forespørgsler om prøvetimer | Påkrævede oplysninger bliver til en række, som medarbejdere kan følge op på. |
| 5. Human Handoff | En person har ansvaret for samtalen, og AI sættes på pause. |
| 6. Test | Du kontrollerer svar, viderestyring og eksterne virkninger hver for sig. |
Download Saltmarsh Telegram-pakken med den præcise viden, Main Prompt, Action-opskrift, evalueringskriterier og testbeskeder. Det er redigerbare filer til trinene nedenfor, ikke en Agent-import med ét klik.
De kørbare filer, præcise testbeskeder og skærmbilleder forbliver på engelsk, så du kan genskabe trinene og resultaterne.
Hvad skal du bruge for at oprette en Telegram-chatbot?
Du skal bruge en Quickchat AI-konto, to Agents og en Telegram-konto med tilladelse til at tilføje en bot til en testgruppe. Det valgfrie trin til registrering af forespørgsler kræver også en Google-konto, som kan godkende Google Sheets.
- Opret en Quickchat AI-konto, og bekræft din e-mailadresse, hvis du bliver bedt om det. Free understøtter personlig, ikke-kommerciel læring. Planer gælder pr. Agent, så en virksomhed, der bruger begge, skal have passende kommerciel dækning for begge. Preview og Simulation bruger AI-kreditter. Se de aktuelle planer.
- Opret en Telegram-gruppe med navnet
Saltmarsh Members. Brug en testgruppe, så du kan kontrollere omtaler, tavshed og opfølgende beskeder, før du inviterer kunder. - Brug din egen Telegram-konto i gennemgangen, også til den besøgendes beskeder. Du kan også betjene Inbox i Quickchat AI. Bed en kollega kontrollere oplevelsen fra en anden konto, før du inviterer kunder.
- Pak filerne ud. Hold skolens eksempelfakta samlet; erstat dem med dine egne bekræftede regler før lancering.
Skærmbillederne fra Quickchat App viser en app, der kører lokalt, med den fiktive Saltmarsh-konfiguration; eksempeldata for forbindelser er angivet i billedteksterne. Skærmbillederne fra Telegram og Google Sheets viser den tilsluttede demonstrations faktiske svar og gemte forespørgsel. Personlige kontooplysninger er beskåret væk eller tydeligt skjult. Brug den afsluttende tjekliste til at gentage kontrollerne med din egen viden og dine tilsluttede konti.
Trin 1: Hvordan lærer du Telegram-chatbotten om din virksomhed?
Giv Agenten virksomhedsoplysninger i Knowledge Base og driftsinstruktioner i Main Prompt. Når de to opgaver holdes adskilt, er det lettere at rette et svar uden at ændre Agentens adfærd.
Priser og regler er kildefakta. Korte svar, usikkerhed og viderestyring er instruktioner.
Opret Agenten, og tilføj dens viden
- Vælg Set up manually på en ny konto. På en eksisterende konto vælger du først Add new AI Agent og derefter den manuelle vej.
- På Identity angiver du
Saltmarsh Groupi Name your AI Agent. Indsæt pakkensgroup-main-prompt.txti Describe what you want your agent to do. - Fortsæt opsætningen uden at forbinde eksterne apps endnu. Afslut plantrinet, og brug Skip for now, hvis du begynder med en læringskonto.
- Åbn Knowledge Base > Add Article. Angiv
Courses and trial enquiriesi Create custom article, vælg Create article, indsætsaltmarsh-courses.txti Content, og vælg Save. - Gentag med
Weather, parking and personal enquiries, og brugsaltmarsh-policies.txt. Vent, indtil begge artikler viser Ready. - Åbn Actions & MCPs på Saltmarsh Group. Lad Human Handoff være deaktiveret, og tilføj ikke Action til prøvetimeforespørgsler.
- Vælg Add new AI Agent, og gentag den manuelle opsætning for
Saltmarsh Sailing Schoolmedmain-prompt.txtog de samme to vidensfiler. Denne anden Agent skal håndtere private samtaler. Vælg den rette Agent i kontovælgeren, før du ændrer indstillinger.
To korte kilder gør det tydeligt, hvilke fakta Agenten har. Ready er kontrolpunktet før en videnstest.
| Viden | Præcise fakta brugt i eksemplet |
|---|---|
| Kurser | Start Sailing: to dage, EUR 240. Day Skipper-teori: fem aftener, EUR 310. Privatlektion: 90 minutter, EUR 95. |
| Datoer | Sæson fra april til oktober; datoer offentliggøres en måned i forvejen. Ingen aktuel tilgængelighed eller næste dato er oplyst. |
| Udstyr | Vandtæt jakke, sko med såler, der ikke sætter mærker, og skiftetøj. Svømmeveste stilles til rådighed. |
| Vejr | Over 25 knob eller tordenvejr: flytning til næste ledige dato uden ekstra betaling. Instruktøren beslutter det samme morgen. |
| Parkering | Gratis ved klubhuset. Portkoden sendes dagen før; selve koden mangler. |
| Prøvetimeforespørgsler | Indsaml navn, foretrukken ugedag og sejlererfaring. Kontoret bekræfter tilgængelighed og pris. |
Udlejning af våddragter er bevidst udeladt. Det korrekte svar er, at Agenten ikke kan bekræfte det, frem for et opdigtet ja eller nej. Vejrreglen giver heller ikke dagens vejrudsigt, og prisen for privatlektioner fastsætter ikke en pris for en prøvetime.
Indstil Main Prompt, og kontroller et svar
- Åbn Identity > Main Prompt på hver Agent, og kontroller den tilhørende Saltmarsh-prompt. Gruppeprompten besvarer generelle spørgsmål og henviser til det fastgjorte private link i gruppen; den private prompt indsamler forespørgsler og bruger Human Handoff.
- Åbn AI Preview, og spørg
How much is Start Sailing?. Kontroller, at svaret angiver to dage og EUR 240. - Spørg
Do you rent wetsuits?. Kontroller, at svaret anerkender den manglende information.
Den private Agents prompt definerer registrering og overdragelse. Gruppeagenten bruger sin egen prompt og har begge Actions deaktiveret.
To udsnit fra gruppeagentens faktiske indstillinger. Den kan besvare vidensspørgsmål, men har ingen Action til registrering eller overdragelse at køre.
To Agents gør viderestyringen tydelig. Gruppeagenten kan ikke udløse en overdragelse ved en fejl; den private Agent kan overdrage en tilbagebetalingsanmodning uden at sætte gruppen på pause. Preview kontrollerer skolens fakta, mens de næste trin verificerer hver Telegram-forbindelse.
Trin 2: Hvordan føjer du AI-chatbotten til en Telegram-gruppe?
Åbn External Apps > Telegram, føj den fælles bot til gruppen, og vend tilbage til Quickchat AI for at vælge Confirm for gruppen. Agenten er tavs i gruppen, indtil du bekræfter den.
Medlemskab af Telegram-gruppen og bekræftelse i Quickchat AI er separate trin.
- Vælg Saltmarsh Group i Agent-vælgeren. Åbn External Apps, vælg Telegram, og find Quickchat AI bot.
- Vælg Add to a Telegram group. Vælg
Saltmarsh Membersi Telegram, og godkend tilføjelsen af botten. - Vend tilbage til Quickchat AI. Under Waiting for your confirmation kontrollerer du gruppenavnet og oplysningerne i Added by.
- Vælg Confirm for den forventede gruppe. Den bør flytte til Connected chats med aktiveringskontakten slået til.
- Skriv
@i Telegram, og vælg botten på listen over omtaler. SpørgHow much is Start Sailing?. Den fælles bots brugernavn er normalt@QuickchatAI_bot; brug det faktiske brugernavn, som vises i din gruppe. - Svar direkte på svaret med
What should I bring?. Send derefter en separat besked uden omtale:Does anyone know the gate code?. Den fælles bot bør besvare svaret og være tavs ved den almindelige besked.
Vælg Saltmarsh Members i Telegram, og vend tilbage til Quickchat AI for at bekræfte forbindelsen.
Faktisk lokal brugerflade med forberedte gruppetestdata, der viser, hvor Confirm findes. Det illustrerer kontrollen, men er ikke bevis for, at Telegram er tilsluttet en aktiv gruppe.
Den bekræftede gruppe fik det forventede kursussvar. Omtal botten med dens faktiske brugernavn.
Et svar på bottens besked fungerer uden at omtale den igen. Svaret viser de angivne oplysninger om udstyr.
Bekræftelse er vigtig, fordi invitationsdataene vises i gruppen. Quickchat AI kræver en beslutning fra kontoen, før gruppen behandles som en destination for din Agent. Bekræft ikke en gruppe, du ikke genkender. Referencen for Telegram-forbindelsen forklarer samme grænse.
Afslut bekræftelsen, før du forlader opsætningen. Hvis botten forlader en ubekræftet gruppe, skal du oprette et nyt link via Add to a Telegram group, tilføje den igen og straks bekræfte den ventende gruppe i Quickchat AI. At tilføje botten via Telegrams medlemssøgning erstatter ikke dette forbindelsesforløb.
Mærket Admin viser bottens status i Telegram. Det kræves ikke til almindelige svar fra den fælles bot. At gøre den fælles bot til administrator ændrer heller ikke reglen om omtaler eller svar.
Trin 3: Hvordan aktiverer du private Telegram-samtaler?
Aktiver Direct message link, og del hele den genererede URL. Linket vælger din Agent inde i den fælles Telegram-bot, så kunder kan spørge privat uden at føje den til en gruppe.
Gruppen er en fælles samtale. Flyt personoplysninger og overdragelser til medarbejdere til private beskeder.
- Vælg Saltmarsh Sailing School, den private Agent. Åbn External Apps > Telegram, og slå Direct message link til. Lad dens gruppeforbindelser være tomme.
- Kopier det genererede link. Behold parameteren
start=; et simpelt link til den fælles bot identificerer ikke din Agent. - Åbn det i Telegram, og tryk på Start, hvis du bliver bedt om det.
- Spørg
How much is Start Sailing?uden at nævne botten. Verificer skolens svar, og find samtalen i Inbox. - Fastgør linket i gruppens velkomstbesked, så folk finder det, før de deler personlige oplysninger.
Brug det link, der er genereret til din egen Agent. Den lokale konfiguration her er ikke en kvittering for faktisk levering i Telegram.
Telegram leverede Saltmarsh-velkomsten efter Start. Kontroller derefter et vidensbaseret svar; velkomsten alene tester ikke informationssøgningen.
To udsnit fra samme Telegram-skærm viser den fastgjorte invitation. Demolinkets start-værdi er udeladt; fastgør dit eget fulde genererede link.
En privat samtale med den fælles bot er knyttet til én Agent ad gangen. Hvis du åbner en anden Agents direkte beskedlink, kan tilknytningen ændres. Ønsker du din egen Telegram-identitet og en særskilt bottråd, skal du bruge vejen med egen bot.
Hvis du slår Direct message link fra, forhindrer du nye forbindelser via linket. Brug samtalens aktiveringskontakt eller Disconnect for at stoppe en eksisterende forbindelse. Behandl linket som en offentlig indgang, ikke som en adgangsbegrænsning for fortrolig viden.
Trin 4: Hvordan gemmer du en prøvetimeforespørgsel i Google Sheets?
Google Sheets-integrationen opretter et regneark og en Action, der tilføjer rækker. Tilpas denne Action til at registrere tre påkrævede felter for forespørgslen, og kontroller derefter den faktiske række. Trinnet er valgfrit og virker med den fælles Telegram-bot.
Resultatet er en forespørgsel, som en person følger op på. Det reserverer ikke en plads og fastsætter ikke en pris for prøvetimen.
Forbind Sheets, og konfigurer én Action
- På Saltmarsh Sailing School åbner du Actions & MCPs > Add Action > Google Sheets og vælger Connect Google Sheets. Log ind på den rette Google-konto, og godkend den ønskede adgang.
- Åbn det genererede regneark Quickchat Leads. Behold fanenavnet Leads, fordi den genererede Action-URL peger på denne fane.
- Erstat overskriftsrækken i rækkefølge med
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - Åbn Actions & MCPs, og rediger den genererede Action
log_lead_to_google_sheet. Brug opskriften nedenfor. Ret parametrene, forespørgslens indhold og regnearkets overskrifter sammen, så deres placeringer passer.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Det navn, personen opgav til denne prøvetimeforespørgsel. Spørg efter det, hvis det mangler. | Ja |
| Text | preferred_weekday | Den ugedag, personen foretrækker til en prøvetime, for eksempel tirsdag. Det er et ønske, ikke en bekræftet dato. | Ja |
| Text | sailing_experience | Den sejlererfaring, personen selv opgiver, for eksempel begynder. Spørg, hvis den mangler; udled den ikke selv. | Ja |
Sæt alle tre parametre til No default, og fjern standardparametrene for e-mail og henvendelse. Disse tre felter er de eneste spørgsmål i opskriften. Et Telegram-brugernavn er valgfrit og ikke et pålideligt obligatorisk kontaktfelt; det registrerede samtalelink giver medarbejderne en vej tilbage til henvendelsen.
Metode og URL: behold den genererede POST-URL. Den indeholder allerede dit regnearks-ID, fanen Leads og valueInputOption=RAW. Der er ingen pladsholder for regnearks-ID, du skal udfylde.
Headers: behold integrationens konfiguration.
| HTTP-header | Værdi |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
På API Endpoint-fanen Body bruger du:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Brug Add AI Data til at indsætte elementer for parametre og samtalevariabler, hvor det er nødvendigt. De første tre værdier kommer fra samtalen; de sidste to leveres af 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.
Åbn Advanced settings > Run only when, og tilføj telegram_chat_type equals private. Brug selve metadatanøglen uden metadata_ eller krøllede parenteser. Det forhindrer HTTP-forespørgslen i at køre for en gruppebesked, selv hvis modellen forsøger. Referencen for kørselsbetingelser forklarer kontrollen.
Sæt Response filter til $.updates.updatedRows, så Action returnerer antallet af rækker frem for et unødvendigt leverandørsvar. Lad Action være aktiveret.
Nøglen er telegram_chat_type. Betingelsen kontrolleres, før forespørgslen sendes.
Lokal konfiguration af forespørgslen. Den genererede Sheets-URL og OAuth-godkendelsen skal komme fra din egen Google-forbindelse.
Kontroller rækken og derefter den ufuldstændige forespørgsel
Send dette gennem Agentens private Telegram-link:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Kontroller alle tre steder: svaret beskriver en forespørgsel, Action-kortet i Inbox viser de angivne værdier, og den faktiske Leads-fane indeholder den tilsvarende række. Hverken et beroligende svar eller en høj Simulation-score beviser, at Google Sheets modtog en skrivning.
Agenten registrerede det angivne navn, ønsket om tirsdag og erfaringen som begynder. Kontoret skal stadig bekræfte tilgængelighed og den præcise pris.
To detaljer af den samme gemte række gør alle fem kolonner læsbare. Det kontospecifikke samtalelink er skjult; de øvrige fire værdier er uændrede.
Start en separat test med I would like a trial lesson. Agenten bør spørge efter de manglende felter, ét spørgsmål ad gangen, før Action kører. Prøv også How much is Start Sailing?; et almindeligt kursusspørgsmål må ikke oprette en række. Prompten beder om én skrivning pr. forespørgsel, men denne opskrift til at tilføje rækker er ikke et idempotent bookingsystem. Kontroller dubletter, før du bruger den til løbende registrering.
Trin 5: Hvordan overdrager du en Telegram-samtale til en person?
Konfigurer Human Handoff, og kontroller derefter samtalens tildeling i Inbox. En prompt, der siger, at kontoret vil svare, overfører ikke i sig selv ansvaret og sætter ikke AI på pause.
En ændret tildeling er kontrolpunktet. Lad en person afslutte sagen; kontroller en eventuel tilbagevenden til AI separat.
- Vælg Saltmarsh Sailing School, åbn Actions & MCPs > Human Handoff, og aktiver funktionen. Lad denne Action være slået fra på Saltmarsh Group.
- Under Handoff Rules vælger du +. Angiv
Private enquiriessom Rule Name, indsæthandoff-rule.txti Description, og slå State til. Nye rækker starter som inaktive. Reglen dækker tilbagebetalinger, klager, ønsker om en person og accept af menneskelig hjælp på denne private Agent. - Ryd Keywords, og deaktiver de foruddefinerede regler i dette eksempel, så kun den brugerdefinerede regel er aktiv. Gem derefter. Gruppen isoleres ved at holde Human Handoff deaktiveret på den separate gruppeagent; den brugerdefinerede regel beskriver, hvornår den private Agent skal overdrage.
- Sæt Confirmation til
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Konfigurer Human Agents’ availability efter de timer, dit team faktisk bemander, og angiv en ærlig besked uden for åbningstiden. - Send
I want a refund for last week. Can I speak to a person?fra den private Telegram-samtale. - Find samtalen i Inbox, kontroller tildelingen, vælg Assign to me, og send
Hi, I’m Alex from the office. I’ll review your request.Kontroller, at beskeden ankommer i Telegram. - Send endnu en kundebesked, mens personen har ansvaret for samtalen. AI bør forblive tavs. Lad operatøren afslutte sagen og løse den i Inbox. Behandl tilbagevenden til AI som en separat test.
Den brugerdefinerede regels State er slået til. De foruddefinerede udløsere er slået fra, så der er én regel at gennemgå.
Den faktiske Telegram-anmodning udløste Handoff. Tildelingen i Inbox og operatørens udgående svar blev verificeret separat.
I den faktiske kontrol skiftede samtalen til Unassigned, klar til at en person kunne tage over. Operatøren valgte Assign to me, sendte kontorets svar, og Telegram accepterede det. Skærmbilledet ovenfor viser overdragelsessvaret, ikke operatørens senere besked. Kontroller både tildeling og levering, når du gentager testen.
Lad sagen blive hos operatøren, indtil den er løst. I vores lokale tilbagebetalingstest gav tilbagevenden til AI Agent mulighed for ét svar, før Handoff blev udløst igen. Tilbagevenden til AI kræver sin egen vellykkede opfølgende test; det er ikke en del af kriterierne for at gennemføre dette forløb. Guiden til overdragelse til et menneske uddyber bemanding og ansvar.
Trin 6: Hvordan tester du hele Telegram-chatbotten?
Brug Testing til gentagelige svarkontroller, og verificer derefter de faktiske Telegram-forløb og eksterne virkninger separat. En model kan svare korrekt, mens gruppeforbindelsen, regnearksskrivningen eller leveringen ved overdragelse stadig er forkert.
Undersøg det system, der har ansvaret for resultatet: viden for fakta, Action-logfiler for forespørgsler, Sheets for rækker og Telegram for levering.
Kør et gentageligt datasæt til svartest
- Åbn Testing, opret et datasæt med navnet
Saltmarsh: knowledge checks, og vælg Paste messages. - Indsæt
simulation-messages.txt. Behold de selvstændige separatorer---mellem tilfældene. - Åbn Evaluation criteria, indsæt pakkens
evaluation-criteria.txt, og gem. - Vælg Run > Start Run, og gennemgå de enkelte svar såvel som deres scorer.
Behold de samme spørgsmål, når du ændrer én instruktion, så sammenligningen forbliver nyttig.
Læs svarene sammen med scoren. Dette er lokale videnstests, ikke test af levering i Telegram.
Evaluatoren har brug for skolens fakta til at vurdere korrekthed. Den skal også vide, at transskriptionen ikke kan bevise en regnearksrække, levering i Telegram eller ændret tildeling. Almindelig tekstbaseret Simulation leverer ikke Telegram-chatmetadata, så Action-betingelsen for private samtaler bør ikke opfattes som defekt, når metadataene mangler. Kør kanalafhængige kontroller i den faktiske private samtale.
Hvad ændrede de lokale test?
Det første design brugte én Agent til begge indgange. En lokal test viste, at en tilbagebetalingsanmodning i gruppen overførte den fælles samtale til Human Handoff. Vi adskilte agenterne og deaktiverede både Handoff og Actions til registrering af forespørgsler på gruppeagenten. Da vi gentog gruppekontrollerne for tilbagebetaling og prøvetimer, henviste svarene til det fastgjorte private link, mens samtalen forblev tildelt AI. Derfor bruger trin 1 både konfiguration og instruktioner til at adskille de to samtaler.
De ti afsluttende lokale videnstjek fik 5/5 hver, og begge hostede agenter bestod de samme ti tilfælde. Disse små kørsler estimerer ikke nøjagtigheden i produktion. Den faktiske gruppe svarede også på spørgsmål om kursuspris og pakkeliste og undlod derefter at bekræfte udlejning af våddragter. Behold disse tilfælde med manglende fakta, når du tilpasser pakken; korrekte prissvar alene tester ikke Agentens tilbageholdenhed.
Manglende viden giver svaret »kan ikke bekræfte«. Den separate besked om portkoden henvender sig ikke til botten, og der ses intet svar på den i dette skærmbillede.
Den faktiske private forespørgsel om en prøvetime gav ét vellykket kald til Sheets-Action med Alex Morgan, Tuesday og beginner. Google returnerede HTTP 200 og én opdateret række; den gemte række indeholdt også samtalelinket og kanalen telegram. En separat Action-test med gruppechatmetadata sendte ingen HTTP-anmodning. Kontroller både den accepterede private forespørgsel og den afviste gruppekontekst, når du tilpasser betingelsen.
Kontroller kanalen og dens sideeffekter
Brug pakkens tomme test-matrix.csv til at registrere dine egne observationer. Skærmbillederne ovenfor viser de demonstrerede resultater; tabellen indeholder også kontroller, du skal køre med din egen konfiguration. Notér den forløbne tid, når du tester stilhed, og hold menneskelig overtagelse adskilt fra en eventuel senere tilbagevenden til AI.
| Kontrol | Send eller gør | Forventet resultat |
|---|---|---|
| Omtale i gruppe | @QuickchatAI_bot How much is Start Sailing? | Et kort svar med EUR 240; tilsvarende udveksling i Inbox. |
| Svar til botten | What should I bring? | Pakkelisten uden behov for en ny omtale. |
| Almindelig samtale | Does anyone know the gate code? uden omtale | Intet svar fra den fælles bot. |
| Hul i viden | Nævn botten, og spørg Do you rent wetsuits? | Kan ikke bekræfte; intet opdigtet ja eller nej. |
| Personlig anmodning i gruppen | Nævn botten, og bed om tilbagebetaling | Henvisning til privat samtale; gruppen forbliver tildelt AI. |
| Privat svar | Åbn hele DM-linket, og spørg om prisen | Den rette Agent svarer uden omtale. |
| Fuldstændig prøvetimeforespørgsel | Send Alex Morgan-beskeden fra trin 4 | Action-parametre og faktisk Sheets-række stemmer overens; ingen påstand om booking. |
| Privat overdragelse | Bed om tilbagebetaling, og svar efter overtagelsen | Menneskelig tildeling, operatørbesked leveres, intet ekstra AI-svar. |
| Vejrregler | What happens if the forecast says 30 knots? | Gratis flytning og instruktørens beslutning; ingen påstand om aktuel vejrudsigt. |
Når en kontrol fejler, retter du én relevant indstilling og kører samme besked igen. Ret manglende kildefakta i Knowledge Base; ret et for tidligt Action-kald i beskrivelsen eller de påkrævede parametre; kontroller først bekræftelse og adressering, hvis gruppen er tavs. Gem det fejlede resultat, så forbedringen er synlig.
Hvornår bør du oprette din egen bot med BotFather?
Opret din egen Telegram-bot, når du har brug for eget botnavn og billede, Telegram Bot API Actions eller en gruppe, der modtager almindelige beskeder. Den fælles bot er nok til gruppesvarene og de private svar ovenfor.
Vælg den identitet og beskedadfærd, du har brug for, før du tilføjer en anden bot.
| Behov | Fælles Quickchat AI-bot | Din egen bot |
|---|---|---|
| Oprette et BotFather-token | Ikke påkrævet | Påkrævet |
| Eget Telegram-navn og billede | Fælles identitet | Din bots identitet |
| Besvare omtaler og svar i grupper | Ja | Ja, når Telegram leverer dem |
| Svare på almindelige gruppebeskeder | Fælles bot er tavs | Konfigurer Telegram-privatliv eller administratorstatus |
| Private samtaler | Agent-specifikt startlink i den fælles bot | Din bots egen private tråd |
| Google Sheets Action | Understøttes | Understøttes |
| Actions til Telegram-moderation | Fælles token vises ikke | Eget token tilgængeligt som System Token |
- Åbn den verificerede BotFather-konto i Telegram, og send
/newbot. - Vælg et visningsnavn og derefter et ledigt brugernavn, som slutter med
bot. BotFather returnerer et token. Hold det privat. - Vælg Saltmarsh Group, hvis denne bot skal være med i en gruppe. Brug kun Saltmarsh Sailing School til private chats. I External Apps > Telegram åbner du Your own bot og vælger Connect to Telegram.
- Indsæt tokenet i Bot Token, og fuldfør forbindelsen. Kontroller, at Enable your own bot er slået til.
- Åbn bottens Telegram-link, og send
/startefterfulgt af det samme spørgsmål om kursusprisen. - Hvis du vil modtage almindelige gruppebeskeder, bruger du
/setprivacyi BotFather, vælger din bot og Disable, og fjerner derefter botten fra testgruppen og tilføjer den igen. En administratorbot modtager også almindelige beskeder. Telegrams dokumentation for privatlivstilstand forklarer leveringsreglerne.
Indsæt kun tokenet i Bot Token. Feltet vises tomt, så ingen adgangsoplysninger offentliggøres.
Hold den fælles bot og din egen bot i separate grupper. Begge i samme gruppe kan give dobbelte svar. Hvis din næste opgave er at fastgøre meddelelser eller moderere medlemmer, skal du følge den separate vejledning til Telegram-gruppeadministration, herunder Action-betingelserne, der begrænser udførelse til administratorer.
Kan ChatGPT eller Claude hjælpe med at konfigurere Telegram-chatbotten?
En forbundet app til Quickchat AI-kontoadministration kan hjælpe med at oprette en Agent, tilføje viden, konfigurere understøttede indstillinger og køre test. Når klienten tilbyder Telegram-opsætning, kan den aktivere den fælles bots Direct message link. Gruppevalg og bekræftelse i kontrolpanelet er stadig ejerens opgaver. Nogle klienter kræver også kontrolpanelet til aktivering af det direkte link og indstillinger for Human Handoff, så lad assistenten undersøge sine tilgængelige værktøjer først.
Forbind Quickchat AI-pluginet til ChatGPT eller Claude-forbindelsen, og giv pakkefilerne med denne 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.
Tilgængelige værktøjer varierer efter klient og kontotilladelser. Følg opsætningsreferencen til kontoadministration for at logge ind. Dette forbinder en assistent med din Quickchat AI-konto; det gør ikke en personlig ChatGPT- eller Claude-samtale til Telegram-bottens hostede backend.
Hvorfor svarer Telegram-chatbotten ikke?
Kontroller forbindelsen og beskedens vej, før du omskriver prompten. Disse symptomer har forskellige årsager.
| Fejlsymptom | Kontroller |
|---|---|
| Gruppen står på listen, men er tavs | Bekræft den forventede gruppe, aktiver den under Connected chats, og nævn bottens faktiske brugernavn eller svar på dens besked. |
| Botten forlod gruppen før sit første svar | Opret et nyt link via Add to a Telegram group, tilføj den igen, og vælg straks Confirm for den ventende gruppe i Quickchat AI. |
| Et simpelt botlink åbner den forkerte Agent | Brug hele det direkte beskedlink, inklusive start=. Kontroller, om en anden Agents link ændrede den fælles private samtale. |
| AI stoppede efter en tilbagebetalingsanmodning | Undersøg tildelingen i Inbox. En overdraget samtale forbliver på pause, indtil den bevidst tildeles igen. |
| Ingen række i Sheets | Kontroller, at Action er aktiveret, alle påkrævede felter er angivet, samtalen er privat, og den genererede URL stadig peger på Leads. Undersøg Action-kaldet og Google-forbindelsen. |
| Egen bot overser almindelige beskeder | Kontroller privatlivstilstand og gruppetilladelser; fjern og tilføj botten igen efter ændring af privatliv. |
| Svaret hævder en dato eller ydelse, du aldrig har angivet | Undersøg den gemte viden med status Ready og instruktionen om usikkerhed. Kør præcis det samme fejlede spørgsmål igen. |
| Test stoppede med at svare | Kontroller tilgængelige AI-kreditter og den fejlede forespørgsel; fortolk ikke en opbrugt kvote som et resultat om promptkvalitet. |
Før du inviterer kunder, skal du erstatte fiktive fakta, gennemgå adskillelsen mellem gruppe og privat og bemande overdragelseskøen. Bed en kollega kontrollere de offentlige indgange fra en anden konto som en sidste kontrol før lanceringen. For en anden fællesskabskanal følger Discord-chatbotvejledningen et lignende bygge- og testforløb. Til karaktersamtaler kan du bruge Telegram-rollespilsvejledningen.
Valgfrie opsætningskontroller: Sammenlign implementeringsmetoder ud fra dine angivne krav, eller sammenlign svar pr. kreditbudget med et angivet budget. Disse beregnere undersøger ikke din konto, dit website eller din saldo.
Saltmarsh-opsætning til kopiering
Dette er alle kildefakta og instruktioner, som vejledningen bruger. Downloaden indeholder også Action-opskriften, evalueringskriterierne og testene.
Gruppeagent: Main Prompt
Indsæt dette i Identity > Main Prompt på Saltmarsh Group. Lad Human Handoff og egne Actions være deaktiveret på denne 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.
Privat Agent: Main Prompt
Indsæt dette i Identity > Main Prompt på Saltmarsh Sailing School. Hold Action-navnet i overensstemmelse med opskriften.
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.
Viden: kurser og prøvetimeforespørgsler
Indsæt dette i feltet Content i den første vidensartikel.
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.
Viden: regler og medlemsoplysninger
Indsæt dette i feltet Content i den anden artikel.
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
Indsæt dette under Human Handoff > Handoff Rules, og konfigurer den faktiske tilgængelighed.
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.
Ofte stillede spørgsmål
Hvordan føjer jeg en AI-chatbot til en Telegram-gruppe?
Åbn External Apps i Quickchat AI, vælg Telegram og Add to a Telegram group. Vælg din gruppe i Telegram, vend tilbage til Quickchat AI, og vælg Confirm. Medlemmer kan stille spørgsmål ved at nævne den fælles bot eller svare på en af dens beskeder.
Besvarer en Telegram AI-chatbot alle beskeder?
Den fælles Quickchat AI-bot besvarer gruppebeskeder, der nævner den eller svarer på den. Almindelig gruppesamtale udløser ikke et svar. Din egen bot kan modtage almindelige gruppebeskeder, når Telegrams privatlivstilstand er slået fra, eller botten er administrator. Test den konfiguration i en separat gruppe.
Har jeg brug for BotFather eller et Telegram-bottoken?
Du behøver ikke BotFather eller et token til den fælles bot og dens direkte beskedlink. Opret din egen bot med BotFather, når du har brug for eget Telegram-navn og billede eller Actions, der kalder Telegram Bot API. Almindelige Google Sheets Actions kan fungere med den fælles bot.
Kan kunder skrive privat til Telegram-chatbotten?
Ja. Aktiver Direct message link i Quickchat AI, og del hele det genererede link. Kunden åbner det og trykker Start, hvis det er nødvendigt. Linket vælger din Agent inde i den fælles bot. Deaktivering af linket forhindrer nye forbindelser; eksisterende private samtaler har separate kontroller til aktivering og frakobling.
Er en Telegram AI-chatbot gratis?
At oprette en bot med BotFather tilføjer ikke i sig selv en AI-tjeneste. Quickchat AI tilbyder planen Free til personlig, ikke-kommerciel læring med en begrænset mængde AI-kreditter. Kommerciel brug kræver en betalt plan. Svar, Preview og Simulation bruger AI-kreditter, og eksterne tjenester kan have egne omkostninger.
Har Telegram AI-chatbots?
Telegram understøtter AI-bots og AI-integrationer fra tredjeparter. Denne vejledning forbinder en Quickchat AI Agent, som svarer ud fra din virksomheds egen viden. BotFather opretter bottens identitet; det leverer ikke denne viden eller konfigurerer dit kundesupportforløb.
Kan chatbotten forstå fotos og filer?
Telegram-integrationen kan modtage fotos og analysere deres visuelle indhold. Andre filer kan komme ind i samtalen som vedhæftninger, men deres indhold læses ikke automatisk. Test de faktiske filtyper, dine kunder bruger, og undersøg både Telegram og Inbox.
Kan jeg oprette en Telegram-bot til rollespil eller karakterer?
Ja. Den samme Telegram-forbindelse kan bruges af en Agent med en karakteridentitet og passende instruktioner. Denne vejledning bruger et eksempel på virksomhedssupport; en rollespils-Agent har brug for sin egen prompt og egne test.