Telegram AI chatbot pre skupiny a súkromné správy bez kódu

Piotr Grudzień
Publikované Aktualizované 16 min čítania
Telegram skupina a súkromný chat prepojené so znalosťami školy, žiadosťami o lekciu a človekom v Inboxe

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.

Schéma Agenta Saltmarsh so znalosťami a pokynmi pre Telegram skupinu, súkromné dopyty a Inbox 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íteKontrolný bod
1. Znalosti a pokynyAgent pozná cenu kurzu a nevymýšľa chýbajúce fakty.
2. Pripojenie skupinyNa 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 lekciuPovinné údaje sa uložia do riadka pre pracovníkov.
5. Human HandoffKonverzáciu prevezme človek a AI sa pozastaví.
6. TestovanieOdpovede, 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.

  1. 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.
  2. Vytvorte Telegram skupinu Saltmarsh Members. Pred pozvaním zákazníkov v testovacej skupine overte spomenutia, mlčanie a nadväzujúce správy.
  3. 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.
  4. 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.

Schéma oddeľujúca školské fakty v Knowledge Base od pokynov pre odpovede a smerovanie v Main Prompt Ceny a pravidlá sú fakty zo zdrojov. Stručnosť, neistota a smerovanie sú pokyny.

Vytvorte Agenta a pridajte znalosti

  1. V novom účte zvoľte Set up manually. V existujúcom najprv Add new AI Agent, potom ručné nastavenie.
  2. V Identity zadajte Saltmarsh Group do Name your AI Agent. Obsah group-main-prompt.txt z balíka vložte do Describe what you want your agent to do.
  3. 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.
  4. Otvorte Knowledge Base > Add Article. Do Create custom article zadajte Courses and trial enquiries, zvoľte Create article, vložte saltmarsh-courses.txt do Content a kliknite na Save.
  5. Zopakujte pre Weather, parking and personal enquiries so súborom saltmarsh-policies.txt. Počkajte, kým oba články ukážu Ready.
  6. Na Saltmarsh Group otvorte Actions & MCPs. Human Handoff nechajte vypnutý a nepridávajte Action pre skúšobné lekcie.
  7. Zvoľte Add new AI Agent a zopakujte ručné nastavenie pre Saltmarsh Sailing School so súborom main-prompt.txt a rovnakými dvoma znalosťami. Druhý Agent obsluhuje súkromné rozhovory. Pred zmenou nastavení vyberte správneho Agenta v prepínači účtu.

Knowledge Base lokálnej Quickchat App s dvoma článkami Saltmarsh Dva krátke zdroje jasne ukazujú, čo Agent vie. Pred testom znalostí skontrolujte Ready.

ZnalostiPresné fakty v príklade
KurzyStart Sailing: dva dni, EUR 240. Day Skipper theory: päť večerov, EUR 310. Súkromná lekcia: 90 minút, EUR 95.
TermínySezóna od apríla do októbra; termíny zverejnené mesiac vopred. Aktuálna dostupnosť ani najbližší termín nie sú uvedené.
VýbavaNepremokavá bunda, obuv nezanechávajúca stopy a náhradné oblečenie. Škola poskytuje plávacie vesty.
PočasieNad 25 uzlov alebo pri búrkach: presun na najbližší voľný termín bez príplatku. Rozhoduje inštruktor v dané ráno.
ParkovaniePri klubovni zadarmo. Kód brány sa posiela deň vopred; samotný kód chýba.
Skúšobné lekcieZistite 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ď

  1. 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.
  2. Otvorte AI Preview a opýtajte sa How much is Start Sailing?. Overte dva dni a EUR 240.
  3. Opýtajte sa Do you rent wetsuits?. Odpoveď má priznať chýbajúcu informáciu.

Editor Main Prompt v lokálnej Quickchat App s pokynmi Saltmarsh Prompt súkromného Agenta definuje príjem a odovzdanie. Skupinový používa vlastný prompt a obe Actions má vypnuté.

Lokálna stránka Actions pre Saltmarsh Group s vypnutým Human Handoff a bez vlastných Actions 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čí.

Schéma pozvania bota, potvrdenia správnej skupiny a odpovedí na spomenutia či reakcie Pridanie do Telegramu a potvrdenie v Quickchat AI sú samostatné kroky.

  1. V prepínači Agentov zvoľte Saltmarsh Group. Otvorte External Apps, vyberte Telegram a nájdite Quickchat AI bot.
  2. Zvoľte Add to a Telegram group. V Telegrame vyberte Saltmarsh Members a schváľte pridanie bota.
  3. Vráťte sa do Quickchat AI. Pod Waiting for your confirmation overte názov skupiny a Added by.
  4. Pri správnej skupine zvoľte Confirm. Má sa presunúť do Connected chats so zapnutým prepínačom.
  5. V Telegrame napíšte @ a vyberte bota zo zoznamu spomenutí. Opýtajte sa How much is Start Sailing?. Spoločný bot sa zvyčajne volá @QuickchatAI_bot; použite skutočné meno vo vašej skupine.
  6. Priamo na odpoveď reagujte What should I bring?. Potom samostatne, bez spomenutia, odošlite Does anyone know the gate code?. Spoločný bot má odpovedať na reakciu a bežnú správu nechať bez odpovede.

Výber Add to Group v Telegrame so skupinou Saltmarsh Members V Telegrame vyberte Saltmarsh Members, potom sa vráťte do Quickchat AI a potvrďte pripojenie.

Lokálna Quickchat App so skupinou Saltmarsh Members čakajúcou na potvrdenie Skutočné lokálne rozhranie s pripravenou testovacou skupinou ukazuje Confirm. Ilustruje ovládanie, nedokazuje pripojenie k živej Telegram skupine.

Zmienka v skupine Telegram sa pýta na cenu Start Sailing a bot odpovedá dvoma dňami a EUR 240 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 v Telegrame sa pýta, čo si priniesť, a nasleduje školský zoznam vybavenia 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.

Schéma všeobecných otázok v skupine a osobných žiadostí o lekciu či refundáciu v súkromí Skupina je spoločná konverzácia. Osobné údaje a odovzdanie pracovníkovi patria do súkromných správ.

  1. Vyberte súkromného Agenta Saltmarsh Sailing School. V External Apps > Telegram zapnite Direct message link. Skupinové pripojenia nechajte prázdne.
  2. Skopírujte vytvorený odkaz. Zachovajte parameter start=; samotný odkaz na spoločného bota neidentifikuje vášho Agenta.
  3. Otvorte ho v Telegrame a podľa potreby stlačte Start.
  4. Bez spomenutia bota sa opýtajte How much is Start Sailing?. Overte odpoveď školy a nájdite rozhovor v Inbox.
  5. Pripnite odkaz do uvítacej správy skupiny, aby ho členovia našli pred zdieľaním osobných údajov.

Ovládanie Direct message link v lokálnej Quickchat App Použite odkaz vytvorený pre svojho Agenta. Lokálna konfigurácia nedokazuje doručenie do živého Telegramu.

Quickchat AI doručuje uvítaciu správu Saltmarsh Sailing School v Telegrame Telegram po stlačení Start doručil uvítanie Saltmarsh. Potom overte odpoveď zo znalostí; samotný pozdrav netestuje vyhľadanie informácií.

Dva detaily Telegramu ukazujú Saltmarsh Members s pripnutou správou a pozvánkou na súkromné otázky 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.

Schéma súkromnej žiadosti zbierajúcej tri povinné údaje pred pridaním riadka pre kanceláriu Výsledkom je dopyt na vybavenie človekom. Nerezervuje miesto ani neurčuje cenu skúšobnej lekcie.

Pripojte Sheets a nastavte jednu Action

  1. 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.
  2. Otvorte vytvorenú tabuľku Quickchat Leads. Ponechajte názov hárka Leads, pretože naň smeruje vytvorená URL Action.
  3. Záhlavie nahraďte v poradí: Name, Preferred weekday, Sailing experience, Conversation link, Channel.
  4. V Actions & MCPs upravte vytvorenú Action log_lead_to_google_sheet podľ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

FormatNameDescriptionRequired
TextnameMeno, ktoré osoba uviedla pre túto žiadosť. Ak chýba, opýtajte sa.Áno
Textpreferred_weekdayPreferovaný deň v týždni, napríklad utorok. Ide o želanie, nie potvrdený termín.Áno
Textsailing_experienceUvedené 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čkaHodnota
AuthorizationBearer {{google_sheets_access_token}}
Content-Typeapplication/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ú.

Podmienka v lokálnej Quickchat App obmedzujúca Action na súkromný Telegram chat Samotný kľúč je telegram_chat_type. Podmienka sa kontroluje pred odoslaním požiadavky.

Editor Action v lokálnej Quickchat App s poľami skúšobnej lekcie 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.

Súkromná žiadosť Alex Morgan o skúšobnú lekciu v Telegrame a odpoveď potvrdzujúca dopyt namiesto rezervácie Agent zaznamenal zadané meno, preferenciu utorka a začiatočnícke skúsenosti. Dostupnosť a presnú cenu musí ešte potvrdiť kancelária.

Dva výrezy riadka Leads v Google Sheets zobrazujú Alex Morgan, Tuesday, beginner a telegram so skrytým odkazom na konverzáciu 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.

Koncepčná schéma bežných odpovedí AI, odovzdania, ktoré pozastaví AI, a pracovníka, ktorý prípad uzavrie Kontrolou je zmena priradenia. Prípad dokončí človek; návrat k AI overte zvlášť.

  1. Vyberte Saltmarsh Sailing School, otvorte Actions & MCPs > Human Handoff a zapnite ho. Na Saltmarsh Group ho nechajte vypnutý.
  2. V Handoff Rules zvoľte +. Do Rule Name zadajte Private enquiries, do Description vložte handoff-rule.txt a 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.
  3. 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.
  4. 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.
  5. Zo súkromného Telegram chatu odošlite I want a refund for last week. Can I speak to a person?.
  6. 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.
  7. 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.

Nastavenie Human Handoff pre súkromné dopyty Saltmarsh v lokálnej Quickchat App State vlastného pravidla je zapnutý. Preddefinované spúšťače sú vypnuté, takže kontrolujete jediné pravidlo.

Súkromná žiadosť o vrátenie peňazí v Telegrame a odpoveď bota, že konverzáciu prevezme človek 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í.

Testovací cyklus od presnej správy cez kontrolu odpovede po záznamy v Action a Inbox 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

  1. Otvorte Testing, vytvorte súbor Saltmarsh: knowledge checks a zvoľte Paste messages.
  2. Vložte simulation-messages.txt. Medzi prípadmi zachovajte samostatné oddeľovače ---.
  3. Otvorte Evaluation criteria, vložte evaluation-criteria.txt z balíka a uložte.
  4. Zvoľte Run > Start Run a skontrolujte jednotlivé odpovede aj skóre.

Testovacie správy Saltmarsh v časti Testing lokálnej Quickchat App Pri zmene jedného pokynu zachovajte rovnaké otázky, aby bolo porovnanie užitočné.

Dokončené lokálne testy znalostí Saltmarsh s jednotlivými skóre Čí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.

Odpoveď v Telegrame odmieta potvrdiť požičiavanie neoprénov a nasleduje správa o kóde brány bez zmienky, bez viditeľnej odpovede bota 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.

KontrolaSpráva alebo úkonOč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ď botoviWhat should I bring?Zoznam výbavy bez ďalšieho spomenutia.
Bežný rozhovorDoes anyone know the gate code? bez spomenutiaSpoloč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 skupineSpomeňte bota a žiadajte refundáciuSmerovanie do súkromia; skupina zostáva pri AI.
Súkromná odpoveďOtvorte celý DM odkaz a opýtajte sa na cenuSprávny Agent odpovie bez spomenutia.
Úplná žiadosť o lekciuOdošlite správu Alex Morgan z kroku 4Parametre Action súhlasia so skutočným riadkom; žiadna potvrdená rezervácia.
Súkromné odovzdanieŽiadajte refundáciu a po prevzatí znovu napíštePriradenie človeku, doručenie operátora, bez ďalšej AI odpovede.
Pravidlo počasiaWhat 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čí.

Porovnanie spoločného bota a vlastného bota vytvoreného cez BotFather Pred pridaním druhého bota vyberte potrebnú identitu a správanie správ.

PožiadavkaSpoločný Quickchat AI botVlastný bot
BotFather tokenNie je potrebnýPotrebný
Vlastné Telegram meno a obrázokSpoločná identitaIdentita vášho bota
Odpovede na skupinové spomenutia a reakcieÁnoÁno, keď ich Telegram doručí
Odpovede na bežné správy v skupineSpoločný bot mlčíNastavte súkromie alebo oprávnenie správcu
Súkromné rozhovoryStart odkaz Agenta v spoločnom botoviVlastné súkromné vlákno bota
Google Sheets ActionPodporovanáPodporovaná
Telegram moderačné ActionsSpoločný token nie je sprístupnenýVlastný token dostupný ako System Token
  1. V Telegrame otvorte overený účet BotFather a odošlite /newbot.
  2. Zvoľte zobrazované meno a dostupné používateľské meno končiace na bot. BotFather vráti token. Uchovajte ho v tajnosti.
  3. 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.
  4. Vložte token do Bot Token a dokončite spojenie. Skontrolujte zapnuté Enable your own bot.
  5. Otvorte Telegram odkaz bota, odošlite /start a rovnakú otázku na cenu kurzu.
  6. 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.

Formulár vlastného bota v lokálnej Quickchat App s prázdnym Bot Token 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ďouVygenerujte 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 AgentaPouž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 riadokOverte 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ávyOverte súkromie a práva skupiny; po zmene bota odstráňte a pridajte znovu.
Odpoveď uvádza nezadaný termín či službuOverte 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.

Quickchat AI Quickchat AI Ask Quickchat AI a question