AI chatbot pro Telegram může odpovídat ze znalostí vaší firmy ve skupině i soukromě. Quickchat AI propojí Agenta s Telegramem prostřednictvím sdíleného bota: přidáte ho do skupiny, potvrdíte připojení v administraci a členové jej mohou zmínit s otázkou. K tomuto postupu nepotřebujete kód ani token od BotFather.
V tomto návodu vytvoříte Saltmarsh Sailing School, fiktivní školu se skupinou členů a soukromými poptávkami. Dva Agenti používají stejná fakta: Saltmarsh Group odpovídá veřejně, Saltmarsh Sailing School zpracovává soukromé žádosti o zkušební lekci a předává vrácení peněz člověku. Žádost je poptávka pro kancelář, nikoli potvrzená rezervace.
Dva Agenti oddělují odpovědnost. Skupinový Agent nemá Action pro předání ani příjem žádostí; soukromý Agent řeší poptávky a odpovědi pracovníků.
Postupujte podle přehledu. Rozšíření o Google Sheets je volitelné; nejprve můžete dokončit odpovídání a předávání člověku.
| Co vytvoříte | Kontrolní bod |
|---|---|
| 1. Znalosti a pokyny | Agent zná cenu kurzu a nevymýšlí chybějící fakta. |
| 2. Připojení skupiny | Na zmínku odpoví, běžný rozhovor nechá bez reakce. |
| 3. Soukromý chat | Úplný odkaz otevře rozhovor se správným Agentem. |
| 4. Volitelné poptávky lekcí | Povinné údaje se uloží do řádku pro pracovníky školy. |
| 5. Human Handoff | Konverzaci převezme člověk a AI se pozastaví. |
| 6. Testování | Odpovědi, směrování a vnější účinky ověříte odděleně. |
Stáhněte si sadu Saltmarsh pro Telegram s přesnými znalostmi, Main Prompt, receptem Action, hodnoticími kritérii a testovacími zprávami. Jde o upravitelné soubory pro následující kroky, nikoli import Agenta jedním kliknutím. Ukázkové soubory, zprávy a snímky zůstávají v angličtině, aby odpovídaly ověřenému příkladu.
Co potřebujete k vytvoření chatbota pro Telegram?
Potřebujete účet Quickchat AI, dva Agenty a účet Telegram s oprávněním přidat bota do testovací skupiny. Volitelné ukládání žádostí vyžaduje také účet Google, který může povolit přístup ke Google Sheets.
- Vytvořte účet Quickchat AI a případně ověřte e-mail. Free je určen k osobnímu nekomerčnímu učení. Plány platí pro jednotlivé Agenty, takže firma používající oba potřebuje vhodný komerční plán pro každého. Preview a Simulation spotřebovávají AI kredity. Podívejte se na aktuální plány.
- Vytvořte skupinu Telegram s názvem
Saltmarsh Members. V testovací skupině ověřte zmínky, mlčení a navazující zprávy, než pozvete zákazníky. - Projděte návod se svým účtem Telegram, včetně zpráv návštěvníka. Můžete také obsluhovat Inbox v Quickchat AI. Před pozváním zákazníků požádejte kolegu, aby zkušenost ověřil z jiného účtu.
- Rozbalte sadu. Ukázková fakta školy ponechte pohromadě; před nasazením je nahraďte vlastními ověřenými pravidly.
Snímky Quickchat App ukazují lokálně spuštěnou aplikaci s fiktivním nastavením Saltmarsh; popisky označují připravená testovací data připojení. Snímky Telegramu a Google Sheets ukazují skutečné odpovědi a uloženou poptávku z připojené ukázky. Osobní údaje účtu jsou oříznuté nebo výslovně skryté. Pomocí závěrečného seznamu zopakujte kontroly s vlastními znalostmi a připojenými účty.
Krok 1: Jak naučit chatbota pro Telegram znalosti o firmě?
Fakta uložte do Knowledge Base a pracovní pokyny do Main Prompt. Díky tomuto oddělení opravíte odpověď, aniž byste měnili chování Agenta.
Ceny a pravidla jsou fakta ze zdrojů. Stručnost, přiznání nejistoty a směrování jsou pokyny.
Vytvořte Agenta a přidejte znalosti
- V novém účtu zvolte Set up manually. V existujícím nejprve vyberte Add new AI Agent a potom ruční nastavení.
- V Identity zadejte
Saltmarsh Groupdo Name your AI Agent. Do Describe what you want your agent to do vložtegroup-main-prompt.txtze sady. - Pokračujte bez připojování externích aplikací. Dokončete volbu plánu; u účtu pro učení můžete použít Skip for now.
- Otevřete Knowledge Base > Add Article. Do Create custom article zadejte
Courses and trial enquiries, vyberte Create article, vložtesaltmarsh-courses.txtdo Content a klikněte na Save. - Totéž proveďte pro
Weather, parking and personal enquiriesse souboremsaltmarsh-policies.txt. Počkejte, až oba články zobrazí Ready. - U Saltmarsh Group otevřete Actions & MCPs. Human Handoff nechte vypnutý a nepřidávejte Action pro žádosti o lekci.
- Vyberte Add new AI Agent a zopakujte ruční nastavení pro
Saltmarsh Sailing Schoolse souboremmain-prompt.txta stejnými dvěma znalostními soubory. Druhý Agent bude obsluhovat soukromé chaty. Před změnou nastavení vyberte správného Agenta v přepínači účtu.
Dva krátké zdroje jasně ukazují, jaká fakta Agent má. Před testem znalostí ověřte stav Ready.
| Znalosti | Přesná fakta v příkladu |
|---|---|
| Kurzy | Start Sailing: dva dny, EUR 240. Day Skipper theory: pět večerů, EUR 310. Soukromá lekce: 90 minut, EUR 95. |
| Termíny | Sezona od dubna do října; termíny se zveřejňují měsíc předem. Aktuální dostupnost ani nejbližší termín nejsou uvedeny. |
| Vybavení | Nepromokavá bunda, obuv nezanechávající stopy a náhradní oblečení. Škola poskytuje plovací vesty. |
| Počasí | Nad 25 uzlů nebo při bouřkách: přesun na nejbližší volný termín bez příplatku. Rozhoduje instruktor daného rána. |
| Parkování | U klubovny zdarma. Kód brány se posílá den předem; samotný kód chybí. |
| Zkušební lekce | Zjistěte jméno, preferovaný den v týdnu a zkušenosti s plachtěním. Dostupnost a cenu potvrzuje kancelář. |
Půjčování neoprenů úmyslně chybí. Správná odpověď přizná, že informaci nelze potvrdit, místo vymyšleného ano či ne. Pravidlo pro počasí také nedodává dnešní předpověď a cena soukromé lekce neurčuje cenu zkušební lekce.
Nastavte Main Prompt a ověřte odpověď
- U obou Agentů otevřete Identity > Main Prompt a zkontrolujte příslušný prompt Saltmarsh. Skupinový prompt odpovídá na obecné otázky a odkazuje na připnutý soukromý odkaz; soukromý sbírá poptávky a používá Human Handoff.
- Otevřete AI Preview a položte otázku
How much is Start Sailing?. Ověřte dva dny a EUR 240. - Zeptejte se
Do you rent wetsuits?. Odpověď musí přiznat chybějící informaci.
Prompt soukromého Agenta určuje příjem žádostí a předávání. Skupinový používá vlastní prompt a obě Actions má vypnuté.
Dva výřezy ze skutečného nastavení skupinového Agenta. Může odpovídat ze znalostí, ale nemá Action pro žádosti ani předávání.
Dva Agenti jednoznačně oddělují směrování. Skupinový nemůže omylem spustit předání; soukromý může předat refundaci bez pozastavení skupiny. Preview ověří fakta školy, následující kroky jednotlivá připojení Telegramu.
Krok 2: Jak přidat AI chatbota do skupiny Telegram?
Otevřete External Apps > Telegram, přidejte sdíleného bota do skupiny a v Quickchat AI ji potvrďte pomocí Confirm. Do potvrzení Agent ve skupině mlčí.
Přidání do Telegramu a potvrzení v Quickchat AI jsou samostatné kroky.
- V přepínači Agentů vyberte Saltmarsh Group. Otevřete External Apps, vyberte Telegram a najděte Quickchat AI bot.
- Zvolte Add to a Telegram group. V Telegramu vyberte
Saltmarsh Membersa schvalte přidání bota. - Vraťte se do Quickchat AI. Pod Waiting for your confirmation ověřte název skupiny a údaje Added by.
- U správné skupiny klikněte na Confirm. Přesune se do Connected chats se zapnutým přepínačem.
- V Telegramu napište
@a vyberte bota ze seznamu zmínek. Zeptejte seHow much is Start Sailing?. Sdílený bot obvykle používá@QuickchatAI_bot; použijte skutečné jméno zobrazené ve skupině. - Přímo na odpověď reagujte
What should I bring?. Potom odešlete samostatnou zprávu bez zmínky:Does anyone know the gate code?. Sdílený bot má odpovědět na reakci a běžnou zprávu nechat bez odpovědi.
V Telegramu vyberte Saltmarsh Members a poté se vraťte do Quickchat AI a potvrďte připojení.
Skutečné lokální rozhraní s testovací skupinou ukazuje umístění Confirm. Ilustruje ovládání, nedokládá připojení k živé skupině Telegram.
Potvrzená skupina dostala očekávanou odpověď o kurzu. Bota zmiňujte jeho skutečným uživatelským jménem.
Odpověď na zprávu bota funguje bez další zmínky. Odpověď uvádí dodané informace o vybavení.
Potvrzení je důležité, protože údaje pozvánky se objeví ve skupině. Quickchat AI vyžaduje rozhodnutí v účtu, než skupinu použije jako cíl Agenta. Neznámou skupinu nepotvrzujte. Stejnou hranici popisuje dokumentace připojení Telegramu.
Potvrzení dokončete, než nastavení opustíte. Pokud bot odejde z nepotvrzené skupiny, vygenerujte nový odkaz Add to a Telegram group, znovu jej přidejte a čekající skupinu ihned potvrďte v Quickchat AI. Přidání bota přes vyhledávání členů v Telegramu tento postup připojení nenahrazuje.
Odznak Admin označuje stav bota v Telegramu. Pro běžné odpovědi sdíleného bota není nutný. Ani přidělení správce nezmění pravidlo odpovídat pouze na zmínky a reakce.
Krok 3: Jak povolit soukromé chaty v Telegramu?
Zapněte Direct message link a sdílejte celou vygenerovanou URL. Odkaz vybere vašeho Agenta uvnitř sdíleného bota, takže zákazníci mohou psát soukromě bez přidání do skupiny.
Skupina je společná konverzace. Osobní údaje a předání pracovníkovi patří do soukromých zpráv.
- Vyberte soukromého Agenta Saltmarsh Sailing School. V External Apps > Telegram zapněte Direct message link. Skupinová připojení nechte prázdná.
- Zkopírujte vygenerovaný odkaz. Zachovejte parametr
start=; samotný odkaz na sdíleného bota vašeho Agenta neurčuje. - Otevřete odkaz v Telegramu a případně stiskněte Start.
- Bez zmínky bota napište
How much is Start Sailing?. Ověřte odpověď školy a najděte konverzaci v Inbox. - Připněte odkaz do uvítací zprávy skupiny, aby ho členové našli před sdílením osobních údajů.
Použijte odkaz vygenerovaný pro svého Agenta. Zobrazené lokální nastavení nedokládá doručení do živého Telegramu.
Telegram po stisknutí Start doručil uvítání Saltmarsh. Dále ověřte odpověď ze znalostí; samotný pozdrav netestuje vyhledávání informací.
Dva výřezy téže obrazovky Telegramu ukazují připnutou pozvánku. Hodnota start ukázkového odkazu je vynechána; připněte vlastní úplný vygenerovaný odkaz.
Soukromý chat se sdíleným botem je vždy propojen s jedním Agentem. Otevření odkazu jiného Agenta může propojení přepnout. Pro vlastní identitu v Telegramu a samostatné vlákno použijte vlastního bota.
Vypnutí Direct message link zabrání novým připojením přes odkaz. Existující chat zastavíte jeho přepínačem nebo pomocí Disconnect. Odkaz je veřejný vstup, nikoli ochrana přístupu k důvěrným znalostem.
Krok 4: Jak uložit žádost o zkušební lekci do Google Sheets?
Integrace Google Sheets vytvoří tabulku a Action pro přidávání řádků. Upravte Action pro tři povinná pole poptávky a pak ověřte skutečný řádek. Tento volitelný krok funguje se sdíleným botem Telegram.
Výsledkem je poptávka k vyřízení člověkem. Nerezervuje místo ani neurčuje cenu zkušební lekce.
Připojte Sheets a nastavte jednu Action
- U Saltmarsh Sailing School otevřete Actions & MCPs > Add Action > Google Sheets a vyberte Connect Google Sheets. Přihlaste se ke správnému účtu Google a schvalte požadovaný přístup.
- Otevřete vytvořenou tabulku Quickchat Leads. Název listu Leads zachovejte, protože na něj míří vygenerovaná URL Action.
- Nahraďte záhlaví v tomto pořadí:
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - V Actions & MCPs upravte vytvořenou Action
log_lead_to_google_sheetpodle receptu níže. Parametry, tělo požadavku a záhlaví tabulky měňte společně, aby souhlasilo jejich pořadí.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Jméno uvedené zájemcem o zkušební lekci. Pokud chybí, zeptejte se. | Ano |
| Text | preferred_weekday | Preferovaný den v týdnu, například úterý. Jde o přání, nikoli potvrzený termín. | Ano |
| Text | sailing_experience | Uvedené zkušenosti s plachtěním, například začátečník. Pokud chybí, zeptejte se; neodvozujte je. | Ano |
U všech tří parametrů nastavte No default a odstraňte výchozí parametry e-mailu a dotazu. Recept se ptá pouze na tato tři pole. Uživatelské jméno Telegramu je volitelné a není spolehlivým povinným kontaktem; uložený odkaz na konverzaci umožní pracovníkům na poptávku navázat.
Metoda a URL: ponechte vytvořenou URL POST. Už obsahuje ID tabulky, list Leads a valueInputOption=RAW. Žádné zástupné ID tabulky nevyplňujete.
Hlavičky: ponechte nastavení integrace.
| Hlavička | Hodnota |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
Na kartě Body v API Endpoint použijte:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Pomocí Add AI Data vložte podle potřeby parametry a proměnné konverzace. První tři hodnoty pocházejí z rozhovoru, poslední dvě dodává 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.
Otevřete Advanced settings > Run only when a přidejte telegram_chat_type equals private. Použijte samotný klíč metadat bez metadata_ a závorek. Podmínka zablokuje HTTP požadavek ze skupiny, i kdyby jej model zkusil spustit. Kontrolu popisuje dokumentace podmínek spuštění.
Nastavte Response filter na $.updates.updatedRows, aby Action vracela počet řádků místo zbytečně rozsáhlé odpovědi poskytovatele. Action nechte zapnutou.
Samotný klíč je telegram_chat_type. Podmínka se ověřuje před odesláním požadavku.
Lokální nastavení receptu. URL Sheets a autorizaci OAuth musí vytvořit vaše vlastní připojení Google.
Ověřte řádek a potom neúplnou žádost
Přes soukromý odkaz Agenta v Telegramu odešlete:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Ověřte všechny tři části: odpověď popisuje poptávku, karta Action v Inbox ukazuje zadané hodnoty a skutečný list Leads obsahuje odpovídající řádek. Ujišťující odpověď ani vysoké skóre Simulation nedokazují zápis do Google Sheets.
Agent zaznamenal zadané jméno, preferenci úterý a začátečnické zkušenosti. Dostupnost a přesnou cenu musí stále potvrdit kancelář.
Dva detaily stejného uloženého řádku zachovávají čitelnost všech pěti sloupců. Odkaz na konverzaci v konkrétním účtu je skrytý; ostatní čtyři hodnoty zůstaly beze změny.
Samostatný test začněte zprávou I would like a trial lesson. Před spuštěním Action má Agent postupně vyžádat chybějící údaje, vždy jednou otázkou. Zkuste také How much is Start Sailing?; běžný dotaz na kurz nesmí vytvořit řádek. Prompt požaduje jeden zápis na žádost, ale tento recept není idempotentní rezervační systém. Před provozním použitím prověřte duplicity.
Krok 5: Jak předat konverzaci z Telegramu člověku?
Nastavte Human Handoff a potom v Inbox ověřte přiřazení konverzace. Pokyn „kancelář odpoví“ sám nepředá odpovědnost ani nepozastaví AI.
Kontrolním bodem je změna přiřazení. Případ dokončí člověk; případný návrat k AI ověřte zvlášť.
- Vyberte Saltmarsh Sailing School, otevřete Actions & MCPs > Human Handoff a zapněte ho. U Saltmarsh Group tuto Action nechte vypnutou.
- V Handoff Rules klikněte na +. Do Rule Name zadejte
Private enquiries, do Description vložtehandoff-rule.txta zapněte State. Nové řádky jsou neaktivní. Pravidlo soukromého Agenta pokrývá refundace, stížnosti, žádosti o člověka a přijetí nabídnuté lidské pomoci. - Vymažte Keywords, vypněte předdefinovaná pravidla a uložte pouze jedno aktivní vlastní pravidlo. Skupinu izoluje vypnutý Human Handoff na samostatném skupinovém Agentovi; vlastní pravidlo určuje, kdy předává soukromý Agent.
- Do Confirmation vložte
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Human Agents’ availability nastavte podle skutečných hodin obsluhy a mimo ně použijte pravdivou zprávu. - Ze soukromého chatu Telegram odešlete
I want a refund for last week. Can I speak to a person?. - V Inbox najděte konverzaci, ověřte přiřazení, vyberte Assign to me a odešlete
Hi, I’m Alex from the office. I’ll review your request.Ověřte doručení do Telegramu. - Když konverzaci vlastní člověk, odešlete další zákaznickou zprávu. AI má mlčet. Operátor má případ dokončit a vyřešit v Inbox. Návrat k AI testujte samostatně.
State vlastního pravidla je zapnutý. Předdefinované spouštěče jsou vypnuté, takže kontrolujete jediné pravidlo.
Žádost ve skutečném Telegramu spustila Handoff. Přiřazení v Inbox a odchozí odpověď operátora byly ověřeny samostatně.
Při živé kontrole konverzace přešla do Unassigned, připravená k převzetí člověkem. Operátor zvolil Assign to me, odeslal odpověď kanceláře a Telegram ji přijal. Snímek výše ukazuje odpověď při předání; pozdější zprávu operátora nezobrazuje. Při opakování testu ověřte přiřazení i doručení.
Ponechte případ operátorovi, dokud nebude vyřešen. V našem lokálním testu vrácení peněz návrat k AI Agent umožnil jednu odpověď, než se Handoff spustil znovu. Návrat k AI vyžaduje vlastní úspěšný navazující test; není součástí kritérií dokončení tohoto postupu. Průvodce předáváním člověku podrobněji rozebírá personální zajištění a odpovědnost.
Krok 6: Jak otestovat celého chatbota pro Telegram?
Pomocí Testing opakovaně kontrolujte odpovědi a odděleně ověřte živý Telegram a vnější účinky. Model může odpovědět správně, přestože selže připojení skupiny, zápis do tabulky nebo doručení při předání.
Ověřujte systém odpovědný za výsledek: znalosti pro fakta, logy Action pro požadavky, Sheets pro řádky a Telegram pro doručení.
Spusťte opakovatelnou sadu otázek
- Otevřete Testing, vytvořte sadu
Saltmarsh: knowledge checksa zvolte Paste messages. - Vložte
simulation-messages.txt. Mezi případy zachovejte samostatné oddělovače---. - Otevřete Evaluation criteria, vložte
evaluation-criteria.txtze sady a uložte. - Zvolte Run > Start Run a zkontrolujte jednotlivé odpovědi i skóre.
Při změně jednoho pokynu zachovejte stejné otázky, aby porovnání mělo smysl.
Čtěte odpovědi, nejen skóre. Jde o lokální testy znalostí, nikoli doručení do Telegramu.
Hodnotitel potřebuje fakta školy pro posouzení přesnosti. Musí také vědět, že přepis nedokazuje řádek v tabulce, doručení do Telegramu ani změnu přiřazení. Standardní textová Simulation neposkytuje metadata chatu Telegram, takže jejich nepřítomnost neznamená poruchu podmínky pouze pro soukromé chaty. Kontroly závislé na kanálu provádějte ve skutečném soukromém chatu.
Co změnily lokální testy?
Původní návrh používal jednoho Agenta pro oba vstupy. Lokální test ukázal, že skupinová žádost o vrácení peněz předala sdílenou konverzaci přes Human Handoff. Agenty jsme oddělili a u skupinového Agenta vypnuli Handoff i Actions pro příjem poptávek. Opakované skupinové kontroly vrácení peněz a zkušebních lekcí pak odkázaly na připnutý soukromý odkaz a ponechaly konverzaci přiřazenou AI. Proto krok 1 odděluje obě konverzace pomocí nastavení i instrukcí.
Deset závěrečných lokálních kontrol znalostí získalo po 5/5 a oba hostovaní Agenti prošli stejnými deseti případy. Tyto malé běhy nejsou odhadem přesnosti v produkci. Živá skupina také odpověděla na otázky o ceně kurzu a vybavení a poté odmítla potvrdit půjčování neoprenů. Při úpravě sady zachovejte případy s chybějícími fakty; samotné správné ceny zdrženlivost Agenta netestují.
Chybějící znalosti vedou k odpovědi „nelze potvrdit“. Samostatná zpráva o kódu brány neoslovuje bota a na tomto snímku není vidět odpověď na ni.
Skutečná soukromá žádost o zkušební lekci vyvolala jedno úspěšné volání Sheets Action s hodnotami Alex Morgan, Tuesday a beginner. Google vrátil HTTP 200 a jeden aktualizovaný řádek; uložený řádek obsahoval také odkaz na konverzaci a kanál telegram. Samostatný test Action s metadaty skupinového chatu neodeslal žádný HTTP požadavek. Při úpravě podmínky ověřte přijatou soukromou žádost i odmítnutý skupinový kontext.
Ověřte kanál a jeho vnější účinky
Vlastní pozorování zapisujte do prázdného test-matrix.csv ze sady. Snímky výše ukazují předvedené výsledky; tabulka obsahuje také kontroly pro vlastní nastavení. Při testování mlčení zaznamenejte uplynulý čas a oddělujte převzetí člověkem od případného pozdějšího návratu k AI.
| Kontrola | Zpráva nebo úkon | Očekávaný výsledek |
|---|---|---|
| Zmínka ve skupině | @QuickchatAI_bot How much is Start Sailing? | Stručná odpověď s EUR 240; stejná výměna v Inbox. |
| Odpověď botovi | What should I bring? | Seznam vybavení bez další zmínky. |
| Běžný rozhovor | Does anyone know the gate code? bez zmínky | Sdílený bot neodpoví. |
| Chybějící znalost | Zmiňte bota a zeptejte se Do you rent wetsuits? | Nelze potvrdit; žádné vymyšlené ano či ne. |
| Osobní žádost ve skupině | Zmiňte bota a požádejte o refundaci | Odkaz do soukromého chatu; skupina zůstává u AI. |
| Soukromá odpověď | Otevřete úplný DM odkaz a zeptejte se na cenu | Správný Agent odpoví bez zmínky. |
| Úplná žádost o lekci | Odešlete zprávu Alex Morgan z kroku 4 | Parametry Action souhlasí se skutečným řádkem Sheets; žádné potvrzení rezervace. |
| Soukromé předání | Požádejte o refundaci a po převzetí znovu napište | Přiřazení člověku, doručení jeho odpovědi a žádná další AI odpověď. |
| Pravidla počasí | What happens if the forecast says 30 knots? | Bezplatný přesun a rozhodnutí instruktora; žádná tvrzení o aktuální předpovědi. |
Pokud kontrola selže, změňte jedno relevantní nastavení a zopakujte stejnou zprávu. Chybějící fakt opravte v Knowledge Base, předčasnou Action v popisu či povinných parametrech; u mlčící skupiny nejprve ověřte potvrzení a oslovení bota. Neúspěšný výsledek zachovejte pro porovnání.
Kdy vytvořit vlastního bota pomocí BotFather?
Vlastního bota potřebujete pro vlastní jméno a obrázek, Actions využívající Telegram Bot API nebo příjem běžných skupinových zpráv. Pro předchozí postupy ve skupinách a soukromých chatech sdílený bot stačí.
Před přidáním druhého bota vyberte potřebnou identitu a chování zpráv.
| Požadavek | Sdílený bot Quickchat AI | Vlastní bot |
|---|---|---|
| Token BotFather | Není nutný | Nutný |
| Vlastní jméno a obrázek v Telegramu | Sdílená identita | Identita vašeho bota |
| Odpovědi na zmínky a reakce ve skupině | Ano | Ano, pokud je Telegram doručí |
| Odpovědi na běžné skupinové zprávy | Sdílený bot mlčí | Nastavte soukromí Telegramu nebo oprávnění správce |
| Soukromé konverzace | Odkaz start pro konkrétního Agenta ve sdíleném botovi | Vlastní soukromé vlákno bota |
| Google Sheets Action | Podporována | Podporována |
| Actions pro moderování Telegramu | Sdílený token není dostupný | Vlastní token dostupný jako System Token |
- V Telegramu otevřete ověřený účet BotFather a odešlete
/newbot. - Zvolte zobrazované jméno a volné uživatelské jméno končící na
bot. BotFather vydá token. Uchovejte ho v tajnosti. - Pokud tento bot bude v nějaké skupině, vyberte Saltmarsh Group. Saltmarsh Sailing School používejte pouze pro soukromé chaty. V External Apps > Telegram otevřete Your own bot a vyberte Connect to Telegram.
- Vložte token do Bot Token a dokončete připojení. Ověřte zapnuté Enable your own bot.
- Otevřete odkaz bota v Telegramu, odešlete
/starta stejnou otázku na cenu kurzu. - Pro doručování běžných skupinových zpráv použijte v BotFather
/setprivacy, vyberte bota a Disable, pak ho ze skupiny odeberte a znovu přidejte. Běžné zprávy dostává i bot správce. Pravidla vysvětluje dokumentace režimu soukromí Telegramu.
Token vložte pouze do Bot Token. Pole je prázdné, aby nebyl zveřejněn přihlašovací údaj.
Sdíleného a vlastního bota ponechte v oddělených skupinách. Současné spuštění může vytvářet duplicitní odpovědi. Pro připínání oznámení nebo moderování pokračujte návodem ke správě skupiny Telegram včetně podmínek Actions omezených na správce.
Může ChatGPT nebo Claude pomoci s nastavením chatbota pro Telegram?
Připojená aplikace pro správu účtu Quickchat AI může vytvořit Agenta, přidat znalosti, upravit podporovaná nastavení a spustit testy. Pokud klient zpřístupňuje nastavení Telegramu, může zapnout odkaz na soukromý chat sdíleného bota. Výběr skupiny a potvrzení v dashboardu zůstávají na vlastníkovi. Někteří klienti vyžadují dashboard také pro aktivaci soukromého odkazu a nastavení Human Handoff, proto nechte asistenta nejdříve zkontrolovat dostupné nástroje.
Připojte plugin Quickchat AI pro ChatGPT nebo konektor Claude a přiložte soubory s tímto promptem:
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.
Dostupnost nástrojů závisí na klientovi a oprávněních účtu. Přihlášení popisuje dokumentace správy účtu. Propojíte asistenta s účtem Quickchat AI; osobní konverzace ChatGPT nebo Claude se tím nestane hostovaným backendem bota Telegram.
Proč chatbot v Telegramu neodpovídá?
Než přepíšete prompt, ověřte připojení a cestu zprávy. Následující příznaky mají různé příčiny.
| Příznak | Co ověřit |
|---|---|
| Skupina je uvedena, ale mlčí | Potvrďte správnou skupinu, zapněte ji v Connected chats a zmiňte skutečné jméno bota nebo reagujte na jeho zprávu. |
| Bot odešel před první odpovědí | Vygenerujte nový odkaz Add to a Telegram group, znovu jej přidejte a čekající skupinu ihned potvrďte pomocí Confirm v Quickchat AI. |
| Samotný odkaz na bota otevře špatného Agenta | Použijte celý soukromý odkaz včetně start=. Ověřte, zda odkaz jiného Agenta nepřepnul společný soukromý chat. |
| AI po žádosti o refundaci přestala odpovídat | Zkontrolujte přiřazení v Inbox. Předaná konverzace zůstává pozastavená do záměrného přeřazení. |
| V Sheets není řádek | Ověřte zapnutou Action, všechna povinná pole, soukromý chat a URL mířící na Leads. Prohlédněte volání Action i připojení Google. |
| Vlastní bot nedostává běžné zprávy | Ověřte režim soukromí a oprávnění skupiny; po změně soukromí bota odeberte a znovu přidejte. |
| Odpověď uvádí nezadaný termín či službu | Zkontrolujte uložené znalosti ve stavu Ready a pokyn pro nejistotu. Zopakujte přesně chybnou otázku. |
| Testy přestaly odpovídat | Ověřte AI kredity a neúspěšný požadavek; vyčerpaný limit není důkaz kvality promptu. |
Před pozváním zákazníků nahraďte fiktivní fakta, zkontrolujte oddělení skupinových a soukromých konverzací a zajistěte obsluhu fronty předaných případů. Jako závěrečnou kontrolu před spuštěním požádejte kolegu, aby veřejné vstupy ověřil z jiného účtu. Pro další komunitní kanál nabízí návod k chatbotovi pro Discord srovnatelný postup tvorby a testování. Pro rozhovory s postavami použijte průvodce roleplay v Telegramu.
Volitelné kontroly nastavení: Porovnejte způsoby nasazení podle uvedených požadavků nebo počet odpovědí pro rozpočet kreditů podle zadaného rozpočtu. Kalkulačky nekontrolují váš účet, web ani zůstatek.
Nastavení Saltmarsh ke zkopírování
Zde jsou úplná zdrojová fakta a pokyny použité v návodu. Stažená sada obsahuje také recept Action, hodnoticí kritéria a testy.
Skupinový Agent: Main Prompt
Vložte text do Identity > Main Prompt u Saltmarsh Group. Human Handoff a vlastní Actions ponechte 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.
Soukromý Agent: Main Prompt
Vložte text do Identity > Main Prompt u Saltmarsh Sailing School. Název Action musí odpovídat 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 žádosti o zkušební lekce
Vložte text do pole Content první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: pravidla a informace pro členy
Vložte text do pole 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 text do Human Handoff > Handoff Rules a nastavte skutečnou dostupnost 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.
Časté otázky
Jak přidám AI chatbota do skupiny Telegram?
V Quickchat AI otevřete External Apps, vyberte Telegram a Add to a Telegram group. Vyberte skupinu v Telegramu, vraťte se do Quickchat AI a potvrďte ji pomocí Confirm. Členové pokládají otázky zmínkou sdíleného bota nebo odpovědí na jeho zprávu.
Odpovídá AI chatbot v Telegramu na každou zprávu?
Sdílený bot Quickchat AI odpovídá ve skupině na zmínky a reakce na své zprávy. Běžný rozhovor odpověď nespouští. Vlastní bot může dostávat běžné zprávy při vypnutém režimu soukromí Telegramu nebo s oprávněním správce. Toto nastavení otestujte v samostatné skupině.
Potřebuji BotFather nebo token bota Telegram?
Pro sdíleného bota a jeho soukromý odkaz nepotřebujete BotFather ani token. Vlastního bota přes BotFather vytvořte pro vlastní jméno a obrázek nebo Actions volající Telegram Bot API. Běžné Google Sheets Actions fungují i se sdíleným botem.
Mohou zákazníci chatbotovi v Telegramu psát soukromě?
Ano. V Quickchat AI zapněte Direct message link a sdílejte celý vygenerovaný odkaz. Zákazník jej otevře a případně stiskne Start. Odkaz vybere vašeho Agenta ve sdíleném botovi. Vypnutí odkazu zabrání novým připojením; existující soukromé chaty mají vlastní přepínače a ovládání odpojení.
Je AI chatbot pro Telegram zdarma?
Vytvoření bota v BotFather samo nepřidá AI službu. Quickchat AI nabízí plán Free pro osobní nekomerční učení s omezenými AI kredity. Komerční nasazení vyžaduje placený plán. Odpovědi, Preview a Simulation spotřebovávají kredity a externí služby mohou mít vlastní náklady.
Má Telegram AI chatboty?
Telegram podporuje AI boty a integrace třetích stran. Tento návod připojuje Agenta Quickchat AI odpovídajícího ze znalostí vaší firmy. BotFather vytváří identitu bota; neposkytuje znalosti ani nenastavuje proces zákaznické podpory.
Rozumí chatbot fotografiím a souborům?
Integrace Telegram přijímá fotografie a umí analyzovat jejich obrazový obsah. Ostatní soubory mohou dorazit jako přílohy, jejich obsah se však automaticky nečte. Otestujte skutečné typy souborů zákazníků a zkontrolujte Telegram i Inbox.
Mohu vytvořit roleplay bota nebo postavu pro Telegram?
Ano. Stejné připojení Telegramu může obsluhovat Agenta s identitou postavy a vhodnými pokyny. Návod používá firemní podporu; roleplay Agent potřebuje vlastní prompt a testy.