Telegram AI pokalbių botas gali atsakyti pagal jūsų įmonės žinias grupėje arba privačiai. Quickchat AI prijungia Agentą prie Telegram per bendrą botą: pridėkite jį į grupę, patvirtinkite ryšį valdymo skydelyje, ir nariai galės užduoti klausimą paminėdami botą. Šiam būdui nereikia kodo ar BotFather žetono.
Šiame vadove kuriama Saltmarsh Sailing School, išgalvota mokykla su narių grupe ir privačiomis užklausomis. Du Agentai naudoja tas pačias žinias: Saltmarsh Group atsako viešai, o Saltmarsh Sailing School priima privačias bandomųjų pamokų užklausas ir dėl pinigų grąžinimo įtraukia žmogų. Užklausa skirta administracijai, tai nėra patvirtinta rezervacija.
Du Agentai atskiria atsakomybę. Grupės Agentas neturi perdavimo ar užklausų priėmimo Action; privatus Agentas tvarko užklausas ir darbuotojų atsakymus.
Eikite toliau pateiktu keliu. Google Sheets plėtinys neprivalomas; pirmiausia galite užbaigti atsakymų ir perdavimo žmogui eigą.
| Ką sukursite | Patikros taškas |
|---|---|
| 1. Žinios ir instrukcijos | Agentas žino kurso kainą ir neišgalvoja trūkstamų faktų. |
| 2. Grupės prijungimas | Atsako paminėtas, tyli įprastame pokalbyje. |
| 3. Privatus pokalbis | Visa nuoroda atveria pokalbį su tinkamu Agentu. |
| 4. Neprivalomos pamokų užklausos | Būtini duomenys tampa eilute darbuotojų peržiūrai. |
| 5. Human Handoff | Pokalbį perima žmogus, AI pristabdomas. |
| 6. Testavimas | Atsakymus, nukreipimą ir išorinius veiksmus tikrinate atskirai. |
Atsisiųskite Saltmarsh Telegram rinkinį su tiksliomis žiniomis, Main Prompt, Action receptu, vertinimo kriterijais ir testavimo žinutėmis. Tai redaguojami failai tolesniems žingsniams, o ne Agento importas vienu spustelėjimu. Pavyzdžių failai, žinutės ir ekrano vaizdai lieka anglų kalba, kad atitiktų patikrintą pavyzdį.
Ko reikia Telegram botui sukurti?
Reikia Quickchat AI paskyros, dviejų Agentų ir Telegram paskyros, galinčios pridėti botą į testavimo grupę. Neprivalomam užklausų registravimui dar reikia Google paskyros, galinčios suteikti Google Sheets prieigą.
- Sukurkite Quickchat AI paskyrą ir, jei prašoma, patvirtinkite el. paštą. Free skirtas asmeniniam nekomerciniam mokymuisi. Planai taikomi kiekvienam Agentui, todėl abu naudojančiam verslui reikia tinkamų komercinių planų abiem. Preview ir Simulation naudoja AI kreditus. Peržiūrėkite dabartinius planus.
- Sukurkite Telegram grupę
Saltmarsh Members. Testavimo grupėje patikrinkite paminėjimus, tylą ir tęstines žinutes prieš pakviesdami klientus. - Vadovą vykdykite su savo Telegram paskyra, įskaitant lankytojo žinutes. Taip pat galite dirbti su Quickchat AI Inbox. Prieš kviesdami klientus paprašykite kolegos patikrinti patirtį iš kitos paskyros.
- Išskleiskite rinkinį. Mokyklos pavyzdinius faktus laikykite kartu; prieš paleisdami pakeiskite juos savo patikrintomis taisyklėmis.
Quickchat App ekrano nuotraukose rodoma vietoje veikianti programa su išgalvota Saltmarsh konfigūracija; parengti ryšių testiniai duomenys nurodyti antraštėse. Telegram ir Google Sheets nuotraukose matomi tikri prijungtos demonstracijos atsakymai ir išsaugota užklausa. Asmeniniai paskyros duomenys iškirpti arba aiškiai paslėpti. Naudodami galutinį sąrašą pakartokite patikras su savo žiniomis ir prijungtomis paskyromis.
1 žingsnis: kaip išmokyti Telegram botą jūsų verslo žinių?
Verslo faktus įrašykite į Knowledge Base, o veikimo instrukcijas į Main Prompt. Taip lengviau pataisyti atsakymą nekeičiant Agento elgesio.
Kainos ir taisyklės yra šaltinių faktai. Trumpumas, neapibrėžtumas ir nukreipimas yra instrukcijos.
Sukurkite Agentą ir pridėkite žinias
- Naujoje paskyroje pasirinkite Set up manually. Esamoje pirmiausia spauskite Add new AI Agent, tada rinkitės rankinę sąranką.
- Identity puslapio Name your AI Agent lauke įrašykite
Saltmarsh Group. Rinkiniogroup-main-prompt.txtįklijuokite į Describe what you want your agent to do. - Tęskite neprijungdami išorinių programų. Užbaikite plano pasirinkimą; mokymosi paskyrai galite rinktis Skip for now.
- Atverkite Knowledge Base > Add Article. Į Create custom article įrašykite
Courses and trial enquiries, pasirinkite Create article, į Content įklijuokitesaltmarsh-courses.txtir spauskite Save. - Pakartokite su
Weather, parking and personal enquiries, naudodamisaltmarsh-policies.txt. Palaukite, kol abu straipsniai rodys Ready. - Saltmarsh Group atverkite Actions & MCPs. Human Handoff palikite išjungtą ir nepridėkite pamokos užklausos Action.
- Pasirinkite Add new AI Agent ir pakartokite rankinę sąranką
Saltmarsh Sailing School, naudodamimain-prompt.txtir tuos pačius du žinių failus. Šis Agentas tvarkys privačius pokalbius. Prieš keisdami nustatymus paskyros perjungiklyje pasirinkite reikiamą Agentą.
Du trumpi šaltiniai aiškiai parodo, kokius faktus Agentas turi. Prieš žinių testą patikrinkite Ready būseną.
| Žinios | Tikslūs šio pavyzdžio faktai |
|---|---|
| Kursai | Start Sailing: dvi dienos, EUR 240. Day Skipper theory: penki vakarai, EUR 310. Privati pamoka: 90 minučių, EUR 95. |
| Datos | Sezonas nuo balandžio iki spalio; datos skelbiamos prieš mėnesį. Kitos datos ar realaus vietų prieinamumo nėra. |
| Įranga | Neperšlampama striukė, žymių nepaliekantys batai ir persirengimo drabužiai. Plūdrumo liemenes duoda mokykla. |
| Oras | Daugiau nei 25 mazgai arba perkūnija: perkeliama į kitą laisvą datą be papildomo mokesčio. Instruktorius sprendžia tą rytą. |
| Parkavimas | Nemokamas prie klubo. Vartų kodas siunčiamas išvakarėse; paties kodo nėra. |
| Bandomosios pamokos | Surinkite vardą, pageidaujamą savaitės dieną ir buriavimo patirtį. Administracija patvirtina laiką ir kainą. |
Hidrokostiumų nuoma sąmoningai nepaminėta. Tinkamas atsakymas pripažįsta, kad patvirtinti negali, užuot išgalvojęs taip ar ne. Oro taisyklė nesuteikia šiandienos prognozės, o privačios pamokos kaina nenustato bandomosios pamokos kainos.
Nustatykite Main Prompt ir patikrinkite atsakymą
- Kiekviename Agente atverkite Identity > Main Prompt ir patikrinkite atitinkamą Saltmarsh instrukciją. Grupės instrukcija atsako bendrai ir nurodo grupėje prisegtą privačią nuorodą; privati renka užklausas ir naudoja Human Handoff.
- Atverkite AI Preview ir paklauskite
How much is Start Sailing?. Tikrinkite dvi dienas ir EUR 240. - Paklauskite
Do you rent wetsuits?. Atsakymas turi pripažinti, kad informacijos trūksta.
Privataus Agento instrukcija apibrėžia duomenų rinkimą ir perdavimą. Grupės Agentas naudoja atskirą instrukciją ir abi Actions turi išjungtas.
Dvi tikrų grupės Agento nustatymų iškarpos. Jis atsako pagal žinias, bet negali vykdyti užklausų priėmimo ar perdavimo Action.
Du Agentai aiškiai atskiria nukreipimą. Grupės Agentas negali netyčia perduoti pokalbio; privatus gali perduoti grąžinimo prašymą nestabdydamas grupės. Preview tikrina mokyklos faktus, o tolesni žingsniai tikrina Telegram ryšius.
2 žingsnis: kaip pridėti AI botą į Telegram grupę?
Atverkite External Apps > Telegram, pridėkite bendrą botą į grupę ir Quickchat AI pasirinkite Confirm. Iki patvirtinimo Agentas grupėje tyli.
Narystė Telegram ir patvirtinimas Quickchat AI yra atskiri žingsniai.
- Agentų perjungiklyje pasirinkite Saltmarsh Group. Atverkite External Apps, pasirinkite Telegram ir raskite Quickchat AI bot.
- Pasirinkite Add to a Telegram group. Telegram pasirinkite
Saltmarsh Membersir leiskite pridėti botą. - Grįžkite į Quickchat AI. Skiltyje Waiting for your confirmation patikrinkite grupės pavadinimą ir Added by informaciją.
- Tinkamai grupei pasirinkite Confirm. Ji turėtų atsirasti Connected chats su įjungtu jungikliu.
- Telegram įrašykite
@ir pasirinkite botą iš paminėjimų sąrašo. PaklauskiteHow much is Start Sailing?. Bendro boto vardas paprastai yra@QuickchatAI_bot; naudokite tikrą grupėje rodomą vardą. - Tiesiogiai atsakykite į jo žinutę:
What should I bring?. Tada atskirai, be paminėjimo, siųskiteDoes anyone know the gate code?. Bendras botas turi atsakyti į pirmąją, bet ne į įprastą žinutę.
Telegram pasirinkite Saltmarsh Members, tada grįžkite į Quickchat AI ir patvirtinkite ryšį.
Tikra vietinė sąsaja su iš anksto sukurta testine grupe parodo Confirm vietą. Ji iliustruoja valdiklį, o ne įrodo prisijungimą prie gyvos Telegram grupės.
Patvirtinta grupė gavo laukiamą atsakymą apie kursą. Botą minėkite jo tikruoju naudotojo vardu.
Atsakant į boto žinutę nereikia jo dar kartą paminėti. Atsakyme išvardijami pateikti faktai apie įrangą.
Patvirtinimas svarbus, nes pakvietimo duomenys matomi grupėje. Prieš laikydama grupę Agento paskirties vieta, Quickchat AI reikalauja sprendimo paskyroje. Neatpažįstamos grupės netvirtinkite. Telegram ryšio dokumentacija paaiškina tą pačią ribą.
Prieš baigdami sąranką užbaikite patvirtinimą. Jei botas palieka nepatvirtintą grupę, sugeneruokite naują Add to a Telegram group nuorodą, pridėkite jį dar kartą ir iš karto patvirtinkite laukiančią grupę Quickchat AI. Boto pridėjimas per Telegram narių paiešką šio prijungimo proceso nepakeičia.
Admin ženklelis rodo boto statusą Telegram. Įprastiems bendro boto atsakymams jo nereikia. Administratoriaus teisės taip pat nepakeičia taisyklės atsakyti tik į paminėjimus ar atsakymus.
3 žingsnis: kaip įjungti privačius Telegram pokalbius?
Įjunkite Direct message link ir bendrinkite visą sugeneruotą URL. Nuoroda bendrame bote pasirenka jūsų Agentą, todėl klientas gali rašyti privačiai nepridėjęs boto į grupę.
Grupė yra bendras pokalbis. Asmeninius duomenis ir perdavimą darbuotojui perkelkite į privačias žinutes.
- Pasirinkite privatų Agentą Saltmarsh Sailing School. Skiltyje External Apps > Telegram įjunkite Direct message link. Grupės ryšius palikite tuščius.
- Nukopijuokite nuorodą. Išsaugokite
start=parametrą; paprasta bendro boto nuoroda jūsų Agento neidentifikuoja. - Atverkite ją Telegram ir, jei reikia, paspauskite Start.
- Nepaminėdami boto paklauskite
How much is Start Sailing?. Patikrinkite mokyklos atsakymą ir raskite pokalbį Inbox. - Prisekite nuorodą grupės pasisveikinimo žinutėje, kad nariai rastų ją prieš dalindamiesi asmenine informacija.
Naudokite savo Agentui sugeneruotą nuorodą. Rodoma vietinė sąranka neįrodo pristatymo į tikrą Telegram paskyrą.
Telegram pristatė Saltmarsh pasisveikinimą paspaudus Start. Toliau patikrinkite žiniomis pagrįstą atsakymą; vien pasisveikinimas nepatikrina informacijos paieškos.
Dvi to paties Telegram ekrano iškarpos rodo prisegtą kvietimą. Demonstracinės nuorodos start reikšmė praleista; prisekite savo visą sugeneruotą nuorodą.
Privatus pokalbis su bendru botu vienu metu susietas su vienu Agentu. Kito Agento nuoroda gali pakeisti susiejimą. Savo Telegram tapatybei ir atskirai pokalbio gijai naudokite savo boto kelią.
Išjungus Direct message link, užkertamas kelias naujiems ryšiams per nuorodą. Esamą pokalbį stabdykite jo jungikliu arba Disconnect. Tai viešas įėjimas, o ne konfidencialių žinių prieigos apribojimas.
4 žingsnis: kaip išsaugoti bandomosios pamokos užklausą Google Sheets?
Google Sheets integracija sukuria lentelę ir eilutės pridėjimo Action. Pritaikykite ją trims privalomiems užklausos laukams, tada patikrinkite tikrą eilutę. Šis neprivalomas žingsnis veikia su bendru Telegram botu.
Rezultatas yra žmogaus peržiūrai skirta užklausa. Ji nerezervuoja vietos ir nenustato bandomosios pamokos kainos.
Prijunkite Sheets ir nustatykite vieną Action
- Saltmarsh Sailing School atverkite Actions & MCPs > Add Action > Google Sheets ir pasirinkite Connect Google Sheets. Prisijunkite reikiama Google paskyra ir suteikite prašomą prieigą.
- Atverkite sukurtą Quickchat Leads lentelę. Palikite lapo pavadinimą Leads, nes į jį nukreiptas Action URL.
- Antraščių eilutę pakeiskite šia tvarka:
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - Actions & MCPs redaguokite sukurtą
log_lead_to_google_sheetAction pagal receptą. Parametrus, užklausos turinį ir lentelės antraštes keiskite kartu, kad sutaptų jų tvarka.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Šiai pamokos užklausai asmens nurodytas vardas. Jei trūksta, paklauskite. | Taip |
| Text | preferred_weekday | Pageidaujama savaitės diena, pavyzdžiui, antradienis. Tai pageidavimas, ne patvirtinta data. | Taip |
| Text | sailing_experience | Asmens nurodyta buriavimo patirtis, pavyzdžiui, pradedantysis. Jei trūksta, paklauskite; nespręskite patys. | Taip |
Visiems trims parametrams nustatykite No default ir pašalinkite numatytuosius el. pašto bei klausimo parametrus. Receptas klausia tik šių trijų dalykų. Telegram vartotojo vardas neprivalomas ir nėra patikimas privalomas kontaktas; pokalbio nuoroda leidžia darbuotojams grįžti prie užklausos.
Metodas ir URL: palikite sugeneruotą POST URL. Jame jau yra lentelės ID, Leads lapas ir valueInputOption=RAW. Jokio pakaitinio lentelės ID pildyti nereikia.
Antraštės: išlaikykite integracijos nustatymus.
| Antraštė | Reikšmė |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
API Endpoint kortelėje Body naudokite:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Su Add AI Data įterpkite parametrų ir pokalbio kintamuosius. Pirmos trys reikšmės gaunamos iš pokalbio, paskutines dvi pateikia 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.
Atverkite Advanced settings > Run only when ir pridėkite telegram_chat_type equals private. Naudokite paprastą metaduomenų raktą, be metadata_ ir riestinių skliaustų. Taip HTTP užklausa nebus siunčiama grupės žinutei, net jei modelis bandys. Vykdymo sąlygų dokumentacija paaiškina patikrą.
Response filter nustatykite į $.updates.updatedRows, kad Action grąžintų eilučių skaičių, o ne nereikalingą teikėjo atsakymą. Action palikite įjungtą.
Paprastas raktas yra telegram_chat_type. Sąlyga tikrinama prieš siunčiant užklausą.
Vietinė recepto sąranka. Sheets URL ir OAuth leidimą turi suteikti jūsų Google ryšys.
Patikrinkite eilutę, tada nepilną užklausą
Per Agento privačią Telegram nuorodą siųskite:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Patikrinkite tris vietas: atsakymas apibūdina užklausą, Inbox Action kortelė rodo pateiktas reikšmes, o tikrame Leads lape yra atitinkama eilutė. Nei užtikrintas atsakymas, nei aukštas Simulation balas neįrodo įrašymo į Google Sheets.
Agentas įrašė pateiktą vardą, pageidaujamą antradienį ir pradedančiojo patirtį. Laisvas vietas ir tikslią kainą dar turi patvirtinti biuras.
Dvi tos pačios išsaugotos eilutės dalys leidžia perskaityti visus penkis stulpelius. Su paskyra susieta pokalbio nuoroda paslėpta; kitos keturios reikšmės nepakeistos.
Atskirą testą pradėkite su I would like a trial lesson. Prieš vykdydamas Action, Agentas turi po vieną klausti trūkstamų laukų. Išbandykite ir How much is Start Sailing?; įprastas kurso klausimas neturi sukurti eilutės. Instrukcija prašo vieno įrašo vienai užklausai, bet receptas nėra pasikartojimų poveikį šalinanti rezervacijų sistema. Prieš praktinį naudojimą patikrinkite dublikatus.
5 žingsnis: kaip perduoti Telegram pokalbį žmogui?
Nustatykite Human Handoff, tada Inbox patikrinkite pokalbio priskyrimą. Instrukcija „administracija atsakys“ savaime neperduoda atsakomybės ir nepristabdo AI.
Patikros taškas yra priskyrimo pasikeitimas. Atvejį užbaigia žmogus; grąžinimą AI tikrinkite atskirai.
- Pasirinkite Saltmarsh Sailing School, atverkite Actions & MCPs > Human Handoff ir įjunkite. Saltmarsh Group šią Action palikite išjungtą.
- Handoff Rules pasirinkite +. Į Rule Name įrašykite
Private enquiries, į Description įklijuokitehandoff-rule.txtir įjunkite State. Naujos eilutės neaktyvios. Privataus Agento taisyklė apima grąžinimus, skundus, prašymą pasikalbėti su žmogumi ir žmogaus pagalbos priėmimą. - Išvalykite Keywords, išjunkite iš anksto nustatytas taisykles ir išsaugokite tik vieną aktyvią savo taisyklę. Grupę atskiria išjungtas Human Handoff kitame Agente; taisyklė nurodo, kada perduoda privatus Agentas.
- Confirmation nustatykite į
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Human Agents’ availability suderinkite su tikromis darbo valandomis ir pateikite sąžiningą pranešimą ne darbo metu. - Privačiame Telegram pokalbyje siųskite
I want a refund for last week. Can I speak to a person?. - Inbox raskite pokalbį, patikrinkite priskyrimą, pasirinkite Assign to me ir siųskite
Hi, I’m Alex from the office. I’ll review your request.Patikrinkite gavimą Telegram. - Kai pokalbį valdo žmogus, siųskite kitą kliento žinutę. AI turi tylėti. Operatorius turi užbaigti atvejį ir išspręsti jį Inbox. Grįžimą prie AI testuokite atskirai.
Savos taisyklės State įjungtas. Numatyti paleidikliai išjungti, todėl tikrinama viena taisyklė.
Tikra Telegram užklausa suaktyvino Handoff. Priskyrimas Inbox ir operatoriaus siunčiamas atsakymas patikrinti atskirai.
Per tikrą patikrą pokalbis perėjo į Unassigned ir buvo parengtas žmogui perimti. Operatorius pasirinko Assign to me, išsiuntė biuro atsakymą, o Telegram jį priėmė. Aukščiau esančioje nuotraukoje matomas perdavimo atsakymas; vėlesnės operatoriaus žinutės joje nėra. Kartodami testą tikrinkite ir priskyrimą, ir pristatymą.
Palikite šį atvejį operatoriui, kol jis bus išspręstas. Mūsų vietiniame pinigų grąžinimo teste grąžinimas į AI Agent leido pateikti vieną atsakymą, tada Handoff vėl suveikė. Grįžimui prie AI reikia atskiro sėkmingo tolesnio testo; tai nėra šio proceso užbaigimo kriterijus. Perdavimo žmogui vadove išsamiau aptariami darbuotojai ir atsakomybė.
6 žingsnis: kaip patikrinti visą Telegram botą?
Testing naudokite kartojamiems atsakymų testams; gyvą Telegram ir išorinius veiksmus tikrinkite atskirai. Modelis gali atsakyti teisingai, nors grupės ryšys, lentelės įrašas ar perdavimo pristatymas neveikia.
Tikrinkite už rezultatą atsakingą sistemą: žinias dėl faktų, Action žurnalus dėl užklausų, Sheets dėl eilučių ir Telegram dėl pristatymo.
Paleiskite kartojamą klausimų rinkinį
- Atverkite Testing, sukurkite rinkinį
Saltmarsh: knowledge checksir pasirinkite Paste messages. - Įklijuokite
simulation-messages.txt. Tarp atvejų išlaikykite atskirus---skirtukus. - Atverkite Evaluation criteria, įklijuokite rinkinio
evaluation-criteria.txtir išsaugokite. - Pasirinkite Run > Start Run, tada peržiūrėkite ir atsakymus, ir balus.
Keisdami vieną instrukciją, palikite tuos pačius klausimus prasmingam palyginimui.
Skaitykite atsakymus, ne tik balą. Tai vietiniai žinių, o ne Telegram pristatymo testai.
Vertintojui reikia mokyklos faktų tikslumui vertinti. Jis taip pat turi žinoti, kad išrašas neįrodo lentelės eilutės, Telegram pristatymo ar priskyrimo pasikeitimo. Įprasta tekstinė Simulation nepateikia Telegram metaduomenų, todėl jų nebuvimas nereiškia privataus pokalbio sąlygos gedimo. Kanalui priklausomus testus vykdykite tikrame privačiame pokalbyje.
Ką pakeitė vietiniai testai?
Pradiniame sprendime abu įėjimus aptarnavo vienas Agentas. Vietinis testas parodė, kad grupinis prašymas grąžinti pinigus perduoda bendrą pokalbį per Human Handoff. Atskyrėme Agentus ir grupės Agente išjungėme Handoff bei užklausų priėmimo Actions. Pakartojus grupines pinigų grąžinimo ir bandomosios pamokos patikras, atsakymai nukreipė į prisegtą privačią nuorodą, o pokalbis liko priskirtas AI. Todėl 1 žingsnyje šie du pokalbiai atskiriami ir nustatymais, ir instrukcijomis.
Visos dešimt galutinių vietinių žinių patikrų gavo po 5/5, o abu talpinami Agentai išlaikė tuos pačius dešimt atvejų. Šie nedideli testų rinkiniai nėra tikslumo produkcinėje aplinkoje įvertis. Tikra grupė taip pat atsakė į kurso kainos ir įrangos klausimus, o vėliau atsisakė patvirtinti hidrokostiumų nuomą. Pritaikydami rinkinį išsaugokite atvejus, kai trūksta faktų; vien teisingos kainos netikrina Agento gebėjimo susilaikyti nuo nepagrįstų atsakymų.
Trūkstant žinių atsakoma „negaliu patvirtinti“. Atskira vartų kodo žinutė nesikreipia į botą, o šioje nuotraukoje atsakymo į ją nematyti.
Tikra privati bandomosios pamokos užklausa sukėlė vieną sėkmingą Sheets Action iškvietimą su Alex Morgan, Tuesday ir beginner. Google grąžino HTTP 200 ir vieną atnaujintą eilutę; išsaugotoje eilutėje taip pat buvo pokalbio nuoroda ir telegram kanalas. Atskiras Action testas su grupės pokalbio metaduomenimis neišsiuntė HTTP užklausos. Pritaikydami sąlygą tikrinkite ir priimtą privačią užklausą, ir atmestą grupinį kontekstą.
Patikrinkite kanalą ir jo išorinius veiksmus
Savo stebėjimus rašykite į tuščią rinkinio test-matrix.csv. Aukščiau esančios nuotraukos rodo pademonstruotus rezultatus; lentelėje taip pat yra patikrų jūsų konfigūracijai. Testuodami tylą užrašykite praėjusį laiką ir žmogaus perėmimą vertinkite atskirai nuo galimo vėlesnio grįžimo prie AI.
| Testas | Žinutė arba veiksmas | Laukiamas rezultatas |
|---|---|---|
| Paminėjimas grupėje | @QuickchatAI_bot How much is Start Sailing? | Trumpas atsakymas su EUR 240; atitinkamas pokalbis Inbox. |
| Atsakymas botui | What should I bring? | Įrangos sąrašas be naujo paminėjimo. |
| Įprastas pokalbis | Does anyone know the gate code? be paminėjimo | Bendras botas neatsako. |
| Žinių spraga | Paminėkite botą ir paklauskite Do you rent wetsuits? | Negali patvirtinti; neišgalvoja taip ar ne. |
| Asmeninis prašymas grupėje | Paminėkite botą ir paprašykite grąžinti pinigus | Nukreipia privačiai; grupė lieka su AI. |
| Privatus atsakymas | Atverkite visą DM nuorodą ir paklauskite kainos | Tinkamas Agentas atsako be paminėjimo. |
| Pilna pamokos užklausa | Siųskite Alex Morgan žinutę iš 4 žingsnio | Action parametrai sutampa su tikra Sheets eilute; rezervacija nežadama. |
| Privatus perdavimas | Prašykite grąžinimo, po perėmimo parašykite dar kartą | Priskyrimas žmogui, operatoriaus pristatymas, jokio papildomo AI atsakymo. |
| Oro taisyklė | What happens if the forecast says 30 knots? | Nemokamas perkėlimas ir instruktoriaus sprendimas; jokios gyvos prognozės pretenzijos. |
Nepavykus testui keiskite vieną susijusį nustatymą ir kartokite tą pačią žinutę. Trūkstamą faktą taisykite Knowledge Base; per ankstyvą Action vykdymą apraše ar privalomuose parametruose; tylinčiai grupei pirmiausia tikrinkite patvirtinimą ir kreipinį. Nepavykusį rezultatą išsaugokite palyginimui.
Kada kurti savo botą su BotFather?
Savo botą kurkite, jei reikia savo vardo ir paveikslėlio, Telegram Bot API Actions arba įprastų grupės žinučių gavimo. Ankstesniems grupės ir privataus atsakymo būdams bendro boto pakanka.
Prieš pridėdami antrą botą pasirinkite tapatybę ir žinučių elgseną.
| Reikalavimas | Bendras Quickchat AI botas | Jūsų botas |
|---|---|---|
| BotFather žetono kūrimas | Nereikia | Reikia |
| Savas Telegram vardas ir paveikslėlis | Bendra tapatybė | Jūsų boto tapatybė |
| Atsakymai į grupės paminėjimus ir atsakymus | Taip | Taip, kai Telegram pristato |
| Įprastų grupės žinučių atsakymai | Bendras botas tyli | Nustatykite privatumą arba administratoriaus statusą |
| Privatūs pokalbiai | Agento start nuoroda bendrame bote | Savo boto privati gija |
| Google Sheets Action | Palaikoma | Palaikoma |
| Telegram moderavimo Actions | Bendras žetonas neatskleidžiamas | Savas žetonas pasiekiamas kaip System Token |
- Telegram atverkite patvirtintą BotFather paskyrą ir siųskite
/newbot. - Pasirinkite rodomą vardą, tada laisvą vartotojo vardą, pasibaigiantį
bot. BotFather pateiks žetoną. Laikykite jį paslaptyje. - Pasirinkite Saltmarsh Group, jei šį botą pridėsite prie grupės. Saltmarsh Sailing School naudokite tik privatiems pokalbiams. External Apps > Telegram atverkite Your own bot ir pasirinkite Connect to Telegram.
- Įklijuokite žetoną į Bot Token ir užbaikite prijungimą. Patikrinkite, ar Enable your own bot įjungtas.
- Atverkite boto Telegram nuorodą, siųskite
/start, tada tą patį klausimą apie kainą. - Įprastoms grupės žinutėms BotFather naudokite
/setprivacy, pasirinkite botą ir Disable, tada pašalinkite ir vėl pridėkite jį į testavimo grupę. Administratoriaus botas taip pat gauna įprastas žinutes. Telegram privatumo režimo dokumentacija paaiškina pristatymą.
Žetoną įklijuokite tik į Bot Token. Rodomas tuščias laukas, kad nebūtų paskelbta prisijungimo paslaptis.
Bendrą ir savo botą laikykite atskirose grupėse. Abu vienoje grupėje gali atsakyti dukart. Pranešimų prisegimui ar narių moderavimui naudokite Telegram grupės valdymo vadovą su tik administratoriams skirtomis Action sąlygomis.
Ar ChatGPT arba Claude gali padėti nustatyti Telegram botą?
Prijungta Quickchat AI paskyros valdymo programėlė gali kurti Agentą, pridėti žinias, nustatyti palaikomas parinktis ir paleisti testus. Jei klientas suteikia Telegram sąrankos galimybę, jis gali įjungti bendro boto privačių žinučių nuorodą. Grupės pasirinkimas ir patvirtinimas valdymo skydelyje lieka savininkui. Kai kuriuose klientuose privačios nuorodos įjungimui ir Human Handoff nustatymams taip pat reikia valdymo skydelio, todėl paprašykite asistento pirmiausia patikrinti turimus įrankius.
Prijunkite Quickchat AI ChatGPT papildinį arba Claude jungtį ir pateikite rinkinio failus su šia instrukcija:
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.
Įrankių prieinamumas priklauso nuo kliento ir paskyros teisių. Prisijungimą atlikite pagal paskyros valdymo sąrankos vadovą. Tai prijungia asistentą prie Quickchat AI paskyros; asmeninis ChatGPT ar Claude pokalbis netampa Telegram boto prieglobos serveriu.
Kodėl Telegram botas neatsako?
Prieš perrašydami instrukciją tikrinkite ryšį ir žinutės kelią. Šie simptomai turi skirtingas priežastis.
| Simptomas | Ką patikrinti |
|---|---|
| Grupė matoma, bet tyli | Patvirtinkite tinkamą grupę, įjunkite ją Connected chats ir paminėkite tikrą boto vardą arba atsakykite jo žinutei. |
| Botas išėjo prieš pirmą atsakymą | Sugeneruokite naują Add to a Telegram group nuorodą, pridėkite jį dar kartą ir iš karto pasirinkite Confirm prie laukiančios grupės Quickchat AI. |
| Paprasta boto nuoroda atveria netinkamą Agentą | Naudokite visą privačią nuorodą su start=. Patikrinkite, ar kito Agento nuoroda nepakeitė bendro pokalbio. |
| Po grąžinimo prašymo AI sustojo | Peržiūrėkite Inbox priskyrimą. Perduotas pokalbis lieka pristabdytas iki sąmoningo perpriskyrimo. |
| Sheets nėra eilutės | Patikrinkite įjungtą Action, visus laukus, privatų pokalbį ir URL į Leads. Peržiūrėkite Action vykdymą bei Google ryšį. |
| Savo botas praleidžia įprastas žinutes | Patikrinkite privatumą ir grupės teises; pakeitę privatumą pašalinkite ir vėl pridėkite botą. |
| Atsakymas nurodo nepateiktą datą ar paslaugą | Tikrinkite išsaugotas Ready žinias ir nežinojimo instrukciją. Pakartokite tikslų klaidingą klausimą. |
| Testai nebeatsako | Patikrinkite AI kreditus ir nepavykusią užklausą; išnaudotas limitas nevertina instrukcijos kokybės. |
Prieš kviesdami klientus pakeiskite išgalvotus faktus, peržiūrėkite grupinių ir privačių pokalbių atskyrimą ir paskirkite darbuotojus perdavimo eilei. Kaip galutinę paleidimo patikrą paprašykite kolegos iš kitos paskyros patikrinti viešus įėjimo taškus. Kitam bendruomenės kanalui Discord pokalbių boto vadovas siūlo panašų kūrimo ir testavimo kelią. Pokalbiams su personažais naudokite Telegram vaidmenų pokalbių vadovą.
Neprivalomos sąrankos patikros: Palyginkite diegimo būdus pagal nurodytus poreikius arba atsakymų kiekį pagal kreditų biudžetą su pateiktu biudžetu. Skaičiuoklės netikrina jūsų paskyros, svetainės ar likučio.
Kopijuojama Saltmarsh sąranka
Tai visi šiame vadove naudojami šaltinių faktai ir instrukcijos. Atsisiunčiamas rinkinys taip pat turi Action receptą, vertinimo kriterijus ir testus.
Grupės Agentas: Main Prompt
Įklijuokite į Saltmarsh Group skiltį Identity > Main Prompt. Human Handoff ir pasirinktines Actions palikite išjungtas.
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.
Privatus Agentas: Main Prompt
Įklijuokite į Saltmarsh Sailing School skiltį Identity > Main Prompt. Action pavadinimas turi atitikti receptą.
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.
Žinios: kursai ir bandomųjų pamokų užklausos
Įklijuokite į pirmojo žinių straipsnio Content lauką.
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.
Žinios: taisyklės ir informacija nariams
Įklijuokite į antrojo straipsnio Content lauką.
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 taisyklė
Įklijuokite į Human Handoff > Handoff Rules ir nustatykite tikrą darbuotojų prieinamumą.
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.
Dažniausiai užduodami klausimai
Kaip pridėti AI botą į Telegram grupę?
Quickchat AI atverkite External Apps, pasirinkite Telegram ir Add to a Telegram group. Telegram pasirinkite grupę, grįžkite į Quickchat AI ir patvirtinkite su Confirm. Nariai klausia paminėdami bendrą botą arba atsakydami į jo žinutę.
Ar Telegram AI botas atsako į kiekvieną žinutę?
Bendras Quickchat AI botas grupėje atsako į paminėjimus ir atsakymus jo žinutėms. Įprastas pokalbis atsakymo nesukelia. Savo botas gali gauti įprastas žinutes, kai Telegram privatumo režimas išjungtas arba botas yra administratorius. Tikrinkite tai atskiroje grupėje.
Ar reikia BotFather arba Telegram boto žetono?
Bendram botui ir jo privačiai nuorodai BotFather ar žetono nereikia. Savo botą kurkite su BotFather, kai reikia savo Telegram vardo, paveikslėlio arba Telegram Bot API naudojančių Actions. Įprastos Google Sheets Actions veikia su bendru botu.
Ar klientai gali rašyti Telegram botui privačiai?
Taip. Quickchat AI įjunkite Direct message link ir bendrinkite visą nuorodą. Klientas ją atveria ir, jei prašoma, spaudžia Start. Nuoroda bendrame bote pasirenka jūsų Agentą. Jos išjungimas sustabdo naujus ryšius; esami privatūs pokalbiai turi atskirus įjungimo ir atjungimo valdiklius.
Ar Telegram AI botas nemokamas?
Boto sukūrimas BotFather savaime nesuteikia AI paslaugos. Quickchat AI siūlo Free planą asmeniniam nekomerciniam mokymuisi su ribotais AI kreditais. Komerciniam naudojimui reikia mokamo plano. Atsakymai, Preview ir Simulation naudoja kreditus, o išorinės paslaugos gali kainuoti papildomai.
Ar Telegram yra AI botų?
Telegram palaiko trečiųjų šalių AI botus ir integracijas. Šis vadovas prijungia Quickchat AI Agentą, atsakantį iš jūsų įmonės žinių. BotFather sukuria boto tapatybę; jis nesuteikia žinių ir nenustato klientų aptarnavimo eigos.
Ar botas supranta nuotraukas ir failus?
Telegram integracija gali gauti nuotraukas ir analizuoti jų vaizdinį turinį. Kiti failai gali patekti kaip priedai, tačiau turinys automatiškai neskaitomas. Išbandykite klientų naudojamus failų tipus ir peržiūrėkite Telegram bei Inbox.
Ar galiu sukurti Telegram vaidmenų arba personažo botą?
Taip. Tas pats Telegram ryšys gali aptarnauti Agentą su personažo tapatybe ir tinkamomis instrukcijomis. Šis vadovas naudoja verslo pagalbos pavyzdį; vaidmenų Agentui reikia savo instrukcijos ir testų.