En Telegram AI-chatbot kan svare på spørsmål ut fra bedriftens kunnskap i en gruppe eller en privat samtale. Quickchat AI kobler en AI Agent til Telegram gjennom en felles bot: legg den til i en gruppe, bekreft tilkoblingen i kontrollpanelet, og medlemmene kan nevne boten for å stille spørsmål. Denne fremgangsmåten krever verken kode eller et BotFather-token.
I denne veiledningen bygger vi Saltmarsh Sailing School, en fiktiv seilskole med en medlemsgruppe og private henvendelser. To Agents deler de samme skoleopplysningene: Saltmarsh Group svarer på offentlige spørsmål, mens Saltmarsh Sailing School håndterer private forespørsler om prøvetimer og kobler inn en person ved refusjoner. En forespørsel er en henvendelse til kontoret, ikke en bekreftet bestilling.
To Agents holder ansvaret adskilt. Gruppeagenten har ingen Action for overføring eller registrering av forespørsler; den private Agenten håndterer henvendelser og svar fra ansatte.
Følg løypen nedenfor. Utvidelsen med Google Sheets er valgfri; du kan fullføre svar og overføring først.
| Byggedel | Kontrollpunktet ditt |
|---|---|
| 1. Kunnskap og instruksjoner | Agenten kjenner kursprisen og finner ikke på manglende fakta. |
| 2. Gruppetilkobling | En omtale får svar; vanlige samtaler får være i fred. |
| 3. Privat samtale | Den fullstendige lenken åpner en samtale med riktig Agent. |
| 4. Valgfrie prøvetimeforespørsler | Påkrevde opplysninger blir en rad som ansatte kan følge opp. |
| 5. Human Handoff | En person overtar ansvaret for samtalen, og AI settes på pause. |
| 6. Testing | Du kontrollerer svar, ruting og eksterne effekter hver for seg. |
Last ned Saltmarsh Telegram-pakken med nøyaktig kunnskap, Main Prompt, Action-oppsett, vurderingskriterier og testmeldinger. Dette er redigerbare filer til stegene nedenfor, ikke en Agent-import med ett klikk.
De kjørbare filene, nøyaktige testmeldingene og skjermbildene beholdes på engelsk, slik at du kan gjenskape stegene og resultatene.
Hva trenger du for å lage en Telegram-chatbot?
Du trenger en Quickchat AI-konto, to Agents og en Telegram-konto med tillatelse til å legge til en bot i en testgruppe. Det valgfrie steget for registrering av forespørsler trenger også en Google-konto som kan godkjenne Google Sheets.
- Opprett en Quickchat AI-konto og bekreft e-postadressen hvis du blir bedt om det. Free støtter personlig, ikke-kommersiell læring. Planer gjelder per Agent, så en bedrift som bruker begge trenger passende kommersielle planer for begge. Preview og Simulation bruker AI-kreditter. Se de gjeldende planene.
- Opprett en Telegram-gruppe med navnet
Saltmarsh Members. Bruk en testgruppe for å kontrollere omtaler, stillhet og oppfølgingsmeldinger før du inviterer kunder. - Bruk din egen Telegram-konto i gjennomgangen, også til besøkerens meldinger. Du kan også betjene Inbox i Quickchat AI. Be en kollega sjekke opplevelsen fra en annen konto før du inviterer kunder.
- Pakk ut filene. Hold skolens eksempelfakta samlet; erstatt dem med egne bekreftede retningslinjer før lansering.
Skjermbildene fra Quickchat App viser en app som kjører lokalt med den fiktive Saltmarsh-konfigurasjonen; eksempeldata for tilkoblinger er merket i bildetekstene. Skjermbildene fra Telegram og Google Sheets viser de faktiske svarene og den lagrede forespørselen fra den tilkoblede demonstrasjonen. Personlige kontoopplysninger er beskåret bort eller uttrykkelig skjult. Bruk den avsluttende sjekklisten til å gjenta kontrollene med din egen kunnskap og dine tilkoblede kontoer.
Steg 1: Hvordan lærer du Telegram-chatboten om bedriften din?
Gi Agenten bedriftsfakta i Knowledge Base og arbeidsinstruksjoner i Main Prompt. Når disse oppgavene er adskilt, blir det enklere å rette et svar uten å endre hvordan Agenten oppfører seg.
Priser og retningslinjer er kildefakta. Korthet, usikkerhet og ruting er instruksjoner.
Opprett Agenten og legg til kunnskap
- Velg Set up manually på en ny konto. På en eksisterende konto velger du først Add new AI Agent og deretter den manuelle veien.
- På Identity skriver du
Saltmarsh Groupi Name your AI Agent. Lim inn pakkensgroup-main-prompt.txti Describe what you want your agent to do. - Fortsett oppsettet uten å koble til eksterne apper ennå. Fullfør plansteget, og bruk Skip for now hvis du starter med en læringskonto.
- Åpne Knowledge Base > Add Article. Skriv
Courses and trial enquiriesi Create custom article, velg Create article, lim innsaltmarsh-courses.txti Content, og velg Save. - Gjenta med
Weather, parking and personal enquiries, og bruksaltmarsh-policies.txt. Vent til begge artiklene viser Ready. - Åpne Actions & MCPs på Saltmarsh Group. La Human Handoff være deaktivert, og ikke legg til Action for prøvetimeforespørsler.
- Velg Add new AI Agent og gjenta det manuelle oppsettet for
Saltmarsh Sailing School, medmain-prompt.txtog de samme to kunnskapsfilene. Denne andre Agenten skal håndtere private samtaler. Velg riktig Agent i kontovelgeren før du endrer innstillinger.
To korte kilder gjør det tydelig hvilke fakta Agenten har. Ready er kontrollpunktet før en kunnskapstest.
| Kunnskap | Nøyaktige fakta brukt i eksemplet |
|---|---|
| Kurs | Start Sailing: to dager, EUR 240. Day Skipper-teori: fem kvelder, EUR 310. Privattime: 90 minutter, EUR 95. |
| Datoer | Sesong fra april til oktober; datoer publiseres én måned i forveien. Ingen løpende tilgjengelighet eller neste dato er oppgitt. |
| Utstyr | Vanntett jakke, sko med såler som ikke setter merker, og skiftetøy. Flytevester tilbys. |
| Vær | Over 25 knop eller tordenvær: flytting til neste tilgjengelige dato uten ekstra kostnad. Instruktøren avgjør samme morgen. |
| Parkering | Gratis ved klubbhuset. Portkoden sendes dagen før; selve koden mangler. |
| Prøvetimeforespørsler | Samle inn navn, ønsket ukedag og seilerfaring. Kontoret bekrefter tilgjengelighet og pris. |
Utleie av våtdrakter er utelatt med vilje. Riktig svar er at Agenten ikke kan bekrefte det, i stedet for et oppdiktet ja eller nei. Værregelen gir heller ikke dagens værmelding, og prisen på privattimer fastsetter ikke en pris for prøvetimen.
Angi Main Prompt og kontroller et svar
- Åpne Identity > Main Prompt på hver Agent og kontroller den tilhørende Saltmarsh-prompten. Gruppeprompten svarer på generelle spørsmål og viser til den festede private lenken i gruppen; den private prompten samler forespørsler og bruker Human Handoff.
- Åpne AI Preview og spør
How much is Start Sailing?. Kontroller at svaret oppgir to dager og EUR 240. - Spør
Do you rent wetsuits?. Kontroller at svaret innrømmer at informasjonen mangler.
Den private Agentens prompt definerer registrering og overføring. Gruppeagenten bruker en egen prompt og har begge Actions deaktivert.
To utsnitt fra gruppeagentens faktiske innstillinger. Den kan svare på kunnskapsspørsmål, men har ingen Action for registrering eller overføring å kjøre.
To Agents gjør rutingen tydelig. Gruppeagenten kan ikke utløse en overføring ved et uhell; den private Agenten kan overføre en refusjonsforespørsel uten å pause gruppen. Preview kontrollerer skolefakta, mens de neste stegene verifiserer hver Telegram-tilkobling.
Steg 2: Hvordan legger du AI-chatboten til i en Telegram-gruppe?
Åpne External Apps > Telegram, legg den felles boten til i gruppen, og gå tilbake til Quickchat AI for å velge Confirm for gruppen. Agenten er stille i gruppen frem til du bekrefter den.
Telegram-medlemskap og Quickchat AI-bekreftelse er separate steg.
- Velg Saltmarsh Group i Agent-velgeren. Åpne External Apps, velg Telegram, og finn Quickchat AI bot.
- Velg Add to a Telegram group. I Telegram velger du
Saltmarsh Membersog godkjenner at boten legges til. - Gå tilbake til Quickchat AI. Under Waiting for your confirmation kontrollerer du gruppenavnet og opplysningene i Added by.
- Velg Confirm for riktig gruppe. Den skal flyttes til Connected chats, med aktiveringsbryteren på.
- Skriv
@i Telegram og velg boten fra listen over omtaler. SpørHow much is Start Sailing?. Den felles botens brukernavn er vanligvis@QuickchatAI_bot; bruk det faktiske brukernavnet som vises i gruppen din. - Svar direkte på svaret med
What should I bring?. Send deretter en separat melding uten omtale:Does anyone know the gate code?. Den felles boten skal besvare svaret og være stille på den vanlige meldingen.
Velg Saltmarsh Members i Telegram, og gå tilbake til Quickchat AI for å bekrefte tilkoblingen.
Faktisk lokalt grensesnitt med forhåndsopprettede gruppetestdata som viser hvor Confirm finnes. Dette illustrerer kontrollen, men beviser ikke at Telegram ble med i en aktiv gruppe.
Den bekreftede gruppen fikk det forventede kurssvaret. Nevn boten med det faktiske brukernavnet.
Å svare på botens melding fungerer uten å nevne den på nytt. Svaret lister opp de oppgitte utstyrsopplysningene.
Bekreftelsen er viktig fordi invitasjonsdataene vises i gruppen. Quickchat AI krever en beslutning fra kontosiden før gruppen behandles som en destinasjon for Agenten din. Ikke bekreft en gruppe du ikke kjenner igjen. Referansen for Telegram-tilkobling forklarer den samme grensen.
Fullfør bekreftelsen før du forlater oppsettet. Hvis boten forlater en ubekreftet gruppe, opprett en ny lenke via Add to a Telegram group, legg den til igjen og bekreft den ventende gruppen umiddelbart i Quickchat AI. Å legge til boten gjennom Telegrams medlemssøk erstatter ikke denne tilkoblingsflyten.
Merket Admin viser botens status i Telegram. Det er ikke påkrevd for vanlige svar fra den felles boten. Å gjøre den felles boten til administrator endrer heller ikke regelen om omtaler eller svar.
Steg 3: Hvordan aktiverer du private Telegram-samtaler?
Aktiver Direct message link og del hele den genererte URL-en. Lenken velger Agenten din inne i den felles Telegram-boten, slik at kunder kan spørre privat uten å legge den til i en gruppe.
Gruppen er en felles samtale. Flytt personopplysninger og overføringer til ansatte til private meldinger.
- Velg Saltmarsh Sailing School, den private Agenten. Åpne External Apps > Telegram og slå på Direct message link. La gruppetilkoblingene være tomme.
- Kopier den genererte lenken. Behold parameteren
start=; en ren lenke til den felles boten identifiserer ikke Agenten din. - Åpne den i Telegram, og trykk Start hvis du blir bedt om det.
- Spør
How much is Start Sailing?uten å nevne boten. Bekreft skolens svar og finn samtalen i Inbox. - Fest lenken i gruppens velkomstmelding, slik at folk finner den før de deler personopplysninger.
Bruk lenken som er generert for din egen Agent. Det lokale oppsettet her er ikke en kvittering på faktisk Telegram-levering.
Telegram leverte Saltmarsh-velkomsten etter Start. Kontroller et kunnskapssvar etterpå; velkomsten alene tester ikke informasjonsinnhentingen.
To utsnitt fra samme Telegram-skjerm viser den festede invitasjonen. Demolenkens start-verdi er utelatt; fest din egen fullstendige genererte lenke.
En privat samtale med den felles boten er bundet til én Agent om gangen. Å åpne en annen Agents direktelenke kan endre tilknytningen. For en egen Telegram-identitet og en dedikert bottråd bruker du veien med egen bot.
Å slå av Direct message link hindrer nye tilkoblinger gjennom lenken. Bruk aktiveringsbryteren eller Disconnect for å stoppe en allerede tilkoblet samtale. Behandle lenken som en offentlig inngang, ikke som en tilgangsbegrensning for fortrolig kunnskap.
Steg 4: Hvordan lagrer du en prøvetimeforespørsel i Google Sheets?
Google Sheets-integrasjonen oppretter et regneark og en Action som legger til rader. Tilpass denne Action til å registrere tre obligatoriske felt for forespørselen, og kontroller den faktiske raden. Dette steget er valgfritt og fungerer med den felles Telegram-boten.
Resultatet er en forespørsel en person skal følge opp. Det reserverer ikke en plass og fastsetter ingen prøvetimepris.
Koble til Sheets og konfigurer én Action
- På Saltmarsh Sailing School åpner du Actions & MCPs > Add Action > Google Sheets og velger Connect Google Sheets. Logg inn på riktig Google-konto og godkjenn den forespurte tilgangen.
- Åpne det genererte regnearket Quickchat Leads. Behold fanenavnet Leads, fordi den genererte Action-URL-en peker til denne fanen.
- Erstatt overskriftsraden, i rekkefølge, med
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - Åpne Actions & MCPs og rediger den genererte Action
log_lead_to_google_sheet. Bruk oppsettet nedenfor. Endre parameterne, forespørselsinnholdet og regnearkoverskriftene sammen, slik at posisjonene samsvarer.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Navnet personen oppga for denne prøvetimeforespørselen. Spør etter det hvis det mangler. | Ja |
| Text | preferred_weekday | Ukedagen personen foretrekker for en prøvetime, for eksempel tirsdag. Dette er et ønske, ikke en bekreftet dato. | Ja |
| Text | sailing_experience | Seilerfaringen personen selv oppgir, for eksempel nybegynner. Spør hvis den mangler; ikke utled den selv. | Ja |
Sett alle tre parameterne til No default, og fjern standardparameterne for e-post og henvendelse. Disse tre feltene er de eneste spørsmålene i oppsettet. Et Telegram-brukernavn er valgfritt og ikke et pålitelig obligatorisk kontaktfelt; den registrerte samtalelenken gir ansatte en vei tilbake til henvendelsen.
Metode og URL: behold den genererte POST-URL-en. Den inneholder allerede regneark-ID-en din, Leads-fanen og valueInputOption=RAW. Du trenger ikke fylle inn noen plassholder for regneark-ID.
Headers: behold integrasjonens konfigurasjon.
| HTTP-hode | Verdi |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
I API Endpoint-fanen Body bruker du:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Bruk Add AI Data for å sette inn brikker for parametere og samtalevariabler der det trengs. De tre første verdiene kommer fra samtalen; de to siste leveres 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.
Åpne Advanced settings > Run only when og legg til telegram_chat_type equals private. Bruk selve metadatanøkkelen, uten metadata_ eller krøllparenteser. Dette hindrer HTTP-forespørselen i å kjøre for en gruppemelding selv om modellen forsøker. Referansen for kjørebetingelser forklarer kontrollen.
Sett Response filter til $.updates.updatedRows slik at Action returnerer radantallet i stedet for et unødvendig leverandørsvar. La Action være aktivert.
Nøkkelen er telegram_chat_type. Betingelsen kontrolleres før forespørselen sendes.
Lokalt oppsett av forespørselen. Den genererte Sheets-URL-en og OAuth-godkjenningen må komme fra din egen Google-tilkobling.
Kontroller raden, og deretter den ufullstendige forespørselen
Send dette gjennom Agentens private Telegram-lenke:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Kontroller alle tre steder: svaret beskriver en forespørsel, Action-kortet i Inbox viser de oppgitte verdiene, og den faktiske Leads-fanen inneholder den tilsvarende raden. Verken et betryggende svar eller en høy Simulation-score beviser at Google Sheets mottok en skriving.
Agenten registrerte det oppgitte navnet, ønsket om tirsdag og erfaringen som nybegynner. Kontoret må fortsatt bekrefte tilgjengelighet og nøyaktig pris.
To detaljer fra den samme lagrede raden gjør alle fem kolonnene lesbare. Den kontospesifikke samtalelenken er skjult; de andre fire verdiene er uendret.
Start en separat test med I would like a trial lesson. Agenten skal spørre om de manglende feltene, ett spørsmål om gangen, før Action kjøres. Prøv også How much is Start Sailing?; et vanlig kursspørsmål skal ikke opprette en rad. Prompten ber om én skriving per forespørsel, men dette oppsettet for å legge til rader er ikke et idempotent bestillingssystem. Se etter duplikater før du bruker det til løpende registrering.
Steg 5: Hvordan overfører du en Telegram-samtale til en person?
Konfigurer Human Handoff, og kontroller deretter samtalens tildeling i Inbox. En prompt som sier at kontoret vil svare, overfører ikke i seg selv ansvaret eller setter AI på pause.
En endret tildeling er kontrollpunktet. La en person avslutte saken; kontroller eventuell retur til AI separat.
- Velg Saltmarsh Sailing School, åpne Actions & MCPs > Human Handoff, og aktiver funksjonen. La denne Action være av på Saltmarsh Group.
- Under Handoff Rules velger du +. Skriv
Private enquiriessom Rule Name, lim innhandoff-rule.txti Description, og slå på State. Nye rader starter som inaktive. Regelen dekker refusjoner, klager, forespørsler om en person og aksept av menneskelig hjelp på denne private Agenten. - Tøm Keywords og deaktiver de forhåndsdefinerte reglene for dette eksemplet, slik at bare den egendefinerte regelen er aktiv. Lagre deretter. Gruppen isoleres ved å holde Human Handoff deaktivert på den separate gruppeagenten; den egendefinerte regelen beskriver når den private Agenten skal overføre.
- Sett Confirmation til
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Konfigurer Human Agents’ availability for tidene teamet faktisk bemanner, og angi en ærlig melding utenfor åpningstid. - Send
I want a refund for last week. Can I speak to a person?fra den private Telegram-samtalen. - Finn samtalen i Inbox, kontroller tildelingen, velg Assign to me, og send
Hi, I’m Alex from the office. I’ll review your request.Kontroller at meldingen kommer frem i Telegram. - Send en ny kundemelding mens personen har ansvaret for samtalen. AI skal være stille. La operatøren fullføre saken og løse den i Inbox. Behandle retur til AI som en separat test.
Den egendefinerte regelens State er på. De forhåndsdefinerte utløserne er av, slik at én regel står igjen å gjennomgå.
Den virkelige Telegram-forespørselen utløste Handoff. Tildelingen i Inbox og operatørens utgående svar ble kontrollert separat.
I den virkelige kontrollen gikk samtalen til Unassigned, klar til at en person kunne ta over. Operatøren valgte Assign to me, sendte kontorets svar, og Telegram godtok det. Skjermbildet over viser overføringssvaret, ikke operatørens senere melding. Kontroller både tildeling og levering når du gjentar testen.
La saken bli hos operatøren til den er løst. I vår lokale refusjonstest tillot retur til AI Agent ett svar før Handoff ble utløst igjen. Retur til AI trenger en egen vellykket oppfølgingstest; det er ikke et av kriteriene for å fullføre denne arbeidsflyten. Veiledningen for overføring til mennesker forklarer bemanning og ansvar nærmere.
Steg 6: Hvordan tester du hele Telegram-chatboten?
Bruk Testing til repeterbare svarkontroller, og kontroller deretter de faktiske Telegram-løpene og eksterne effektene separat. En modell kan svare riktig selv om gruppetilkoblingen, regnearkskrivingen eller leveringen ved overføring fortsatt er feil.
Undersøk systemet som eier resultatet: kunnskap for fakta, Action-logger for forespørsler, Sheets for rader og Telegram for levering.
Kjør et repeterbart datasett for svar
- Åpne Testing, opprett et datasett med navnet
Saltmarsh: knowledge checks, og velg Paste messages. - Lim inn
simulation-messages.txt. Behold de frittstående skilletegnene---mellom tilfellene. - Åpne Evaluation criteria, lim inn pakkens
evaluation-criteria.txt, og lagre. - Velg Run > Start Run, og undersøk de enkelte svarene i tillegg til poengene.
Behold de samme spørsmålene når du endrer én instruks, slik at sammenligningen fortsatt er nyttig.
Les svarene sammen med poengsummen. Dette er lokale kunnskapstester, ikke tester av Telegram-levering.
Evaluatoren trenger skolefakta for å vurdere riktighet. Den må også vite at transkripsjonen ikke kan bevise en rad i regnearket, Telegram-levering eller endret tildeling. Vanlig tekstbasert Simulation gir ikke Telegram-metadata, så Action-betingelsen for private samtaler skal ikke regnes som ødelagt når metadataene mangler. Kjør kanalavhengige kontroller i den faktiske private samtalen.
Hva endret de lokale testene?
Det første oppsettet brukte én Agent for begge inngangene. En lokal test viste at en refusjonsforespørsel i gruppen overførte den felles samtalen til Human Handoff. Vi skilte agentene og slo av både Handoff og Actions for registrering av forespørsler på gruppeagenten. Da vi gjentok gruppekontrollene for refusjon og prøvetimer, pekte svarene til den festede private lenken mens samtalen forble tildelt AI. Derfor bruker trinn 1 både konfigurasjon og instruksjoner til å skille de to samtalene.
De ti siste lokale kunnskapskontrollene fikk 5/5 hver, og begge de driftede agentene besto de samme ti tilfellene. Disse små kjøringene er ikke et estimat på nøyaktighet i produksjon. Den virkelige gruppen svarte også på spørsmålene om kurspris og pakkeliste og lot deretter være å bekrefte utleie av våtdrakter. Behold disse tilfellene med manglende fakta når du tilpasser pakken; riktige prissvar alene tester ikke Agentens tilbakeholdenhet.
Manglende kunnskap gir «kan ikke bekrefte». Den separate meldingen om portkoden henvender seg ikke til boten, og det er ikke noe synlig svar på den i dette skjermbildet.
Den virkelige private forespørselen om en prøvetime ga ett vellykket kall til Sheets-Action med Alex Morgan, Tuesday og beginner. Google returnerte HTTP 200 og én oppdatert rad; den lagrede raden inneholdt også samtalelenken og kanalen telegram. En separat Action-test med gruppechatmetadata sendte ingen HTTP-forespørsel. Kontroller både den godkjente private forespørselen og den avviste gruppekonteksten når du tilpasser vilkåret.
Kontroller kanalen og sideeffektene
Bruk pakkens tomme test-matrix.csv til å registrere dine egne observasjoner. Skjermbildene over viser de demonstrerte resultatene; tabellen inneholder også kontroller som skal kjøres med din egen konfigurasjon. Noter tiden som har gått når du tester stillhet, og hold menneskelig overtakelse atskilt fra eventuell senere retur til AI.
| Kontroll | Send eller gjør | Forventet resultat |
|---|---|---|
| Omtale i gruppe | @QuickchatAI_bot How much is Start Sailing? | Et kort svar med EUR 240; tilsvarende utveksling i Inbox. |
| Svar til boten | What should I bring? | Pakkelisten, uten at en ny omtale trengs. |
| Vanlig samtale | Does anyone know the gate code? uten omtale | Ingen respons fra den felles boten. |
| Kunnskapshull | Nevn boten og spør Do you rent wetsuits? | Kan ikke bekrefte; ikke noe oppdiktet ja eller nei. |
| Personlig forespørsel i gruppen | Nevn boten og be om refusjon | Henvisning til privat samtale; gruppen forblir tildelt AI. |
| Privat svar | Åpne hele DM-lenken og spør om prisen | Riktig Agent svarer uten omtale. |
| Fullstendig prøvetimeforespørsel | Send Alex Morgan-meldingen fra steg 4 | Action-parametere og faktisk Sheets-rad samsvarer; ingen påstand om bestilling. |
| Privat overføring | Be om refusjon, og svar etter overtakelse | Tildeling til menneske, levering av operatørens melding, ingen ekstra AI-respons. |
| Værregler | What happens if the forecast says 30 knots? | Gratis flytting og instruktørens avgjørelse; ingen påstand om aktuell værmelding. |
Når en kontroll feiler, endrer du én relevant innstilling og kjører samme melding på nytt. Rett manglende kildefakta i Knowledge Base; rett et for tidlig Action-kall i beskrivelsen eller påkrevde parametere; kontroller først bekreftelse og adressering hvis gruppen er stille. Behold det mislykkede resultatet, slik at forbedringen er synlig.
Når bør du opprette din egen bot med BotFather?
Opprett en egen Telegram-bot når du trenger eget botnavn og bilde, Telegram Bot API Actions eller en gruppe som mottar vanlige meldinger. Den felles boten er nok for gruppesvarene og de private svarene ovenfor.
Velg identiteten og meldingsatferden du trenger før du legger til en ny bot.
| Behov | Felles Quickchat AI-bot | Din egen bot |
|---|---|---|
| Opprette et BotFather-token | Ikke påkrevd | Påkrevd |
| Eget Telegram-navn og bilde | Felles identitet | Din bots identitet |
| Svare på gruppeomtaler og svar | Ja | Ja, når Telegram leverer dem |
| Svare på vanlige gruppemeldinger | Felles bot er stille | Konfigurer Telegram-personvern eller administratorstatus |
| Private samtaler | Agent-spesifikk startlenke i den felles boten | Botens egen private tråd |
| Google Sheets Action | Støttes | Støttes |
| Telegram-modererings-Actions | Felles token eksponeres ikke | Eget token tilgjengelig som System Token |
- Åpne den verifiserte BotFather-kontoen i Telegram og send
/newbot. - Velg et visningsnavn og deretter et tilgjengelig brukernavn som slutter på
bot. BotFather returnerer et token. Hold det privat. - Velg Saltmarsh Group hvis denne boten skal legges til i en gruppe. Bruk Saltmarsh Sailing School bare til private samtaler. I External Apps > Telegram åpner du Your own bot og velger Connect to Telegram.
- Lim tokenet inn i Bot Token, og fullfør tilkoblingen. Kontroller at Enable your own bot er på.
- Åpne botens Telegram-lenke og send
/start, og deretter det samme spørsmålet om kursprisen. - Hvis du vil motta vanlige gruppemeldinger, bruker du
/setprivacyi BotFather, velger boten og Disable, og fjerner og legger den til i testgruppen igjen. En administratorbot mottar også vanlige meldinger. Telegrams dokumentasjon for personvernmodus forklarer leveringsreglene.
Lim bare tokenet inn i Bot Token. Feltet vises tomt, slik at ingen legitimasjon publiseres.
Hold den felles boten og din egen bot i separate grupper. Begge i én gruppe kan gi doble svar. Hvis neste oppgave er å feste kunngjøringer eller moderere medlemmer, følger du den separate veiledningen for Telegram-gruppeadministrasjon, inkludert Action-betingelsene som begrenser kjøring til administratorer.
Kan ChatGPT eller Claude hjelpe med å konfigurere Telegram-chatboten?
En tilkoblet app for Quickchat AI-kontoadministrasjon kan hjelpe med å opprette en Agent, legge til kunnskap, konfigurere støttede innstillinger og kjøre tester. Når klienten tilbyr Telegram-oppsett, kan den aktivere den felles botens Direct message link. Gruppevalg og bekreftelse i kontrollpanelet er fortsatt eierens oppgaver. Noen klienter krever også kontrollpanelet for aktivering av direktelenken og innstillinger for Human Handoff, så la assistenten undersøke de tilgjengelige verktøyene først.
Koble til Quickchat AI-pluginen for ChatGPT eller Claude-koblingen, og legg ved pakkefilene med denne prompten:
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.
Tilgjengelige verktøy varierer med klient og kontotillatelser. Følg oppsettreferansen for kontoadministrasjon for innlogging. Dette kobler en assistent til Quickchat AI-kontoen din; det gjør ikke en personlig ChatGPT- eller Claude-samtale til Telegram-botens driftede backend.
Hvorfor svarer ikke Telegram-chatboten?
Kontroller tilkoblingen og meldingsveien før du skriver om prompten. Disse symptomene har ulike årsaker.
| Feiltegn | Kontroller |
|---|---|
| Gruppen vises, men er stille | Bekreft riktig gruppe, aktiver den under Connected chats, og nevn botens faktiske brukernavn eller svar på meldingen dens. |
| Boten forlot gruppen før sitt første svar | Opprett en ny lenke via Add to a Telegram group, legg den til igjen og velg umiddelbart Confirm for den ventende gruppen i Quickchat AI. |
| En ren botlenke åpner feil Agent | Bruk hele direktelenken, inkludert start=. Kontroller om en annen Agents lenke endret den felles private samtalen. |
| AI stoppet etter en refusjonsforespørsel | Undersøk tildelingen i Inbox. En overført samtale forblir pauset til den bevisst tildeles på nytt. |
| Ingen rad i Sheets | Kontroller at Action er aktivert, alle obligatoriske felt er oppgitt, samtalen er privat og den genererte URL-en fortsatt peker til Leads. Undersøk Action-kallet og Google-tilkoblingen. |
| Egen bot går glipp av vanlige meldinger | Kontroller personvernmodus og gruppetillatelser; fjern og legg til boten på nytt etter endret personvern. |
| Svaret hevder en dato eller tjeneste du aldri oppga | Undersøk den lagrede kunnskapen med status Ready og instruksen om usikkerhet. Kjør nøyaktig det samme spørsmålet på nytt. |
| Tester sluttet å svare | Kontroller tilgjengelige AI-kreditter og den mislykkede forespørselen; ikke tolk en overskredet kvote som et resultat om promptkvalitet. |
Før du inviterer kunder, erstatt fiktive fakta, gjennomgå skillet mellom gruppe og privat, og bemann overføringskøen. Be en kollega sjekke de offentlige inngangene fra en annen konto som en siste kontroll før lansering. For en annen fellesskapskanal følger Discord-chatbotveiledningen en lignende bygge- og testløype. For karaktersamtaler bruker du Telegram-rollespillveiledningen.
Valgfrie oppsettkontroller: Sammenlign utrullingsmetoder ut fra oppgitte krav, eller sammenlign svar per kredittbudsjett med et oppgitt budsjett. Disse kalkulatorene undersøker ikke kontoen din, nettstedet ditt eller saldoen din.
Saltmarsh-oppsett du kan kopiere
Dette er alle kildefakta og instruksjoner som brukes i veiledningen. Nedlastingen inkluderer også Action-oppsettet, vurderingskriteriene og testene.
Gruppeagent: Main Prompt
Lim dette inn i Identity > Main Prompt på Saltmarsh Group. Hold Human Handoff og egendefinerte Actions deaktivert på denne 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
Lim dette inn i Identity > Main Prompt på Saltmarsh Sailing School. Sørg for at Action-navnet samsvarer med oppsettet.
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.
Kunnskap: kurs og prøvetimeforespørsler
Lim dette inn i Content-feltet i den første kunnskapsartikkelen.
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.
Kunnskap: retningslinjer og medlemsinformasjon
Lim dette inn i Content-feltet i den andre artikkelen.
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
Lim dette inn under Human Handoff > Handoff Rules, og konfigurer den faktiske tilgjengeligheten.
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.
Vanlige spørsmål
Hvordan legger jeg en AI-chatbot til i en Telegram-gruppe?
Åpne External Apps i Quickchat AI, velg Telegram og Add to a Telegram group. Velg gruppen i Telegram, gå tilbake til Quickchat AI, og velg Confirm. Medlemmer kan stille spørsmål ved å nevne den felles boten eller svare på en av meldingene dens.
Svarer en Telegram AI-chatbot på alle meldinger?
Den felles Quickchat AI-boten svarer på gruppemeldinger som nevner den eller svarer på den. Vanlig gruppesamtale utløser ikke noe svar. Din egen bot kan motta vanlige gruppemeldinger når Telegram-personvernmodus er deaktivert eller boten er administrator. Test dette oppsettet i en separat gruppe.
Trenger jeg BotFather eller et Telegram-bottoken?
Du trenger ikke BotFather eller et token for den felles boten og direktelenken. Opprett din egen bot med BotFather når du trenger eget Telegram-navn og bilde eller Actions som kaller Telegram Bot API. Vanlige Google Sheets Actions kan fungere med den felles boten.
Kan kunder sende private meldinger til Telegram-chatboten?
Ja. Aktiver Direct message link i Quickchat AI og del hele den genererte lenken. Kunden åpner den og trykker Start ved behov. Lenken velger Agenten din inne i den felles boten. Å slå av lenken hindrer nye tilkoblinger; eksisterende private samtaler har separate kontroller for aktivering og frakobling.
Er en Telegram AI-chatbot gratis?
Å opprette en bot med BotFather legger ikke i seg selv til en AI-tjeneste. Quickchat AI tilbyr Free-planen for personlig, ikke-kommersiell læring med en begrenset mengde AI-kreditter. Kommersiell bruk krever en betalt plan. Svar, Preview og Simulation bruker AI-kreditter, og eksterne tjenester kan ha egne kostnader.
Har Telegram AI-chatboter?
Telegram støtter AI-boter og AI-integrasjoner fra tredjeparter. Denne veiledningen kobler til en Quickchat AI Agent som svarer ut fra din egen bedriftskunnskap. BotFather oppretter botens identitet; det leverer ikke kunnskapen eller konfigurerer kundestøtteflyten din.
Kan chatboten forstå bilder og filer?
Telegram-integrasjonen kan motta bilder og analysere det visuelle innholdet. Andre filer kan komme til samtalen som vedlegg, men innholdet leses ikke automatisk. Test de faktiske filtypene kundene bruker, og undersøk både Telegram og Inbox.
Kan jeg lage en Telegram-bot for rollespill eller karakterer?
Ja. Den samme Telegram-tilkoblingen kan brukes av en Agent med en karakteridentitet og passende instruksjoner. Denne veiledningen bruker et eksempel fra bedriftsstøtte; en rollespill-Agent trenger sin egen prompt og egne tester.