Telegram AI chatbot môže odpovedať z firemných znalostí v skupine aj súkromne. Quickchat AI pripojí Agenta k Telegramu cez spoločného bota: pridajte ho do skupiny, potvrďte pripojenie v správe účtu a členovia ho môžu spomenúť s otázkou. Na tento postup nepotrebujete kód ani token BotFather.
V návode vytvoríte Saltmarsh Sailing School, fiktívnu školu so skupinou členov a súkromnými dopytmi. Dvaja Agenti zdieľajú rovnaké fakty: Saltmarsh Group odpovedá verejne, kým Saltmarsh Sailing School spracúva súkromné žiadosti o skúšobnú lekciu a pri refundácii zapája človeka. Žiadosť je dopyt pre kanceláriu, nie potvrdená rezervácia.
Dvaja Agenti oddeľujú zodpovednosť. Skupinový Agent nemá Action na odovzdanie ani príjem žiadostí; súkromný rieši dopyty a odpovede pracovníkov.
Postupujte podľa prehľadu. Rozšírenie Google Sheets je voliteľné; najprv môžete dokončiť odpovedanie a odovzdávanie človeku.
| Čo vytvoríte | Kontrolný bod |
|---|---|
| 1. Znalosti a pokyny | Agent pozná cenu kurzu a nevymýšľa chýbajúce fakty. |
| 2. Pripojenie skupiny | Na spomenutie odpovie; bežný rozhovor nechá bez reakcie. |
| 3. Súkromný chat | Úplný odkaz otvorí rozhovor so správnym Agentom. |
| 4. Voliteľné žiadosti o lekciu | Povinné údaje sa uložia do riadka pre pracovníkov. |
| 5. Human Handoff | Konverzáciu prevezme človek a AI sa pozastaví. |
| 6. Testovanie | Odpovede, smerovanie a vonkajšie účinky overíte samostatne. |
Stiahnite si balík Saltmarsh pre Telegram s presnými znalosťami, Main Promptom, receptom Action, hodnotiacimi kritériami a testovacími správami. Sú to upraviteľné súbory pre ďalšie kroky, nie import Agenta jedným kliknutím. Vzorové súbory, správy a snímky zostávajú v angličtine, aby zodpovedali overenému príkladu.
Čo potrebujete na vytvorenie Telegram chatbota?
Potrebujete účet Quickchat AI, dvoch Agentov a Telegram účet s oprávnením pridať bota do testovacej skupiny. Voliteľné ukladanie žiadostí potrebuje aj Google účet, ktorý môže povoliť Google Sheets.
- Vytvorte účet Quickchat AI a podľa potreby overte e-mail. Free je na osobné nekomerčné učenie. Plány platia pre jednotlivých Agentov, takže firma používajúca oboch potrebuje primerané komerčné pokrytie pre každého. Preview a Simulation spotrebúvajú AI kredity. Pozrite si aktuálne plány.
- Vytvorte Telegram skupinu
Saltmarsh Members. Pred pozvaním zákazníkov v testovacej skupine overte spomenutia, mlčanie a nadväzujúce správy. - Návod prejdite so svojím účtom Telegram vrátane správ návštevníka. Môžete tiež obsluhovať Inbox v Quickchat AI. Pred pozvaním zákazníkov požiadajte kolegu, aby skúsenosť overil z iného účtu.
- Rozbaľte balík. Vzorové fakty školy nechajte spolu; pred nasadením ich nahraďte vlastnými overenými pravidlami.
Snímky Quickchat App ukazujú lokálne spustenú aplikáciu s fiktívnou konfiguráciou Saltmarsh; popisy označujú pripravené testovacie údaje pripojení. Snímky Telegramu a Google Sheets ukazujú skutočné odpovede a uložený dopyt z pripojenej ukážky. Osobné údaje účtu sú orezané alebo výslovne skryté. Pomocou záverečného zoznamu zopakujte kontroly s vlastnými znalosťami a pripojenými účtami.
Krok 1: Ako naučiť Telegram chatbot znalosti o firme?
Firemné fakty vložte do Knowledge Base, prevádzkové pokyny do Main Prompt. Ich oddelenie umožní opraviť odpoveď bez zmeny správania Agenta.
Ceny a pravidlá sú fakty zo zdrojov. Stručnosť, neistota a smerovanie sú pokyny.
Vytvorte Agenta a pridajte znalosti
- V novom účte zvoľte Set up manually. V existujúcom najprv Add new AI Agent, potom ručné nastavenie.
- V Identity zadajte
Saltmarsh Groupdo Name your AI Agent. Obsahgroup-main-prompt.txtz balíka vložte do Describe what you want your agent to do. - Pokračujte bez pripájania externých aplikácií. Dokončite výber plánu; pri účte na učenie môžete použiť Skip for now.
- Otvorte Knowledge Base > Add Article. Do Create custom article zadajte
Courses and trial enquiries, zvoľte Create article, vložtesaltmarsh-courses.txtdo Content a kliknite na Save. - Zopakujte pre
Weather, parking and personal enquiriesso súboromsaltmarsh-policies.txt. Počkajte, kým oba články ukážu Ready. - Na Saltmarsh Group otvorte Actions & MCPs. Human Handoff nechajte vypnutý a nepridávajte Action pre skúšobné lekcie.
- Zvoľte Add new AI Agent a zopakujte ručné nastavenie pre
Saltmarsh Sailing Schoolso súborommain-prompt.txta rovnakými dvoma znalosťami. Druhý Agent obsluhuje súkromné rozhovory. Pred zmenou nastavení vyberte správneho Agenta v prepínači účtu.
Dva krátke zdroje jasne ukazujú, čo Agent vie. Pred testom znalostí skontrolujte Ready.
| Znalosti | Presné fakty v príklade |
|---|---|
| Kurzy | Start Sailing: dva dni, EUR 240. Day Skipper theory: päť večerov, EUR 310. Súkromná lekcia: 90 minút, EUR 95. |
| Termíny | Sezóna od apríla do októbra; termíny zverejnené mesiac vopred. Aktuálna dostupnosť ani najbližší termín nie sú uvedené. |
| Výbava | Nepremokavá bunda, obuv nezanechávajúca stopy a náhradné oblečenie. Škola poskytuje plávacie vesty. |
| Počasie | Nad 25 uzlov alebo pri búrkach: presun na najbližší voľný termín bez príplatku. Rozhoduje inštruktor v dané ráno. |
| Parkovanie | Pri klubovni zadarmo. Kód brány sa posiela deň vopred; samotný kód chýba. |
| Skúšobné lekcie | Zistite meno, preferovaný deň v týždni a skúsenosti s jachtingom. Dostupnosť a cenu potvrdzuje kancelária. |
Požičiavanie neoprénov zámerne chýba. Správna odpoveď prizná, že informáciu nemožno potvrdiť, namiesto vymysleného áno či nie. Pravidlo počasia tiež neposkytuje dnešnú predpoveď a cena súkromnej lekcie neurčuje cenu skúšobnej.
Nastavte Main Prompt a overte odpoveď
- U oboch Agentov otvorte Identity > Main Prompt a skontrolujte príslušný Saltmarsh prompt. Skupinový odpovedá všeobecne a odkazuje na pripnutý súkromný odkaz; súkromný zbiera dopyty a používa Human Handoff.
- Otvorte AI Preview a opýtajte sa
How much is Start Sailing?. Overte dva dni a EUR 240. - Opýtajte sa
Do you rent wetsuits?. Odpoveď má priznať chýbajúcu informáciu.
Prompt súkromného Agenta definuje príjem a odovzdanie. Skupinový používa vlastný prompt a obe Actions má vypnuté.
Dva výrezy zo skutočných nastavení skupinového Agenta. Odpovedá zo znalostí, ale nemá Action pre žiadosti alebo odovzdanie.
Dvaja Agenti jednoznačne oddeľujú smerovanie. Skupinový nemôže náhodne spustiť odovzdanie; súkromný môže odovzdať refundáciu bez pozastavenia skupiny. Preview overí fakty školy, ďalšie kroky pripojenia Telegramu.
Krok 2: Ako pridať AI chatbot do Telegram skupiny?
Otvorte External Apps > Telegram, pridajte spoločného bota do skupiny a v Quickchat AI zvoľte Confirm. Kým skupinu nepotvrdíte, Agent v nej mlčí.
Pridanie do Telegramu a potvrdenie v Quickchat AI sú samostatné kroky.
- V prepínači Agentov zvoľte Saltmarsh Group. Otvorte External Apps, vyberte Telegram a nájdite Quickchat AI bot.
- Zvoľte Add to a Telegram group. V Telegrame vyberte
Saltmarsh Membersa schváľte pridanie bota. - Vráťte sa do Quickchat AI. Pod Waiting for your confirmation overte názov skupiny a Added by.
- Pri správnej skupine zvoľte Confirm. Má sa presunúť do Connected chats so zapnutým prepínačom.
- V Telegrame napíšte
@a vyberte bota zo zoznamu spomenutí. Opýtajte saHow much is Start Sailing?. Spoločný bot sa zvyčajne volá@QuickchatAI_bot; použite skutočné meno vo vašej skupine. - Priamo na odpoveď reagujte
What should I bring?. Potom samostatne, bez spomenutia, odošliteDoes anyone know the gate code?. Spoločný bot má odpovedať na reakciu a bežnú správu nechať bez odpovede.
V Telegrame vyberte Saltmarsh Members, potom sa vráťte do Quickchat AI a potvrďte pripojenie.
Skutočné lokálne rozhranie s pripravenou testovacou skupinou ukazuje Confirm. Ilustruje ovládanie, nedokazuje pripojenie k živej Telegram skupine.
Potvrdená skupina dostala očakávanú odpoveď o kurze. Bota spomínajte jeho skutočným používateľským menom.
Odpoveď na správu bota funguje bez ďalšej zmienky. Odpoveď uvádza dodané informácie o vybavení.
Potvrdenie je dôležité, lebo údaje pozvánky sú viditeľné v skupine. Quickchat AI vyžaduje rozhodnutie v účte, než skupinu použije ako cieľ Agenta. Neznámu skupinu nepotvrdzujte. Rovnakú hranicu vysvetľuje dokumentácia Telegram pripojenia.
Potvrdenie dokončite pred opustením nastavenia. Ak bot odíde z nepotvrdenej skupiny, vygenerujte nový odkaz Add to a Telegram group, znova ho pridajte a čakajúcu skupinu okamžite potvrďte v Quickchat AI. Pridanie bota cez vyhľadávanie členov v Telegrame tento postup pripojenia nenahrádza.
Odznak Admin označuje stav bota v Telegrame. Pre bežné odpovede spoločného bota nie je potrebný. Ani pridelenie správcu nemení pravidlo odpovedať na spomenutia a reakcie.
Krok 3: Ako povoliť súkromné Telegram chaty?
Zapnite Direct message link a zdieľajte celú vytvorenú URL. Odkaz vyberie vášho Agenta v spoločnom botovi; zákazníci môžu písať súkromne bez pridania do skupiny.
Skupina je spoločná konverzácia. Osobné údaje a odovzdanie pracovníkovi patria do súkromných správ.
- Vyberte súkromného Agenta Saltmarsh Sailing School. V External Apps > Telegram zapnite Direct message link. Skupinové pripojenia nechajte prázdne.
- Skopírujte vytvorený odkaz. Zachovajte parameter
start=; samotný odkaz na spoločného bota neidentifikuje vášho Agenta. - Otvorte ho v Telegrame a podľa potreby stlačte Start.
- Bez spomenutia bota sa opýtajte
How much is Start Sailing?. Overte odpoveď školy a nájdite rozhovor v Inbox. - Pripnite odkaz do uvítacej správy skupiny, aby ho členovia našli pred zdieľaním osobných údajov.
Použite odkaz vytvorený pre svojho Agenta. Lokálna konfigurácia nedokazuje doručenie do živého Telegramu.
Telegram po stlačení Start doručil uvítanie Saltmarsh. Potom overte odpoveď zo znalostí; samotný pozdrav netestuje vyhľadanie informácií.
Dva výrezy tej istej obrazovky Telegramu ukazujú pripnutú pozvánku. Hodnota start ukážkového odkazu je vynechaná; pripnite vlastný úplný vygenerovaný odkaz.
Súkromný chat so spoločným botom je vždy naviazaný na jedného Agenta. Odkaz iného Agenta môže toto prepojenie prepnúť. Pre vlastnú Telegram identitu a samostatné vlákno použite vlastného bota.
Vypnutie Direct message link zabráni novým pripojeniam cez odkaz. Existujúci chat zastavíte jeho prepínačom alebo Disconnect. Odkaz je verejný vstup, nie obmedzenie prístupu k dôverným znalostiam.
Krok 4: Ako uložiť žiadosť o skúšobnú lekciu do Google Sheets?
Integrácia Google Sheets vytvorí tabuľku a Action na pridávanie riadkov. Upravte ju pre tri povinné polia a potom overte skutočný riadok. Tento voliteľný krok funguje so spoločným Telegram botom.
Výsledkom je dopyt na vybavenie človekom. Nerezervuje miesto ani neurčuje cenu skúšobnej lekcie.
Pripojte Sheets a nastavte jednu Action
- Na Saltmarsh Sailing School otvorte Actions & MCPs > Add Action > Google Sheets a zvoľte Connect Google Sheets. Prihláste sa správnym Google účtom a povoľte požadovaný prístup.
- Otvorte vytvorenú tabuľku Quickchat Leads. Ponechajte názov hárka Leads, pretože naň smeruje vytvorená URL Action.
- Záhlavie nahraďte v poradí:
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - V Actions & MCPs upravte vytvorenú Action
log_lead_to_google_sheetpodľa receptu. Parametre, telo požiadavky a hlavičky tabuľky meňte spolu, aby sedelo poradie.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Meno, ktoré osoba uviedla pre túto žiadosť. Ak chýba, opýtajte sa. | Áno |
| Text | preferred_weekday | Preferovaný deň v týždni, napríklad utorok. Ide o želanie, nie potvrdený termín. | Áno |
| Text | sailing_experience | Uvedené skúsenosti s jachtingom, napríklad začiatočník. Ak chýbajú, opýtajte sa; neodvodzujte ich. | Áno |
Pri všetkých troch parametroch nastavte No default a odstráňte predvolené parametre e-mailu a otázky. Recept sa pýta iba na tieto tri údaje. Telegram používateľské meno je voliteľné, preto nie je spoľahlivým povinným kontaktom; uložený odkaz umožní personálu vrátiť sa k dopytu.
Metóda a URL: ponechajte vytvorenú POST URL. Už obsahuje ID tabuľky, hárok Leads a valueInputOption=RAW. Žiadne zástupné ID tabuľky nevypĺňate.
Hlavičky: zachovajte nastavenie integrácie.
| Hlavička | Hodnota |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
Na karte Body v API Endpoint použite:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Pomocou Add AI Data vložte parametre a premenné konverzácie. Prvé tri hodnoty pochádzajú z rozhovoru, posledné dve dodáva 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.
Otvorte Advanced settings > Run only when a pridajte telegram_chat_type equals private. Použite samotný kľúč metadát bez metadata_ a zátvoriek. Zablokuje HTTP požiadavku zo skupiny, aj keby sa ju model pokúsil spustiť. Kontrolu vysvetľuje dokumentácia podmienok spustenia.
Response filter nastavte na $.updates.updatedRows, aby Action vracala počet riadkov namiesto zbytočnej odpovede poskytovateľa. Action nechajte zapnutú.
Samotný kľúč je telegram_chat_type. Podmienka sa kontroluje pred odoslaním požiadavky.
Lokálne nastavenie receptu. URL Sheets a OAuth oprávnenie musia pochádzať z vášho Google pripojenia.
Overte riadok a potom neúplnú žiadosť
Cez súkromný Telegram odkaz Agenta odošlite:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Overte tri miesta: odpoveď opisuje dopyt, karta Action v Inboxe zobrazuje zadané hodnoty a skutočný hárok Leads obsahuje zodpovedajúci riadok. Uisťujúca odpoveď ani vysoké skóre Simulation nedokazujú zápis do Google Sheets.
Agent zaznamenal zadané meno, preferenciu utorka a začiatočnícke skúsenosti. Dostupnosť a presnú cenu musí ešte potvrdiť kancelária.
Dva detaily rovnakého uloženého riadka zachovávajú čitateľnosť všetkých piatich stĺpcov. Odkaz na konverzáciu v konkrétnom účte je skrytý; ostatné štyri hodnoty zostali nezmenené.
Samostatný test začnite správou I would like a trial lesson. Pred spustením Action má Agent postupne vyžiadať chýbajúce polia, vždy jednou otázkou. Skúste aj How much is Start Sailing?; bežná otázka o kurze nesmie vytvoriť riadok. Prompt žiada jeden zápis na žiadosť, ale recept nie je idempotentný rezervačný systém. Pred prevádzkou overte duplicity.
Krok 5: Ako odovzdať Telegram konverzáciu človeku?
Nastavte Human Handoff, potom v Inbox overte priradenie. Pokyn „kancelária odpovie“ sám neodovzdá zodpovednosť ani nepozastaví AI.
Kontrolou je zmena priradenia. Prípad dokončí človek; návrat k AI overte zvlášť.
- Vyberte Saltmarsh Sailing School, otvorte Actions & MCPs > Human Handoff a zapnite ho. Na Saltmarsh Group ho nechajte vypnutý.
- V Handoff Rules zvoľte +. Do Rule Name zadajte
Private enquiries, do Description vložtehandoff-rule.txta zapnite State. Nové riadky sú neaktívne. Pravidlo súkromného Agenta zahŕňa refundácie, sťažnosti, žiadosti o človeka a prijatie ľudskej pomoci. - Vymažte Keywords, vypnite preddefinované pravidlá a uložte jediné aktívne vlastné pravidlo. Skupinu izoluje vypnutý Human Handoff na samostatnom Agentovi; pravidlo opisuje, kedy má odovzdať súkromný Agent.
- Confirmation nastavte na
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Human Agents’ availability prispôsobte skutočným hodinám podpory a mimo nich použite pravdivú správu. - Zo súkromného Telegram chatu odošlite
I want a refund for last week. Can I speak to a person?. - V Inbox nájdite rozhovor, overte priradenie, zvoľte Assign to me a odošlite
Hi, I’m Alex from the office. I’ll review your request.Skontrolujte doručenie do Telegramu. - Keď konverzáciu vlastní človek, odošlite ďalšiu zákaznícku správu. AI má mlčať. Operátor má prípad dokončiť a vyriešiť v Inboxe. Návrat k AI testujte samostatne.
State vlastného pravidla je zapnutý. Preddefinované spúšťače sú vypnuté, takže kontrolujete jediné pravidlo.
Skutočná žiadosť v Telegrame spustila Handoff. Priradenie v Inbox a odchádzajúca odpoveď operátora boli overené samostatne.
Pri živej kontrole konverzácia prešla do Unassigned, pripravená na prevzatie človekom. Operátor zvolil Assign to me, odoslal odpoveď kancelárie a Telegram ju prijal. Snímka vyššie ukazuje odpoveď pri odovzdaní; neskoršiu správu operátora nezobrazuje. Pri opakovaní testu overte priradenie aj doručenie.
Ponechajte prípad operátorovi, kým nebude vyriešený. V našom lokálnom teste vrátenia peňazí návrat k AI Agent umožnil jednu odpoveď, kým sa Handoff spustil znova. Návrat k AI vyžaduje vlastný úspešný nadväzujúci test; nie je súčasťou kritérií dokončenia tohto postupu. Sprievodca odovzdaním človeku podrobnejšie rozoberá personálne zabezpečenie a zodpovednosť.
Krok 6: Ako otestovať celý Telegram chatbot?
Testing používajte na opakovateľné kontroly odpovedí, živý Telegram a vonkajšie účinky overte zvlášť. Model môže odpovedať správne, hoci nefunguje skupinové pripojenie, zápis do tabuľky alebo doručenie pri odovzdaní.
Overujte systém zodpovedný za výsledok: znalosti pre fakty, Action logy pre požiadavky, Sheets pre riadky a Telegram pre doručenie.
Spustite opakovateľný súbor otázok
- Otvorte Testing, vytvorte súbor
Saltmarsh: knowledge checksa zvoľte Paste messages. - Vložte
simulation-messages.txt. Medzi prípadmi zachovajte samostatné oddeľovače---. - Otvorte Evaluation criteria, vložte
evaluation-criteria.txtz balíka a uložte. - Zvoľte Run > Start Run a skontrolujte jednotlivé odpovede aj skóre.
Pri zmene jedného pokynu zachovajte rovnaké otázky, aby bolo porovnanie užitočné.
Čítajte odpovede aj skóre. Ide o lokálne testy znalostí, nie Telegram doručenia.
Hodnotiteľ potrebuje fakty školy na posúdenie presnosti. Musí vedieť aj to, že prepis nedokazuje riadok v tabuľke, Telegram doručenie ani zmenu priradenia. Štandardná textová Simulation neposkytuje Telegram metadáta; ich neprítomnosť neznamená chybu podmienky len pre súkromné chaty. Kontroly závislé od kanála vykonávajte v skutočnom súkromnom rozhovore.
Čo zmenili lokálne testy?
Pôvodný návrh používal jedného Agenta pre oba vstupy. Lokálny test ukázal, že skupinová žiadosť o vrátenie peňazí odovzdala spoločnú konverzáciu cez Human Handoff. Agentov sme oddelili a na skupinovom Agentovi vypli Handoff aj Actions na prijímanie dopytov. Opakované skupinové kontroly vrátenia peňazí a skúšobných lekcií potom odkázali na pripnutý súkromný odkaz a ponechali konverzáciu priradenú AI. Preto krok 1 oddeľuje obe konverzácie nastavením aj pokynmi.
Desať záverečných lokálnych kontrol znalostí získalo po 5/5 a obaja hostovaní Agenti prešli rovnakými desiatimi prípadmi. Tieto malé testovacie behy nie sú odhadom presnosti v produkcii. Živá skupina tiež odpovedala na otázky o cene kurzu a vybavení, potom odmietla potvrdiť požičiavanie neoprénov. Pri úprave balíka zachovajte prípady s chýbajúcimi faktmi; samotné správne ceny netestujú zdržanlivosť Agenta.
Chýbajúce znalosti vedú k odpovedi „nemôžem potvrdiť“. Samostatná správa o kóde brány neoslovuje bota a na tejto snímke nie je viditeľná odpoveď na ňu.
Skutočná súkromná žiadosť o skúšobnú lekciu vyvolala jedno úspešné volanie Sheets Action s hodnotami Alex Morgan, Tuesday a beginner. Google vrátil HTTP 200 a jeden aktualizovaný riadok; uložený riadok obsahoval aj odkaz na konverzáciu a kanál telegram. Samostatný test Action s metadátami skupinového chatu neodoslal žiadnu HTTP požiadavku. Pri úprave podmienky overte prijatú súkromnú žiadosť aj odmietnutý skupinový kontext.
Overte kanál a jeho účinky
Vlastné pozorovania zapisujte do prázdneho test-matrix.csv z balíka. Snímky vyššie ukazujú predvedené výsledky; tabuľka zahŕňa aj kontroly pre vlastné nastavenie. Pri testovaní mlčania zaznamenajte uplynulý čas a oddeľujte prevzatie človekom od prípadného neskoršieho návratu k AI.
| Kontrola | Správa alebo úkon | Očakávaný výsledok |
|---|---|---|
| Spomenutie v skupine | @QuickchatAI_bot How much is Start Sailing? | Stručná odpoveď s EUR 240; rovnaký rozhovor v Inboxe. |
| Odpoveď botovi | What should I bring? | Zoznam výbavy bez ďalšieho spomenutia. |
| Bežný rozhovor | Does anyone know the gate code? bez spomenutia | Spoločný bot neodpovie. |
| Chýbajúca znalosť | Spomeňte bota a opýtajte sa Do you rent wetsuits? | Nemožno potvrdiť; žiadne vymyslené áno ani nie. |
| Osobná žiadosť v skupine | Spomeňte bota a žiadajte refundáciu | Smerovanie do súkromia; skupina zostáva pri AI. |
| Súkromná odpoveď | Otvorte celý DM odkaz a opýtajte sa na cenu | Správny Agent odpovie bez spomenutia. |
| Úplná žiadosť o lekciu | Odošlite správu Alex Morgan z kroku 4 | Parametre Action súhlasia so skutočným riadkom; žiadna potvrdená rezervácia. |
| Súkromné odovzdanie | Žiadajte refundáciu a po prevzatí znovu napíšte | Priradenie človeku, doručenie operátora, bez ďalšej AI odpovede. |
| Pravidlo počasia | What happens if the forecast says 30 knots? | Bezplatný presun a rozhodnutie inštruktora; bez tvrdenia o aktuálnej predpovedi. |
Ak kontrola zlyhá, zmeňte jedno relevantné nastavenie a zopakujte rovnakú správu. Chýbajúci fakt opravte v Knowledge Base, predčasnú Action v popise či povinných parametroch; pri tichej skupine najprv overte potvrdenie a oslovenie. Neúspešný výsledok zachovajte pre viditeľné porovnanie.
Kedy vytvoriť vlastného bota pomocou BotFather?
Vlastného bota vytvorte pre vlastné meno a obrázok, Telegram Bot API Actions alebo príjem bežných skupinových správ. Pre predchádzajúce skupinové a súkromné odpovede spoločný bot stačí.
Pred pridaním druhého bota vyberte potrebnú identitu a správanie správ.
| Požiadavka | Spoločný Quickchat AI bot | Vlastný bot |
|---|---|---|
| BotFather token | Nie je potrebný | Potrebný |
| Vlastné Telegram meno a obrázok | Spoločná identita | Identita vášho bota |
| Odpovede na skupinové spomenutia a reakcie | Áno | Áno, keď ich Telegram doručí |
| Odpovede na bežné správy v skupine | Spoločný bot mlčí | Nastavte súkromie alebo oprávnenie správcu |
| Súkromné rozhovory | Start odkaz Agenta v spoločnom botovi | Vlastné súkromné vlákno bota |
| Google Sheets Action | Podporovaná | Podporovaná |
| Telegram moderačné Actions | Spoločný token nie je sprístupnený | Vlastný token dostupný ako System Token |
- V Telegrame otvorte overený účet BotFather a odošlite
/newbot. - Zvoľte zobrazované meno a dostupné používateľské meno končiace na
bot. BotFather vráti token. Uchovajte ho v tajnosti. - Ak sa tento bot pridá do skupiny, vyberte Saltmarsh Group. Saltmarsh Sailing School používajte iba na súkromné rozhovory. V External Apps > Telegram otvorte Your own bot a zvoľte Connect to Telegram.
- Vložte token do Bot Token a dokončite spojenie. Skontrolujte zapnuté Enable your own bot.
- Otvorte Telegram odkaz bota, odošlite
/starta rovnakú otázku na cenu kurzu. - Pre bežné skupinové správy použite v BotFather
/setprivacy, vyberte bota a Disable, potom ho odstráňte a znovu pridajte do testovacej skupiny. Aj bot správca prijíma bežné správy. Dokumentácia súkromia Telegramu vysvetľuje pravidlá doručenia.
Token vkladajte iba do Bot Token. Prázdne pole zabezpečuje, že sa nezverejní prihlasovací údaj.
Spoločného a vlastného bota držte v oddelených skupinách. Spolu môžu vytvárať duplicitné odpovede. Pre pripínanie oznámení alebo moderovanie pokračujte návodom na správu Telegram skupiny vrátane podmienok Actions určených iba správcom.
Môže ChatGPT alebo Claude pomôcť nastaviť Telegram chatbot?
Pripojená aplikácia na správu Quickchat AI účtu môže vytvoriť Agenta, pridať znalosti, nastaviť podporované funkcie a spustiť testy. Ak klient sprístupňuje nastavenie Telegramu, môže zapnúť odkaz na súkromný chat spoločného bota. Výber skupiny a potvrdenie v ovládacom paneli zostávajú vlastníkovi. Niektorí klienti vyžadujú ovládací panel aj na aktiváciu súkromného odkazu a nastavenia Human Handoff, preto nech asistent najprv skontroluje dostupné nástroje.
Pripojte Quickchat AI plugin pre ChatGPT alebo Claude konektor a pridajte súbory balíka s týmto promptom:
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.
Dostupnosť nástrojov závisí od klienta a oprávnení účtu. Pri prihlásení postupujte podľa dokumentácie správy účtu. Pripája asistenta k Quickchat AI účtu; osobný rozhovor ChatGPT či Claude sa tým nestane hostovaným backendom Telegram bota.
Prečo Telegram chatbot neodpovedá?
Pred prepísaním prompta overte pripojenie a cestu správy. Tieto príznaky majú rôzne príčiny.
| Príznak | Čo overiť |
|---|---|
| Skupina je uvedená, ale mlčí | Potvrďte správnu skupinu, zapnite ju v Connected chats a spomeňte skutočné meno bota alebo reagujte na jeho správu. |
| Bot odišiel pred prvou odpoveďou | Vygenerujte nový odkaz Add to a Telegram group, znova ho pridajte a čakajúcu skupinu okamžite potvrďte pomocou Confirm v Quickchat AI. |
| Samotný bot odkaz otvorí nesprávneho Agenta | Použite celý súkromný odkaz vrátane start=. Overte, či odkaz iného Agenta neprepol spoločný chat. |
| Po refundácii AI prestala odpovedať | Overte priradenie v Inboxe. Odovzdaný rozhovor je pozastavený do zámerného prepriradenia. |
| V Sheets nie je riadok | Overte zapnutú Action, všetky polia, súkromný chat a URL smerujúcu na Leads. Prezrite volanie a Google pripojenie. |
| Vlastný bot nedostáva bežné správy | Overte súkromie a práva skupiny; po zmene bota odstráňte a pridajte znovu. |
| Odpoveď uvádza nezadaný termín či službu | Overte uložené Ready znalosti a pokyn pre neistotu. Zopakujte presne chybnú otázku. |
| Testy prestali odpovedať | Skontrolujte AI kredity a neúspešnú požiadavku; vyčerpaný limit nehodnotí kvalitu prompta. |
Pred pozvaním zákazníkov nahraďte fiktívne fakty, skontrolujte oddelenie skupinových a súkromných konverzácií a zabezpečte obsluhu frontu odovzdaných prípadov. Ako záverečnú kontrolu pred spustením požiadajte kolegu, aby verejné vstupy overil z iného účtu. Pre ďalší komunitný kanál ponúka návod na Discord chatbot porovnateľný postup tvorby a testovania. Pre rozhovory s postavami použite sprievodcu Telegram roleplay.
Voliteľné kontroly: Porovnajte spôsoby nasadenia podľa uvedených potrieb alebo počet odpovedí pre rozpočet kreditov podľa zadaného rozpočtu. Kalkulačky nekontrolujú účet, web ani zostatok.
Kopírovateľné nastavenie Saltmarsh
Toto sú úplné zdrojové fakty a pokyny z návodu. Stiahnutý balík obsahuje aj recept Action, kritériá hodnotenia a testy.
Skupinový Agent: Main Prompt
Vložte do Identity > Main Prompt na Saltmarsh Group. Human Handoff a vlastné Actions nechajte vypnuté.
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.
Súkromný Agent: Main Prompt
Vložte do Identity > Main Prompt na Saltmarsh Sailing School. Názov Action musí zodpovedať receptu.
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.
Znalosti: kurzy a žiadosti o skúšobné lekcie
Vložte do poľa Content prvého znalostného článku.
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.
Znalosti: pravidlá a informácie pre členov
Vložte do poľa Content druhého článku.
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.
Pravidlo Human Handoff
Vložte pod Human Handoff > Handoff Rules a nastavte skutočnú dostupnosť obsluhy.
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.
Často kladené otázky
Ako pridám AI chatbot do Telegram skupiny?
V Quickchat AI otvorte External Apps, vyberte Telegram a Add to a Telegram group. Zvoľte skupinu v Telegrame, vráťte sa do Quickchat AI a potvrďte ju pomocou Confirm. Členovia sa pýtajú spomenutím spoločného bota alebo odpoveďou na jeho správu.
Odpovedá Telegram AI chatbot na každú správu?
Spoločný Quickchat AI bot v skupine odpovedá na spomenutia a reakcie na vlastné správy. Bežný rozhovor odpoveď nespúšťa. Vlastný bot môže prijímať bežné správy pri vypnutom súkromí Telegramu alebo ako správca. Toto nastavenie testujte v samostatnej skupine.
Potrebujem BotFather alebo Telegram bot token?
Pre spoločného bota a súkromný odkaz nepotrebujete BotFather ani token. Vlastného bota cez BotFather vytvorte pre vlastné meno a obrázok alebo Actions volajúce Telegram Bot API. Bežné Google Sheets Actions fungujú aj so spoločným botom.
Môžu zákazníci písať Telegram chatbotu súkromne?
Áno. V Quickchat AI zapnite Direct message link a zdieľajte celý vytvorený odkaz. Zákazník ho otvorí a podľa potreby stlačí Start. Odkaz vyberie Agenta v spoločnom botovi. Vypnutie zabráni novým spojeniam; existujúce súkromné chaty majú vlastné prepínače a odpojenie.
Je Telegram AI chatbot zadarmo?
Vytvorenie bota v BotFather samo nepridáva AI službu. Quickchat AI má Free plán na osobné nekomerčné učenie s obmedzenými AI kreditmi. Komerčné nasadenie vyžaduje platený plán. Odpovede, Preview a Simulation spotrebúvajú kredity; externé služby môžu mať vlastné náklady.
Má Telegram AI chatboty?
Telegram podporuje AI boty a integrácie tretích strán. Tento návod pripája Quickchat AI Agenta odpovedajúceho zo znalostí vašej firmy. BotFather vytvára identitu bota; nedodáva znalosti ani nenastavuje zákaznícku podporu.
Rozumie chatbot fotografiám a súborom?
Telegram integrácia prijíma fotografie a môže analyzovať ich obrazový obsah. Iné súbory môžu prísť ako prílohy, ich obsah sa však automaticky nečíta. Otestujte skutočné typy súborov zákazníkov a skontrolujte Telegram aj Inbox.
Môžem vytvoriť Telegram roleplay bota alebo postavu?
Áno. Rovnaké Telegram pripojenie môže obsluhovať Agenta s identitou postavy a vhodnými pokynmi. Tento návod používa firemnú podporu; roleplay Agent potrebuje vlastný prompt a testy.