Egy Telegram AI chatbot a vállalkozásod tudásából válaszolhat csoportban vagy privát beszélgetésben. A Quickchat AI közös boton keresztül kapcsolja az Agentet a Telegramhoz: add hozzá a csoporthoz, erősítsd meg a kapcsolatot a kezelőfelületen, és a tagok megemlíthetik a botot a kérdésükben. Ehhez nem kell kód vagy BotFather-token.
Az útmutató a fiktív Saltmarsh Sailing School iskolát építi fel tagi csoporttal és privát érdeklődésekkel. Két Agent használja ugyanazokat az adatokat: a Saltmarsh Group nyilvános kérdésekre válaszol, a Saltmarsh Sailing School pedig privát próbaóra-kéréseket kezel, és visszatérítésnél embert von be. A kérés az irodának szóló érdeklődés, nem visszaigazolt foglalás.
Két Agent különíti el a felelősséget. A csoportos Agentnek nincs átadási vagy adatfelvételi Actionje; a privát Agent kezeli a kéréseket és az ügyintézők válaszait.
Kövesd az alábbi útvonalat. A Google Sheets-bővítés választható; először a válaszadást és az emberi átadást is befejezheted.
| Mit készítesz el? | Ellenőrzési pont |
|---|---|
| 1. Tudás és utasítások | Az Agent tudja a tanfolyam árát, és nem talál ki hiányzó tényeket. |
| 2. Csoportkapcsolat | Az említésre válaszol, a szokásos társalgásnál csendben marad. |
| 3. Privát chat | A teljes link a megfelelő Agent beszélgetését nyitja meg. |
| 4. Választható próbaóra-kérések | A kötelező adatok követhető táblázatsorrá alakulnak. |
| 5. Human Handoff | Ember veszi át a beszélgetést, az AI szünetel. |
| 6. Tesztelés | Külön ellenőrzöd a válaszokat, az irányítást és a külső hatásokat. |
Töltsd le a Saltmarsh Telegram-csomagot a pontos tudásanyaggal, Main Prompttal, Action-recepttel, értékelési szempontokkal és tesztüzenetekkel. Ezek szerkeszthető fájlok az alábbi lépésekhez, nem egykattintásos Agent-import. A mintafájlok, tesztüzenetek és képernyőképek angolul maradnak, hogy egyezzenek az ellenőrzött példával.
Mi kell egy Telegram chatbot elkészítéséhez?
Quickchat AI-fiók, két Agent és olyan Telegram-fiók kell, amely botot adhat a tesztcsoporthoz. A választható kérésrögzítéshez Google Sheets-hozzáférést engedélyező Google-fiók is szükséges.
- Hozz létre Quickchat AI-fiókot, és szükség esetén igazold az e-mail-címedet. A Free személyes, nem kereskedelmi tanulásra való. A csomagok Agentenként érvényesek, ezért mindkettő üzleti használatához megfelelő kereskedelmi csomag kell. A Preview és Simulation AI-kreditet fogyaszt. Nézd meg az aktuális csomagokat.
- Hozd létre a
Saltmarsh MembersTelegram-csoportot. Tesztcsoportban ellenőrizd az említéseket, a csendet és a folytatásokat, mielőtt ügyfeleket hívsz meg. - Az útmutatót a saját Telegram-fiókoddal kövesd, a látogatói üzeneteket is ebből küldd. A Quickchat AI Inboxát is kezelheted. Mielőtt ügyfeleket hívsz meg, kérj meg egy kollégát, hogy másik fiókból ellenőrizze az élményt.
- Csomagold ki a készletet. Az iskola mintatényeit tartsd együtt; élesítés előtt cseréld őket saját, ellenőrzött szabályokra.
A Quickchat App képernyőképei helyben futó alkalmazást mutatnak a fiktív Saltmarsh-konfigurációval; a képaláírások jelzik az előkészített kapcsolati tesztadatokat. A Telegram és a Google Sheets képei a csatlakoztatott demó valódi válaszait és mentett érdeklődését mutatják. A személyes fiókadatokat kivágtuk vagy egyértelműen eltakartuk. A záró ellenőrzőlistával ismételd meg a próbákat saját tudásanyagoddal és csatlakoztatott fiókjaiddal.
1. lépés: Hogyan tanítsd meg a Telegram chatbotnak a vállalkozásod tudását?
Az üzleti tényeket a Knowledge Base, a működési utasításokat a Main Prompt tartalmazza. Így könnyebb egy választ javítani az Agent viselkedésének megváltoztatása nélkül.
Az árak és szabályok forrástények. A tömörség, bizonytalanság és irányítás utasítás.
Hozd létre az Agentet, és add hozzá a tudást
- Új fiókban válaszd a Set up manually lehetőséget. Meglévőben előbb Add new AI Agent, majd kézi beállítás következik.
- Az Identity oldalon a Name your AI Agent mezőbe írd:
Saltmarsh Group. A csomaggroup-main-prompt.txttartalmát illeszd a Describe what you want your agent to do mezőbe. - Külső alkalmazások csatlakoztatása nélkül folytasd. Fejezd be a csomagválasztást; tanulási fióknál használhatod a Skip for now lehetőséget.
- Nyisd meg: Knowledge Base > Add Article. A Create custom article mezőbe írd:
Courses and trial enquiries, majd Create article. Illeszd asaltmarsh-courses.txttartalmát a Content mezőbe, és válaszd a Save gombot. - Ismételd meg a
Weather, parking and personal enquiriescikkel, asaltmarsh-policies.txtfájllal. Várd meg, hogy mindkét cikk Ready legyen. - A Saltmarsh Group Agentnél nyisd meg az Actions & MCPs oldalt. A Human Handoff maradjon kikapcsolva, és ne adj hozzá próbaóra-kérési Actiont.
- Válaszd az Add new AI Agent lehetőséget, és ismételd meg a kézi beállítást a
Saltmarsh Sailing SchoolAgenthez amain-prompt.txtés ugyanazon két tudásfájl használatával. Ez a második Agent kezeli a privát beszélgetéseket. Módosítás előtt a fiókváltóban válaszd ki a megfelelő Agentet.
Két rövid forrás egyértelművé teszi, mit tud az Agent. Tudásteszt előtt ellenőrizd a Ready állapotot.
| Tudás | A példában használt pontos tények |
|---|---|
| Tanfolyamok | Start Sailing: két nap, EUR 240. Day Skipper theory: öt este, EUR 310. Magánóra: 90 perc, EUR 95. |
| Időpontok | Áprilistól októberig tartó szezon; az időpontokat egy hónappal korábban teszik közzé. Nincs élő szabadhelyadat vagy következő időpont. |
| Felszerelés | Vízálló kabát, nyomot nem hagyó cipő és váltóruha. Az iskola biztosítja az úszást segítő mellényeket. |
| Időjárás | 25 csomó feletti szél vagy zivatar: ingyenes áthelyezés a következő szabad időpontra. Az oktató aznap reggel dönt. |
| Parkolás | A klubháznál ingyenes. A kapukódot előző nap küldik el; maga a kód nincs megadva. |
| Próbaóra-kérések | Név, választott hétköznap és vitorlázási tapasztalat szükséges. A szabad helyet és árat az iroda igazolja vissza. |
A neoprénruha-kölcsönzés szándékosan hiányzik. Az Agentnek azt kell mondania, hogy nem tudja megerősíteni, nem pedig igent vagy nemet kitalálnia. Az időjárási szabály sem ad mai előrejelzést; a magánóra ára pedig nem határozza meg a próbaóra árát.
Állítsd be a Main Promptot, és ellenőrizz egy választ
- Mindkét Agentnél nyisd meg az Identity > Main Prompt részt, és ellenőrizd a megfelelő Saltmarsh-promptot. A csoportos prompt általános kérdésekre válaszol és a rögzített privát linkhez irányít; a privát prompt kéréseket gyűjt és Human Handoffot használ.
- Az AI Preview felületen kérdezd:
How much is Start Sailing?. Ellenőrizd a két napot és EUR 240 árat. - Kérdezd:
Do you rent wetsuits?. A válasznak el kell ismernie az információ hiányát.
A privát Agent promptja az adatfelvételt és átadást írja le. A csoportos Agent külön promptot használ; mindkét Actionje ki van kapcsolva.
Két részlet a csoportos Agent valódi beállításaiból. Tudáskérdésekre válaszolhat, de nincs futtatható adatfelvételi vagy átadási Actionje.
Két Agent egyértelművé teszi az irányítást. A csoportos nem indíthat véletlen átadást; a privát a csoport leállítása nélkül továbbíthat visszatérítési kérést. A Preview az iskola tényeit, a következő lépések a Telegram-kapcsolatokat ellenőrzik.
2. lépés: Hogyan adj AI chatbotot egy Telegram-csoporthoz?
Nyisd meg az External Apps > Telegram oldalt, add a közös botot a csoporthoz, majd a Quickchat AI-ban válaszd a Confirm lehetőséget. Az Agent az igazolásig csendben marad a csoportban.
A Telegram-tagság és a Quickchat AI megerősítése külön lépés.
- Válaszd a Saltmarsh Group Agentet. Nyisd meg az External Apps oldalt, válaszd a Telegram lehetőséget, és keresd a Quickchat AI bot részt.
- Válaszd az Add to a Telegram group gombot. Telegramban jelöld ki a
Saltmarsh Memberscsoportot, és engedélyezd a bot hozzáadását. - Térj vissza a Quickchat AI-ba. A Waiting for your confirmation alatt ellenőrizd a csoport nevét és az Added by adatot.
- A megfelelő csoportnál kattints a Confirm gombra. A csoport a Connected chats részbe kerül, bekapcsolt állapotban.
- Telegramban írj
@jelet, és válaszd ki a botot az említési listából. Kérdezd:How much is Start Sailing?. A közös bot neve általában@QuickchatAI_bot; a csoportban megjelenő tényleges nevet használd. - Közvetlenül a válaszára írd:
What should I bring?. Ezután külön, említés nélkül küldd:Does anyone know the gate code?. A közös bot az elsőre válaszoljon, a szokásos üzenetnél maradjon csendben.
Válaszd a Saltmarsh Members csoportot a Telegramban, majd térj vissza a Quickchat AI-ba a kapcsolat megerősítéséhez.
Valódi helyi felület előre létrehozott tesztcsoporttal, a Confirm helyét mutatva. Ez a vezérlőt szemlélteti, nem élő Telegram-csatlakozást bizonyít.
A megerősített csoport megkapta a várt kurzusválaszt. A botot a tényleges felhasználónevével említsd.
A bot üzenetére válaszolva újabb említés nélkül is kapsz választ. A válasz a megadott felszerelési tudnivalókat sorolja fel.
A megerősítés fontos, mert a meghívás adatai megjelennek a csoportban. A Quickchat AI fiókon belüli döntést kér, mielőtt a csoportot az Agent céljaként használja. Ismeretlen csoportot ne igazolj vissza. A Telegram-kapcsolat dokumentációja ugyanezt a határt magyarázza.
Fejezd be a megerősítést, mielőtt elhagyod a beállítást. Ha a bot kilép egy meg nem erősített csoportból, hozz létre új Add to a Telegram group linket, add hozzá újra, és azonnal erősítsd meg a várakozó csoportot a Quickchat AI-ban. A bot hozzáadása a Telegram tagkeresőjén keresztül nem helyettesíti ezt a kapcsolódási folyamatot.
Az Admin jelvény a bot Telegram-státuszát mutatja. A közös bot szokásos válaszaihoz nem szükséges. A rendszergazdai szerep sem változtatja meg az említésre vagy közvetlen válaszra korlátozott működést.
3. lépés: Hogyan engedélyezd a privát Telegram-beszélgetéseket?
Kapcsold be a Direct message link lehetőséget, és oszd meg a teljes létrehozott URL-t. A link a közös boton belül kiválasztja az Agentedet; az ügyfél csoporthoz adás nélkül írhat privátban.
A csoport közös beszélgetés. A személyes adatokat és emberi átadást vidd privát üzenetekbe.
- Válaszd a privát Saltmarsh Sailing School Agentet. Az External Apps > Telegram oldalon kapcsold be a Direct message link lehetőséget. Csoportkapcsolatai maradjanak üresek.
- Másold ki a létrehozott linket. Tartsd meg a
start=paramétert; a közös bot egyszerű linkje nem azonosítja az Agentet. - Nyisd meg Telegramban, és szükség esetén nyomd meg a Start gombot.
- Említés nélkül kérdezd:
How much is Start Sailing?. Ellenőrizd az iskola válaszát, és keresd meg a beszélgetést az Inbox felületén. - Rögzítsd a linket a csoport üdvözlőüzenetében, hogy a tagok személyes adatok megadása előtt megtalálják.
A saját Agentedhez létrehozott linket használd. A helyi beállítás nem élő Telegram-kézbesítési bizonyíték.
A Telegram a Start után kézbesítette a Saltmarsh üdvözlését. Ezután ellenőrizz egy tudásalapú választ; a köszöntés önmagában nem teszteli az információkeresést.
Ugyanazon Telegram-képernyő két kivágott részlete mutatja a kitűzött meghívást. A demólink start értékét kihagytuk; a saját teljes, generált linkedet tűzd ki.
A közös bot privát beszélgetése egyszerre egy Agenthez kötődik. Más Agent privát linkje átválthatja ezt a kapcsolatot. Saját Telegram-identitáshoz és önálló beszélgetésszálhoz válaszd a saját bot útvonalát.
A Direct message link kikapcsolása az új kapcsolódásokat tiltja. Meglévő chat leállításához annak kapcsolóját vagy a Disconnect lehetőséget használd. A link nyilvános belépési pont, nem bizalmas tudás hozzáférési korlátja.
4. lépés: Hogyan ments próbaóra-kérést Google Sheetsbe?
A Google Sheets-integráció táblázatot és sorhozzáadó Actiont készít. Alakítsd át három kötelező kérési mezőre, majd ellenőrizd a valódi sort. Ez választható lépés, és a közös Telegram-bottal is működik.
Az eredmény ember által követendő kérés. Nem foglal helyet és nem határozza meg a próbaóra árát.
Kapcsold a Sheetset, és állíts be egy Actiont
- A Saltmarsh Sailing School Agentnél nyisd meg az Actions & MCPs > Add Action > Google Sheets részt, majd Connect Google Sheets. Jelentkezz be a megfelelő Google-fiókba, és engedélyezd a kért hozzáférést.
- Nyisd meg a létrehozott Quickchat Leads táblázatot. A Leads munkalap neve maradjon meg, mert az Action URL-je erre mutat.
- A fejléc sorrendben legyen:
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - Az Actions & MCPs oldalon szerkeszd a létrehozott
log_lead_to_google_sheetActiont az alábbi recept szerint. A paramétereket, kérés törzsét és táblázatfejléceket együtt módosítsd, hogy a sorrendjük egyezzen.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | A jelentkező által a próbaóra-kéréshez megadott név. Ha hiányzik, kérdezz rá. | Igen |
| Text | preferred_weekday | A választott hétköznap, például kedd. Ez preferencia, nem visszaigazolt időpont. | Igen |
| Text | sailing_experience | A jelentkező által közölt vitorlázási tapasztalat, például kezdő. Ha hiányzik, kérdezz; ne következtess rá. | Igen |
Mindhárom paraméternél No default legyen; töröld az alapértelmezett e-mail- és kérdésparamétereket. A recept csak e három adatot kéri. A Telegram-felhasználónév opcionális, ezért nem megbízható kötelező elérhetőség; a beszélgetés linkje lehetővé teszi a folytatást a személyzetnek.
Módszer és URL: tartsd meg a generált POST URL-t. Már tartalmazza a táblázat azonosítóját, a Leads munkalapot és a valueInputOption=RAW értéket. Nincs kitöltendő helyőrző azonosító.
Fejlécek: őrizd meg az integráció beállítását.
| Fejléc | Érték |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
Az API Endpoint Body lapján használd:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Az Add AI Data segítségével illeszd be a paramétereket és beszélgetésváltozókat. Az első három érték a beszélgetésből, az utolsó kettő a Quickchat AI-tól érkezik.
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.
Az Advanced settings > Run only when alatt add hozzá: telegram_chat_type equals private. A puszta metaadatkulcsot használd, metadata_ előtag és kapcsos zárójelek nélkül. Ez csoportos üzenetnél akkor is megakadályozza a HTTP-kérést, ha a modell próbálkozna. A futtatási feltételek dokumentációja ismerteti az ellenőrzést.
A Response filter legyen $.updates.updatedRows, így az Action a sorok számát adja vissza a szükségtelen szolgáltatói válasz helyett. Az Action maradjon bekapcsolva.
A puszta kulcs telegram_chat_type. A feltételt a kérés elküldése előtt ellenőrzi a rendszer.
A recept helyi beállítása. A Sheets URL-jének és az OAuth-jóváhagyásnak saját Google-kapcsolatodból kell származnia.
Ellenőrizd a sort, majd a hiányos kérést
Az Agent privát Telegram-linkjén küldd el:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Három helyet vizsgálj: a válasz kérésről beszéljen, az Inbox Action-kártyája mutassa az adatokat, a valódi Leads munkalapon pedig legyen egyező sor. Megnyugtató válasz vagy magas Simulation-pontszám nem bizonyítja a Google Sheets-írást.
Az Agent rögzítette a megadott nevet, a keddi preferenciát és a kezdő tapasztalatot. Az elérhetőséget és a pontos árat még az irodának kell megerősítenie.
Ugyanannak a mentett sornak két részlete mind az öt oszlopot olvashatóvá teszi. A fiókhoz tartozó beszélgetési linket eltakartuk; a másik négy érték változatlan.
Külön tesztként küldd: I would like a trial lesson. Az Action előtt az Agent egyenként kérje a hiányzó adatokat. Próbáld ezt is: How much is Start Sailing?; általános tanfolyamkérdés nem hozhat létre sort. A prompt kérésenként egy írást kér, de a recept nem ismétlésbiztos foglalási rendszer. Üzemi használat előtt vizsgáld a duplikációkat.
5. lépés: Hogyan adj át Telegram-beszélgetést egy embernek?
Állítsd be a Human Handoff funkciót, majd ellenőrizd a beszélgetés hozzárendelését az Inbox felületén. Az „iroda válaszol majd” utasítás önmagában nem adja át a felelősséget és nem szünetelteti az AI-t.
A hozzárendelés változása az ellenőrzési pont. Az ember fejezze be az ügyet; az AI-hoz visszatérést külön teszteld.
- Válaszd a Saltmarsh Sailing School Agentet, nyisd meg az Actions & MCPs > Human Handoff részt, és kapcsold be. A Saltmarsh Group esetében maradjon kikapcsolva.
- A Handoff Rules alatt válaszd a + gombot. A Rule Name legyen
Private enquiries; a Description mezőbe illeszd ahandoff-rule.txttartalmát, és kapcsold be a State értéket. Az új sorok inaktívak. A szabály a privát Agent visszatérítéseire, panaszaira, emberkéréseire és a felajánlott segítség elfogadására vonatkozik. - Töröld a Keywords tartalmát és kapcsold ki az előre megadott szabályokat. Ments egyetlen aktív saját szabállyal. A csoportot a külön Agent kikapcsolt Human Handoffja választja el; a szabály a privát átadás feltételeit írja le.
- A Confirmation értéke legyen
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.A Human Agents’ availability a valódi ügyeleti időt kövesse; munkaidőn kívül valós tájékoztatás jelenjen meg. - A privát Telegram-chatből küldd:
I want a refund for last week. Can I speak to a person?. - Az Inbox felületén keresd meg a beszélgetést, ellenőrizd a hozzárendelést, válaszd a Assign to me lehetőséget, és küldd:
Hi, I’m Alex from the office. I’ll review your request.Ellenőrizd, hogy megérkezik Telegramba. - Küldj új ügyfélüzenetet, amíg emberé a beszélgetés. Az AI maradjon csendben. Az operátor fejezze be és oldja meg az ügyet az Inboxban. Az AI-hoz visszatérés külön teszt.
A saját szabály State értéke aktív. Az előre megadott indítók ki vannak kapcsolva; egy szabályt kell vizsgálni.
Az élő Telegram-kérés elindította a Handoffot. Az Inbox hozzárendelését és az operátor kimenő válaszát külön ellenőriztük.
Az élő ellenőrzésben a beszélgetés Unassigned állapotba került, készen arra, hogy egy munkatárs átvegye. Az operátor az Assign to me lehetőséget választotta, elküldte az iroda válaszát, a Telegram pedig elfogadta azt. A fenti kép az átadáskor küldött választ mutatja; a későbbi operátori üzenetet nem. A teszt ismétlésekor a hozzárendelést és a kézbesítést is ellenőrizd.
A megoldásig maradjon az operátornál az ügy. Helyi visszatérítési tesztünkben az AI Agent újbóli kiválasztása egy választ engedett, majd ismét elindult a Handoff. Az AI-hoz való visszatérés külön sikeres utótesztet igényel; nem része e munkafolyamat teljesítési feltételeinek. Az emberi átadás útmutatója részletesebben tárgyalja a személyzetet és a felelősséget.
6. lépés: Hogyan teszteld a teljes Telegram chatbotot?
A Testing ismételhető válaszellenőrzésre való; az élő Telegram-útvonalakat és külső hatásokat külön vizsgáld. A modell akkor is válaszolhat helyesen, ha a csoportkapcsolat, táblázatírás vagy átadás kézbesítése hibás.
A megfelelő rendszert ellenőrizd: tényekhez a tudást, kérésekhez az Action-naplót, sorokhoz a Sheetset, kézbesítéshez a Telegramot.
Futtass ismételhető kérdéssort
- Nyisd meg a Testing részt, hozz létre
Saltmarsh: knowledge checksnevű adatkészletet, és válaszd a Paste messages lehetőséget. - Illeszd be a
simulation-messages.txttartalmát. Tartsd meg az esetek közötti önálló---elválasztókat. - Az Evaluation criteria alatt illeszd be a csomag
evaluation-criteria.txtfájlját, és mentsd el. - Válaszd a Run > Start Run lehetőséget, majd a pontszám mellett az egyes válaszokat is nézd át.
Egy utasítás módosításakor tartsd meg a kérdéseket, hogy az összehasonlítás használható maradjon.
Olvasd el a válaszokat is. Ezek helyi tudástesztek, nem Telegram-kézbesítési tesztek.
Az értékelőnek szüksége van az iskola tényeire a pontosság megítéléséhez. Tudnia kell azt is, hogy a leirat nem bizonyít táblázatsort, Telegram-kézbesítést vagy hozzárendelés-változást. A szokásos szöveges Simulation nem ad Telegram-metaadatot; ennek hiánya nem a csak privát chatet engedélyező feltétel hibája. A csatornafüggő ellenőrzéseket a tényleges privát chatben végezd.
Mit változtattak meg a helyi tesztek?
Az eredeti megoldás mindkét belépési ponthoz egy Agentet használt. Egy helyi tesztben a csoportos visszatérítési kérés Human Handoffra adta a közös beszélgetést. Különválasztottuk az Agenteket, és a csoport Agentjénél kikapcsoltuk a Handoffot és az érdeklődések rögzítésére szolgáló Actionöket. A csoportos visszatérítési és próbaórás ellenőrzések megismétlése ezután a rögzített privát linkhez irányított, miközben a beszélgetés az AI-nál maradt. Ezért az 1. lépés beállításokkal és utasításokkal is elkülöníti a két beszélgetést.
A tíz végső helyi tudásteszt mindegyike 5/5 pontot kapott, és mindkét hosztolt Agent teljesítette ugyanezt a tíz esetet. Ezek a kis tesztsorozatok nem becsülik meg az éles pontosságot. Az élő csoport a kurzus árára és a felszerelésre is válaszolt, majd nem erősítette meg a neoprénruha-kölcsönzést. A csomag átalakításakor tartsd meg a hiányzó tényeket vizsgáló eseteket; a helyes árak önmagukban nem tesztelik az Agent visszafogottságát.
Hiányzó tudás esetén a válasz „nem tudom megerősíteni”. A külön kapukódüzenet nem szólítja meg a botot, és ezen a képen nem látható rá válasz.
Az élő privát próbaórakérés egy sikeres Sheets Action-hívást eredményezett Alex Morgan, Tuesday és beginner értékekkel. A Google HTTP 200-at és egy frissített sort adott vissza; a mentett sor a beszélgetési linket és a telegram csatornát is tartalmazta. Egy külön, csoportos chatmetaadatokkal végzett Action-teszt nem küldött HTTP-kérést. A feltétel módosításakor az elfogadott privát kérést és az elutasított csoportos környezetet is ellenőrizd.
Ellenőrizd a csatornát és a mellékhatásokat
Saját megfigyeléseidet a csomag üres test-matrix.csv fájljában rögzítsd. A fenti képek a bemutatott eredményeket mutatják; a táblázat a saját beállításaiddal elvégzendő ellenőrzéseket is tartalmazza. A hallgatás tesztelésekor jegyezd fel az eltelt időt, és az emberi átvételt kezeld külön a későbbi AI-visszaadástól.
| Teszt | Üzenet vagy művelet | Várt eredmény |
|---|---|---|
| Csoportos említés | @QuickchatAI_bot How much is Start Sailing? | Tömör válasz EUR 240 árral; egyező Inbox-párbeszéd. |
| Válasz a botnak | What should I bring? | Felszereléslista új említés nélkül. |
| Szokásos társalgás | Does anyone know the gate code? említés nélkül | A közös bot nem válaszol. |
| Tudáshiány | Említsd a botot, és kérdezd: Do you rent wetsuits? | Nem tudja megerősíteni; nincs kitalált igen vagy nem. |
| Személyes kérés a csoportban | Említsd a botot, és kérj visszatérítést | Privát chathez irányít; a csoport az AI-nál marad. |
| Privát válasz | Nyisd meg a teljes DM-linket, és kérdezd az árat | A megfelelő Agent említés nélkül válaszol. |
| Teljes próbaóra-kérés | Küldd el a 4. lépés Alex Morgan-üzenetét | Az Action adatai egyeznek a valódi sorral; nincs foglalási állítás. |
| Privát átadás | Kérj visszatérítést, majd átvétel után írj újra | Emberhez rendelés, operátori kézbesítés, további AI-válasz nélkül. |
| Időjárási szabály | What happens if the forecast says 30 knots? | Ingyenes áthelyezés és oktatói döntés; élő előrejelzés állítása nélkül. |
Sikertelen ellenőrzésnél egy releváns beállítást változtass, és ugyanazt az üzenetet ismételd. Hiányzó tényt a Knowledge Base-ben, korai Actiont a leírásban vagy kötelező paramétereknél javíts; csendes csoportnál először a jóváhagyást és megszólítást vizsgáld. A hibás eredményt tartsd meg az összehasonlításhoz.
Mikor készíts saját botot a BotFatherrel?
Saját bot kell saját névhez és képhez, Telegram Bot API Actionökhöz vagy a szokásos csoportüzenetek fogadásához. A fent bemutatott csoportos és privát válaszadáshoz elég a közös bot.
Második bot hozzáadása előtt válaszd ki a szükséges identitást és üzenetkezelést.
| Követelmény | Közös Quickchat AI bot | Saját bot |
|---|---|---|
| BotFather-token létrehozása | Nem szükséges | Szükséges |
| Saját Telegram-név és kép | Közös identitás | Saját botidentitás |
| Csoportemlítések és válaszok kezelése | Igen | Igen, ha a Telegram kézbesíti |
| Szokásos csoportüzenetek megválaszolása | A közös bot csendben marad | Telegram-adatvédelem vagy adminjog beállítása |
| Privát beszélgetések | Agent-specifikus start link a közös botban | A saját bot privát beszélgetése |
| Google Sheets Action | Támogatott | Támogatott |
| Telegram-moderálási Actionök | A közös token nem hozzáférhető | Saját token System Tokenként elérhető |
- Telegramban nyisd meg az ellenőrzött BotFather fiókot, és küldd:
/newbot. - Válassz megjelenítési nevet, majd
botvégű szabad felhasználónevet. A BotFather tokent ad; tartsd titokban. - Válaszd a Saltmarsh Group Agentet, ha ezt a botot csoporthoz adod. A Saltmarsh Sailing School Agentet kizárólag privát beszélgetésekhez használd. Az External Apps > Telegram oldalon nyisd meg a Your own bot részt, majd Connect to Telegram.
- Illeszd a tokent a Bot Token mezőbe, és fejezd be a kapcsolódást. Az Enable your own bot legyen bekapcsolva.
- Nyisd meg a bot Telegram-linkjét, küldd a
/startparancsot, majd ugyanazt az árkérdést. - Szokásos csoportüzenetekhez a BotFatherben használd a
/setprivacyparancsot, válaszd a botot és a Disable lehetőséget, majd távolítsd el és add újra a tesztcsoporthoz. Adminbot is megkapja ezeket az üzeneteket. A Telegram adatvédelmi dokumentációja ismerteti a kézbesítési szabályokat.
A tokent csak a Bot Token mezőbe illeszd. Az üres mező biztosítja, hogy ne jelenjen meg hitelesítő adat.
A közös és saját botot külön csoportokban tartsd. Egy csoportban duplikált válaszokat adhatnak. Közlemények rögzítéséhez vagy moderáláshoz kövesd a Telegram-csoportkezelési útmutatót, az adminokra korlátozott Action-feltételekkel együtt.
Segíthet a ChatGPT vagy Claude a Telegram chatbot beállításában?
A csatlakoztatott Quickchat AI fiókkezelő alkalmazás Agentet készíthet, tudást adhat hozzá, támogatott beállításokat módosíthat és teszteket futtathat. Ha a kliens elérhetővé teszi a Telegram beállítását, bekapcsolhatja a közös bot privát üzenetlinkjét. A csoport kiválasztása és az irányítópulton történő jóváhagyás a tulajdonos feladata marad. Egyes klienseknél a privát link aktiválásához és a Human Handoff beállításához is az irányítópult kell, ezért az asszisztens először ellenőrizze az elérhető eszközeit.
Kapcsold a Quickchat AI ChatGPT-bővítményt vagy a Claude-csatlakozót, majd add át a csomag fájljait ezzel a prompttal:
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.
Az eszközök elérhetősége kliens- és jogosultságfüggő. A bejelentkezéshez kövesd a fiókkezelés beállítási leírását. Ez az asszisztenst a Quickchat AI-fiókhoz kapcsolja; a személyes ChatGPT- vagy Claude-beszélgetésből nem készít Telegram-botot kiszolgáló háttérrendszert.
Miért nem válaszol a Telegram chatbot?
A prompt átírása előtt ellenőrizd a kapcsolatot és az üzenet útját. Az alábbi tüneteknek különböző okuk van.
| Tünet | Ellenőrzés |
|---|---|
| A csoport látható, de csendes | Igazold a megfelelő csoportot, kapcsold be a Connected chats alatt, és említsd a valódi botnevet vagy válaszolj az üzenetére. |
| A bot az első válasza előtt kilépett | Hozz létre új Add to a Telegram group linket, add hozzá újra, és azonnal válaszd a Confirm lehetőséget a várakozó csoportnál a Quickchat AI-ban. |
| Az egyszerű botlink rossz Agentet nyit | A teljes privát linket használd, a start= paraméterrel. Ellenőrizd, hogy más Agent linkje nem váltotta-e át a közös chatet. |
| Az AI visszatérítési kérés után leállt | Nézd meg az Inbox-hozzárendelést. Az átadott beszélgetés szándékos újrarendelésig szünetel. |
| Nincs sor a Sheetsben | Ellenőrizd az aktív Actiont, a kötelező mezőket, a privát chatet és a Leadsre mutató URL-t. Nézd át a hívást és a Google-kapcsolatot. |
| Saját bot nem kap szokásos üzeneteket | Ellenőrizd az adatvédelmet és csoportjogokat; módosítás után távolítsd el és add újra a botot. |
| A válasz nem megadott dátumot vagy szolgáltatást állít | Vizsgáld a mentett Ready tudást és a bizonytalansági utasítást. Ismételd a pontos hibás kérdést. |
| A tesztek nem válaszolnak | Nézd meg az AI-krediteket és a sikertelen kérést; a keret kimerülése nem a prompt minőségét méri. |
Ügyfelek meghívása előtt cseréld ki a fiktív tényeket, ellenőrizd a csoportos és privát beszélgetések elkülönítését, és biztosíts munkatársat az átadási sorhoz. Utolsó indulási ellenőrzésként kérj meg egy kollégát, hogy másik fiókból próbálja ki a nyilvános belépési pontokat. Más közösségi csatornához a Discord chatbot útmutató hasonló építési és tesztelési folyamatot mutat. Karakterbeszélgetésekhez a Telegram roleplay útmutatót használd.
Választható beállításellenőrzések: Hasonlítsd össze a telepítési módokat a megadott igényekkel, vagy a kreditkeretből elérhető válaszokat a megadott kerettel. A kalkulátorok nem vizsgálják a fiókodat, webhelyedet vagy egyenlegedet.
Másolható Saltmarsh-beállítás
Ezek az útmutató teljes forrástényei és utasításai. A letöltés az Action-receptet, értékelési szempontokat és teszteket is tartalmazza.
Csoportos Agent: Main Prompt
Illeszd a Saltmarsh Group Identity > Main Prompt mezőjébe. A Human Handoff és az egyéni Actionök maradjanak kikapcsolva.
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.
Privát Agent: Main Prompt
Illeszd a Saltmarsh Sailing School Identity > Main Prompt mezőjébe. Az Action neve egyezzen a recepttel.
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.
Tudás: tanfolyamok és próbaóra-kérések
Illeszd az első tudáscikk Content mezőjébe.
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.
Tudás: szabályok és tagi információk
Illeszd a második cikk Content mezőjébe.
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-szabály
Illeszd a Human Handoff > Handoff Rules alá, és állítsd be a valódi rendelkezésre állást.
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.
Gyakori kérdések
Hogyan adhatok AI chatbotot egy Telegram-csoporthoz?
Quickchat AI-ban nyisd meg az External Apps részt, válaszd a Telegramot és az Add to a Telegram group lehetőséget. Telegramban válaszd ki a csoportot, majd Quickchat AI-ban Confirm segítségével igazold. A tagok a közös bot említésével vagy üzenetére válaszolva kérdezhetnek.
Minden üzenetre válaszol a Telegram AI chatbot?
A közös Quickchat AI bot a csoportban említésekre és a saját üzeneteire adott válaszokra reagál. A szokásos társalgás nem indít választ. Saját bot kikapcsolt Telegram-adatvédelmi móddal vagy adminként szokásos üzeneteket is kaphat. Ezt külön csoportban teszteld.
Szükségem van BotFatherre vagy Telegram-bottokenre?
A közös bothoz és privát linkjéhez nem kell BotFather vagy token. Saját Telegram-névhez és képhez, illetve Telegram Bot API-t hívó Actionökhöz készíts saját botot BotFatherrel. A szokásos Google Sheets Actionök a közös bottal is működhetnek.
Írhatnak az ügyfelek privátban a Telegram chatbotnak?
Igen. Kapcsold be a Direct message link lehetőséget a Quickchat AI-ban, és oszd meg a teljes létrehozott linket. Az ügyfél megnyitja, és szükség esetén Startot nyom. A link a közös botban kiválasztja az Agentedet. Kikapcsolása az új kapcsolódást tiltja; a meglévő privát chateknek külön aktiválási és leválasztási vezérlőjük van.
Ingyenes a Telegram AI chatbot?
A BotFatherben készített bot önmagában nem ad AI-szolgáltatást. A Quickchat AI Free csomagja személyes, nem kereskedelmi tanulásra való, korlátozott AI-kredittel. Üzleti használathoz fizetős csomag kell. A válaszok, Preview és Simulation kreditet fogyasztanak; a külső szolgáltatásoknak saját díjuk lehet.
Vannak AI chatbotok a Telegramban?
A Telegram támogat külső AI botokat és integrációkat. Ez az útmutató a vállalkozásod tudásából válaszoló Quickchat AI Agentet kapcsolja hozzá. A BotFather a bot identitását készíti; nem ad tudást és nem állít be ügyfélszolgálati folyamatot.
Ért a chatbot fényképeket és fájlokat?
A Telegram-integráció fogadhat képeket és elemezheti vizuális tartalmukat. Más fájlok mellékletként megérkezhetnek, de a tartalmukat nem olvassa automatikusan. Teszteld az ügyfelek valódi fájltípusait, és ellenőrizd a Telegramot és az Inboxot is.
Készíthetek Telegram roleplay- vagy karakterbotot?
Igen. Ugyanaz a Telegram-kapcsolat karakteridentitással és megfelelő utasításokkal rendelkező Agentet is kiszolgálhat. A példa üzleti támogatásról szól; roleplay Agenthez saját prompt és tesztek kellenek.