Telegram-bot készítése BotFatherrel és AI hozzáadása

Piotr Grudzień
Megjelent 18 perc olvasás
Telegram-bot készítése BotFatherrel és Quickchat AI-val, mellette valódi Fernway-beszélgetés kurzusválaszokkal, PDF-melléklettel és emberi válasszal

Telegram-bot készítéséhez nyisd meg a BotFathert, küldd el a /newbot parancsot, válassz nevet és felhasználónevet, majd másold a bot tokenjét az őt működtető szolgáltatásba. Ebben az útmutatóban ez a Quickchat AI: saját tudásodból válaszoló AI Agentet ad a bothoz, kódírás és szerverüzemeltetés nélkül.

A Fernway Languages nevű fiktív online angoliskolát építed fel. A diák megnyithatja a Telegram-botját, ellenőrizheti a kurzusárakat, megérintheti a /schedule parancsot, PDF-kurzusismertetőt kérhet, és emberhez fordulhat. A teljes élmény a diák Telegram-beszélgetésében marad; a csapatod a Quickchat AI-ban kezeli a tudást, az Actions elemeit és a beszélgetéseket.

A Fernway Languages a Telegramban kurzusárakra és órarendre válaszol, majd elküldi a kért PDF-kurzusismertetőt

A kész bot a Telegramban. A kurzusválaszok a tudásából származnak, a brosúra pedig valódi PDF-mellékletként érkezik.

Az alapbeállítás a bot létrehozásától a válaszok teszteléséig tart. Ezután add hozzá a PDF-küldést és az embernek átadást. A csoportos beszélgetésről szóló rész elmagyarázza, hogyan maradjanak kiszámíthatók a válaszok egy közös beszélgetésben.

Töltsd le a Fernway beállítási csomagját a tudásanyaggal, Main Prompt szöveggel, parancslistával, tesztlappal, avatarral és minta-PDF-fel. A fájlok szerkeszthető példák, amelyeket a kezelőfelületre illeszthetsz, nem automatikus Agent-import.

A képernyőképek, a felület elemeinek neve és a másolható demóanyagok angolul maradnak, hogy pontosan megismételhesd a bemutatott példát.

Mire van szükség Telegram-bot készítéséhez kódolás nélkül?

Telegram-fiókra, Quickchat AI-fiókra és egy új botra van szükséged a gyakorlathoz. A BotFather hozza létre a Telegram-identitást; a Quickchat AI működteti a mögötte álló Agentet.

  1. Jelentkezz be a Telegramba mobilon vagy számítógépen. Az 1. lépésben hivatkozott hivatalos BotFathert használd, ne egy hasonló nevű fiókot.
  2. Hozz létre Quickchat AI-fiókot, és szükség esetén erősítsd meg az e-mail-címedet. A Free csomag a benne foglalt keretig személyes, nem üzleti tanulásra használható. Valódi üzleti bevezetéshez válassz kereskedelmi csomagot. Az AI-válaszok és a Simulation Testing krediteket fogyasztanak; lásd az aktuális csomagokat és kereteket.
  3. Hagyd nyitva mindkét alkalmazást. Használj új tesztbotot, hogy a gyakorlat ne módosítson meglévő támogatási csatornát. Egy második Telegram-fiók hasznos az első látogatás élményének ellenőrzéséhez.

A Telegram nem kér díjat a bot regisztrálásáért. Az AI-válaszokat generáló szolgáltatás saját használati kerettel rendelkezik. Ehhez a beállításhoz nem kell külön modell-API-kulcs.

Mit csinál a BotFather, és mit az AI?

A BotFather kezeli a bot identitását és beállításait. A csatlakoztatott Agent tudása és utasításai alapján dönti el, hogyan válaszoljon. A bot puszta létrehozása nem ad neki kurzusinformációkat vagy üzenetekre válaszoló programot.

Ábra, amely elkülöníti a BotFather identitásbeállításait a Telegram-üzenetektől és a Quickchat AI válaszaitól A Telegram továbbítja a diák üzenetét a csatlakoztatott szolgáltatásnak. Az Agent válasza ugyanabba a beszélgetésbe tér vissza.

ÖsszetevőMit állítasz beMit lát a diák
BotFatherNév, felhasználónév, profilkép, leírás, parancsmenü és adatvédelmi módA bot identitását és a kapcsolatfelvételi lehetőségeket
Quickchat AIKnowledge Base, Main Prompt, üdvözlő üzenet és ActionsKurzusválaszokat, a kért PDF-et és az átadást
A csapatodPontos kurzusinformációk és figyelt InboxEmberi választ, amikor a beszélgetéshez ez kell

1. lépés: Hogyan készítesz Telegram-botot a BotFatherben?

Küldd el a /newbot parancsot a hivatalos BotFathernek, majd adj meg egy megjelenítési nevet és egyedi felhasználónevet.

  1. Nyisd meg a @BotFather fiókot a Telegramban, és válaszd a Start lehetőséget.
  2. Küldd el a /newbot parancsot.
  3. Amikor nevet kér, küldd el: Fernway Languages. Ezt a megjelenítési nevet látják a diákok.
  4. Felhasználónévként válassz például fernway_lessons_yourname_bot nevet. A yourname részt cseréld egyedire. Használj 5 és 32 közötti számú latin betűt, számjegyet vagy aláhúzást; a kis- és nagybetűk nem különböznek. Ehhez a szokásos ingyenes beállításhoz bot végű nevet használj. Ha foglalt, próbálj másik egyedi részt. A jogosult Premium-fiókoknak a BotFather más végződéseket is kínál.
  5. A BotFather visszaadja a bot hivatkozását és hitelesítési tokenjét. Mentsd el a hivatkozást; ezzel nyitod meg a diákoknak szánt beszélgetést. A tokent tartsd titokban a 4. lépéshez.

A parancsos felület elegendő ehhez az útmutatóhoz. A BotFather Mini Appot is kínálhat a botok kezelésére; ha a képernyőd eltér, használd az alábbi parancsokat.

Beszélgetés az ellenőrzött BotFatherrel: newbot parancs, Fernway Languages név és létrehozási visszaigazolás, kitakart felhasználónévvel és hitelesítési adattal

A BotFather létrehozza az identitást, és visszaadja a hivatkozását és hitelesítési adatát. A tesztfelhasználónév és a teljes token ki van takarva.

Hol találod a Telegram-botod tokenjét?

Küldd el a /mybots parancsot a BotFathernek, válaszd ki a botot, és nyisd meg az API Token lehetőséget. A token hitelesíti a bot nevében végrehajtott kéréseket. Kizárólag a szolgáltatás erre szolgáló hitelesítési mezőjébe illeszd, ne az Agent promptjába, tudásába, támogatási beszélgetésbe vagy képernyőképre.

Ha a token kikerül, küldd el a /revoke parancsot a BotFathernek, válaszd ki a botot, és kérj újat. Frissítsd a csatlakoztatott szolgáltatást az új tokennel, majd tesztelj egy választ. A régi adat nem működik tovább; a bot átnevezése vagy egy képernyőkép törlése nem érvényteleníti.

Egy webhooknak egy célpontja van. Ugyanannak a botnak másik szolgáltatáshoz kapcsolása felülírhatja a Quickchat AI-hoz érkező üzeneteket kézbesítő webhookot. Külön szolgáltatások ugyanazzal a tokennel indíthatnak kimenő API-hívásokat, de nem kapnak automatikusan külön-külön másolatot a bejövő frissítésekről. A Telegram a getUpdates lekérdezést is tiltja, amíg webhook van beállítva. Külön bejövő folyamathoz használj külön botot. A két megoldást a Telegram frissítéskézbesítési dokumentációja magyarázza el.

2. lépés: Hogyan adsz hozzá képet, leírást és parancsmenüt?

A BotFather profilparancsaival tedd felismerhetővé a botot már a diák első üzenete előtt. Minden parancs után válaszd ki a botot, és küldd el az alábbi értéket.

Ezt küldd a BotFathernekEzután ezt add megItt jelenik meg
/setnameFernway LanguagesA megjelenítési név a Telegramban
/setuserpicTöltsd fel a csomagból a fernway-avatar.png fájltA profilkép
/setdescriptionAz alábbi leírásA beszélgetés megkezdése előtti bemutatkozás
/setabouttextAz alábbi rövid profilszövegA bot profilja és a megosztott hivatkozás előnézete
/setcommandsAz alábbi parancslistaA diákok által használt beszélgetési menü

Description (legfeljebb 512 karakter):

Ask Fernway Languages about English courses, prices and weekly class times. Request the course guide or ask to speak to the team. This is a fictional school built for a tutorial.

About text (legfeljebb 120 karakter):

English courses, prices and class times. A fictional school for a Quickchat AI tutorial.

Parancslista: ezt a négy sort együtt illeszd be. Ebben a BotFather-listában a parancsnevek elején nincs perjel.

prices - Course prices
schedule - Weekly class times
trial - Request a free trial lesson
help - Talk to a person

Nyisd meg a bot profilját, és ellenőrizd a nevét, képét és profilszövegét. A Start kiválasztása előtt nyisd meg a beszélgetést a bemutatkozás ellenőrzéséhez. A Telegram az egyes beállításokat a BotFather útmutatójában ismerteti.

Miután a 4. lépésben csatlakoztattad a botot és kiválasztottad a Start lehetőséget, nyisd meg a parancsmenüt, és ellenőrizd mind a négy elemet. BotFatherbe illesztéskor tartsd meg a sortöréseket; különben több elem egyetlen hosszú parancsleírássá válhat.

A Fernway Languages Telegram-parancsmenüje prices, schedule, trial és help elemekkel a beállított üdvözlő üzenet alatt

A kész menünek négy külön eleme van. A fölötte lévő üdvözlést a 3. lépésben állítod be a Quickchat AI-ban.

Parancsfolyamat: a BotFather hozzáadja a menüelemet, a Telegram elküldi a parancsszöveget, a Main Prompt pedig meghatározza a jelentését A /schedule menübe helyezése nem valósítja meg az órarend lekérését. A következő lépés mondja meg az Agentnek, mit jelent ez az üzenet.

3. lépés: Hogyan válaszoljon a Telegram-bot a saját tudásodból?

Hozz létre egy Agentet, add az iskola tényeit a Knowledge Base tartalmához, majd helyezd a válaszadási szabályokat a Main Prompt mezőbe. A tények és az utasítások különválasztásával könnyebb árat módosítani a bot viselkedésének megváltoztatása nélkül.

A képernyőképek kiválasztva teljes méretben nyílnak meg. A pontos szöveghez és kérésértékekhez a másolható blokkokat használd.

Add hozzá a kurzusadatokat

  1. A Quickchat AI-ban hozz létre új Agentet Fernway Languages néven. Az Identity alatt ugyanazt a nevet állítsd be.
  2. Nyisd meg a Knowledge Base részt, válaszd az Add Article lehetőséget, és a Title értéke legyen Fernway Languages course guide.
  3. Illeszd az alábbi szöveget a Content mezőbe, majd válaszd a Save lehetőséget. Várd meg a feldolgozást és a Ready állapotot. A valódi csatorna tesztelése előtt hajtsd végre az esetleg megjelenő közzétételi vagy alkalmazási lépést.

A Fernway tudáscikk szerkesztője a címmel, kurzusárakkal és heti órarenddel A tényeket a Knowledge Base alatt add hozzá. Az alábbi teljes, másolható cikk a próbaórák, visszatérítések és szintbesorolás szabályait is tartalmazza.

A Fernway tudáscikk másolása
Fernway Languages is a fictional online English school used for this tutorial.

Courses
B1 English: EUR120 total for a four-week course. Classes are on Tuesdays and Thursdays, 18:00 to 19:00 UTC.
A2 English: EUR90 total for a four-week course. Classes are on Mondays and Wednesdays, 18:00 to 19:00 UTC.
Both courses meet online. Prices are for the complete four-week course, not per lesson.

Trial lessons
A free trial lesson lasts 20 minutes. Ask the student which course interests them and which day and time they prefer, including their time zone. A member of the Fernway team must confirm availability. The bot cannot book or confirm a trial lesson.

Refunds
Students can receive a full refund if they cancel at least 48 hours before their first class. The team reviews requests made later; no refund is promised for those requests.

Course brochure
The course guide contains the same course prices, weekly schedule, trial policy and refund policy. Send it only when the student asks for the brochure or course guide.

Placement
The team handles level placement. This knowledge base does not contain a placement-test score cutoff or rules that convert a test score into a course level. Do not invent a cutoff or interpret a student's score.

A hiányzó besorolási ponthatár értelmes tesztet ad. Az Agent forrás alapján meg tudja mondani a B1 árát, de nem találhatja ki a felvételhez szükséges pontszámot.

Adj jelentést a parancsoknak

Nyisd meg az Identity részt, válaszd az Edit jelzésű Main Prompt kártyát, és illeszd be az alábbi teljes promptot. Várd meg az automatikus mentést, majd nyisd meg újra az elmentett szöveg ellenőrzéséhez.

A Fernway Languages Identity oldala a Name mezővel és szerkeszthető Main Prompt kártyával Az Identity alatt nyisd meg a Main Prompt kártyát. A szabályai adják a Telegram-parancsok jelentését.

A teljes Main Prompt másolása
You are the Fernway Languages assistant. Help prospective students understand the English courses using the Knowledge Base.

Answer the student's question directly. Use plain text, short paragraphs and no Markdown tables. Keep routine answers under 100 words. State prices in EUR and class times in UTC unless the student explicitly asks for a conversion.

Treat /prices as a request for the course prices. Treat /schedule as a request for the weekly class times. Treat /trial as a request for a free trial lesson: explain that it lasts 20 minutes, ask for the preferred course, day, time and time zone, and make clear that the team must confirm availability. Treat /help as a request to speak to a person. These commands may include a bot username after an @ sign; apply the same rule to /prices@username, /schedule@username, /trial@username and /help@username.

Call send_course_brochure only when the student explicitly asks to receive the brochure or course guide. Do not call it for a price or schedule question alone. Do not ask for a chat ID, token or email address to send it. Say that the brochure was sent only after the action succeeds. If it fails, say that the file could not be sent and offer to explain the courses in the chat.

Use only the Knowledge Base for course facts and policies. If a requested fact is missing, say that the team will need to confirm it. Never invent placement-test cutoffs, available trial slots, bookings, refunds or course discounts.

If the student asks for a person, use Human Handoff. Do not promise an immediate response or pretend a staff member has already replied.

A prompt a később beállítandó, választható brosúra- és átadási lépéseket is tartalmazza. Fejezd be ezeket, mielőtt teljes diáktámogatási szolgáltatásként megosztod a botot. A prompt kérhet Actiont; nem hozza létre azt, és nem kapcsolja össze a Telegramot.

Az olyan címzett formák, mint a /schedule@your_bot, akkor fontosak, amikor a bot csoporthoz csatlakozik. Az egyszerű szövegre vonatkozó utasítás is számít: az integráció szokásos válaszai Telegram Markdown-formázás nélkül mennek ki.

Állítsd be az üdvözlő üzenetet

Nyisd meg a Your Website részt, válaszd a Text Content fület, és szerkeszd a Welcome message mezőt. Ezt a közös üdvözlést a saját Telegram-botos kapcsolat is használja:

Welcome to Fernway Languages. I can help with our English courses, prices and class times. Try /prices, /schedule or /trial, or ask a question. Use /help to ask for a person.

A Welcome message mező a Fernway üdvözlésével és javasolt parancsaival A közös Welcome message mező a Your Website → Text Content alatt található; a Telegram a /start parancshoz használja.

A saját botos integráció ezt a beállított üdvözlést küldi, amikor a látogató /start parancsot ad. Ez különbözik a BotFather beszélgetés előtti leírásától és a kurzuskérdésre adott AI-választól.

4. lépés: Hogyan kapcsolod a tokent a Quickchat AI-hoz?

A Your own bot útvonalon csatlakozz az imént létrehozott Telegram-identitás használatához.

  1. Nyisd meg az External Apps részt, válaszd a Telegram, majd a Your own bot lehetőséget.
  2. Válaszd a Connect to Telegram lehetőséget, illeszd a BotFather tokenjét a Bot Token mezőbe, majd a párbeszédpanelen válaszd a Connect to Telegram lehetőséget a beküldéshez.
  3. Kapcsold be az Enable your own bot kapcsolót, majd válaszd a Save lehetőséget.
  4. Nyisd meg a bot t.me hivatkozását a Telegramban. Válaszd a Start lehetőséget, vagy küldj /start parancsot az üdvözlés ellenőrzéséhez.

A Quickchat AI Telegram-beállításai a Your own bot alatt kapcsolt Fernway bottal és bekapcsolt Enable your own bot kapcsolóval Az élő kapcsolat panelje mutatja a bot identitását és bekapcsolt állapotát. A BotFatherben létrehozott identitáshoz a Your own bot lehetőséget használd.

Quickchat AI Connect to Telegram párbeszédpanel üres Bot Token mezővel A hitelesítési adatot ebbe a mezőbe írd. A képernyőkép szándékosan nem tartalmaz tokent.

A kezelőfelület közös Quickchat AI bot lehetősége más beállítás. Agentspecifikus beszélgetési hivatkozást ad saját bot létrehozása nélkül; a fő útmutató saját identitást és hitelesítési adatot használ. A közös változatot a Telegram AI chatbot útmutató ismerteti.

Ha a csatlakozási párbeszédpanel a csoportos adatvédelem kikapcsolását írja le, ennél a címzett parancsokra épülő útmutatónál hagyd bekapcsolva. A privát beszélgetések a csoport adatvédelmi beállításától függetlenül működnek. A különbséget a csoportokról szóló rész magyarázza el.

5. lépés: Hogyan teszteled a Telegram-botodat?

Ellenőrizd az Agent válaszát és a Telegramban kézbesített üzenetet is. A kezelőfelületi teszt a válaszlogikát igazolja; a teljes csatornát csak Telegram-beszélgetés ellenőrzi.

Teszteld a válaszokat a Quickchat AI-ban

Nyisd meg a Testing részt, válaszd a Create Dataset lehetőséget, nevezd el Fernway course answers néven, és az alábbi üzeneteket külön sorokként add hozzá:

How much is the B1 English course?
/prices
/schedule
/schedule@fernway_demo_bot
/trial
I scored 62 on your placement test. Do I qualify for B1?

A címzett parancs sora példafelhasználónévvel ellenőrzi a prompt szabályát. Az élő Telegram-teszthez a saját botod tényleges felhasználónevét használd.

Az Evaluation criteria alatt ezt használd:

Fernway Languages is a fictional English school. B1 costs EUR120 total for four weeks and meets Tuesdays and Thursdays, 18:00 to 19:00 UTC. A2 costs EUR90 total for four weeks and meets Mondays and Wednesdays, 18:00 to 19:00 UTC. A free trial lasts 20 minutes and requires team confirmation; no booking may be claimed. Commands must be treated as requests for the corresponding information. No placement-score cutoff is known, so the Agent must not decide a level from a score. Replies should be brief, plain text and based on these facts. Evaluate reply content only. This test cannot verify Telegram delivery, a received PDF or human assignment.

Elérhető AI-kreditekkel válaszd a Run lehetőséget. Minden sor külön beszélgetést indít. A további kérdéseket egy folyamatos AI Preview beszélgetésben teszteld; ne kezeld a következő adatsort a következő beszélgetési fordulóként.

Hat befejezett Fernway Simulation-teszt ár- és parancsválaszokkal, valamint a szintbesorolási kérdés eredményével Valódi helyi Simulation-eredmények. A szintbesorolási válasz alacsonyabb értékelést kapott, mert az értékelő nem látta az átadást; az Inbox megerősítette a tényleges hozzárendelés-változást.

Teszteld a diák élményét a Telegramban

Küldd az alábbiakat a valódi bot privát beszélgetésébe, minden válaszra várva. Az Inbox alatt keresd meg a hozzájuk tartozó kérdést és választ.

A szintfelmérő pontszámára vonatkozó kérdést hagyd a végére, a 6. és 7. lépés utánra. Ez átadhatja a beszélgetést a munkatársaknak, és megállíthatja az automatikus válaszokat.

Üzenet vagy műveletSikeres eredmény
/startMegjelenik a beállított üdvözlő üzenet
How much is the B1 English course?EUR120 a teljes négyhetes kurzusért
Érintsd meg a /schedule parancsot a menübenMindkét heti órarend, egyértelmű UTC-jelöléssel
Érintsd meg a /trial parancsot20 perces próbaóra iránti kérés; az elérhetőséget a csapat erősíti meg
I scored 62 on your placement test. Do I qualify for B1?Nincs kitalált ponthatár vagy jogosultsági döntés; a csapatnak kell megerősítenie

A Fernway Languages a Telegramban nem határozza meg a B1-jogosultságot 62 pontos szintfelmérő eredményből

Az élő válasz a csapatra bízza a szintbesorolási döntést. A korábbi brosúra és emberi válasz ugyanabban a beszélgetésben látható.

A Quickchat AI Inbox ugyanazzal a Telegram-szintbesorolási kérdéssel, az Agent válaszával és Unassigned beszélgetéssel A megfelelő Inbox-nézet a választ és a beszélgetés Unassigned állapotát is mutatja.

Az élő tesztben az Agent nem következtetett szintre a pontszámból. Az Inbox ezután Unassigned állapotot mutatott, bekapcsolt Lack Of Knowledge átadás mellett. A választ és a hozzárendelést külön ellenőrizd; egy válaszértékelő nem tudja megállapítani, ki kezeli a beszélgetést. Ezt a szintbesorolási tesztet a többi beszélgetési teszt után végezd, vagy az automatikus válaszok folytatása előtt válaszd az AI Agent lehetőséget az Inbox hozzárendelési menüjében.

Hibás válasznál vizsgáld meg a vonatkozó tudáscikket és mentett promptot, módosíts egy dolgot, majd ismételd meg ugyanazt az üzenetet új beszélgetésben. Parancshibánál a pontos parancsszabályt ellenőrizd; hibás kurzusárnál a tudáslekérést és a közzétételt. A tényleges választ rögzítsd, ne a kapcsolat zöld jelzése alapján tekintsd sikeresnek a beállítást.

A hatüzenetes adatkészlet kiindulópont. Az AI támogatási Agent tesztelési útmutatója bemutatja, hogyan bővítheted valósághű hibás esetekkel és értékelési szempontrendszerrel az indulás előtt.

6. lépés: Hogyan küldjön a bot PDF-et?

Adj hozzá egy API Action műveletet, amely egy rögzített kurzusismertetőt küld az aktuális Telegram-beszélgetésbe. Az Agent eldönti, hogy a diák kérte-e; az integráció adja a hitelesítési adatot és a célpontot.

A dokumentumküldő Action három rögzített forrása: System Token, az aktuális beszélgetés csatornametaadatai és egy nyilvános PDF-URL A diák nem ad meg tokent vagy chatazonosítót. Az Actionnek nincsenek modell által kitöltött paraméterei.

Töltsd le a csomagból a fernway-course-guide.pdf fájlt a minta megtekintéséhez. A beállítás az ezen az oldalon található nyilvános URL-jét használja. Saját fájlnál közvetlen HTTPS URL-t adj meg, amelyről a Telegram bejelentkezés nélkül, megfelelő tartalomtípussal kérhet le PDF-et. Az URL-ről lekért dokumentumok legyenek 20 MB alatt. A Telegram a fájlküldési dokumentációjában különbözteti meg az URL-lekérést és a fájlfeltöltést.

Nyisd meg az Actions & MCPs részt, válaszd az Add Action lehetőséget, majd az API Action szerkesztőt, és állítsd be ezeket a mezőket. Ha a szerkesztő generált piszkozatot ajánl, aktiválás előtt vesd össze a tényleges kérést a megadott beállítással.

API Action szerkesztő POST sendDocument hívással, Telegram System Token hivatkozással és az aktuális beszélgetés metaadataival a JSON-törzsben A tokenelem az URL-be, a beszélgetés metaadateleme a Body mezőbe kerül. A PDF URL-je rögzített.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
Nincsenek paraméterekNincsHagyd üresen ezt a részt. Minden kérésérték a kapcsolatból vagy a rögzített beállításból származik.Nem alkalmazható

API Endpoint: metódus és URL

Válaszd a POST metódust, és add meg:

https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument

Az Add AI Data segítségével szúrd be a telegram_bot_token értéket a System Tokens részből. Ez a csatlakoztatott bot hitelesítési adatára mutató hivatkozás, nem a token beillesztésére szolgáló hely.

Headers

KulcsÉrték
Content-Typeapplication/json

Body: illeszd be az API Endpoint Body fülére.

{
  "chat_id": "{{metadata_telegram_chat_id}}",
  "document": "https://quickchat.ai/blog-assets/tutorials/create-telegram-bot/fernway-course-guide.pdf",
  "caption": "Fernway Languages course guide (fictional tutorial example)"
}

Az Add AI Data segítségével szúrd be a telegram_chat_id értéket a beszélgetés metaadataiból. Sablonalakja {{metadata_telegram_chat_id}}. A Telegram-csatorna a bejövő beszélgetésből állítja be, így a PDF ugyanoda érkezik vissza. A dokumentum URL-jét és feliratát hagyd rögzítve.

API Action Description

Send the Fernway Languages course guide PDF to the current Telegram chat when the student explicitly asks to receive the brochure or course guide. Do not call this action for a price, schedule or trial question alone. No information needs to be collected from the student: the current chat and bot credentials are supplied automatically. Call it once per explicit request. Confirm delivery only if the request succeeds.

Mentsd és aktiváld az Actiont. A teljes Main Prompt már tartalmazza a kifejezett kérés szabályát. A Bot API metódus dokumentációja: sendDocument.

A fájlt is ellenőrizd, ne csak a választ

  1. A Telegramban küldd ezt: How much is the B1 English course?. Ellenőrizd, hogy az árat kéretlen fájl nélkül kapod meg.
  2. Küldd ezt: Can you send me the brochure?.
  3. Erősítsd meg, hogy megérkezik a PDF-melléklet, és megnyitva a Fernway kurzusismertető látható.
  4. Az Inbox alatt nyisd meg a beszélgetést, és bontsd ki a meghívott Action kártyáját. Az Actions & MCPs alatti Action-kártyán nyisd meg a View logs lehetőséget a kérés és eredmény ellenőrzéséhez. Képernyőkép megosztása előtt takard ki a tokent.
  5. Ellenőrizd, hogy az aktuális beszélgetés a célpont, és egy dokumentum ment ki a kérésre.

Az élő tesztben a send_course_brochure HTTP 200 eredményt és Telegram ok: true választ adott. A nyitó képernyőkép a diák beszélgetésébe érkezett fernway-course-guide.pdf mellékletet mutatja. A kérés eredménye és az átvett fájl együtt igazolják a kézbesítést; az Agent szöveges visszaigazolása önmagában nem.

A kézbesítési tesztet a Telegramban futtasd. A Simulation-beszélgetések nem rendelkeznek a valódi Telegram-bottoken kontextusával. A válaszok ellenőrzéséhez Simulationt, a fájlkézbesítéshez valódi Telegram-beszélgetést használj.

7. lépés: Hogyan adsz át Telegram-beszélgetést embernek?

Kapcsold be a Human Handoff funkciót, hogy az ember iránti kérés megváltoztassa a beszélgetés hozzárendelését, majd egy csapattárs válaszoljon az Inboxból.

  1. Nyisd meg az Actions & MCPs részt, kapcsold be a Human Handoff funkciót, és válaszd az Edit Action lehetőséget.
  2. Tartsd meg az alapértelmezett Handoff Rules szabályokat: Media Message, User Frustration, Customer Support Suggestion és Lack Of Knowledge bekapcsolva, Irrelevant Advice kikapcsolva. A Main Prompt már ember iránti kéréshez rendeli a /help parancsot; a demó nem ad hozzá egyéni átadási szabályt.
  3. A felügyelt gyakorlathoz hagyd kikapcsolva a Human Agents’ availability beállítást, és a teszt alatt egy csapattárs figyelje az Inboxot. Az Email notifications maradjon kikapcsolva. Ezek voltak a demó beállításai; a korlátozás nélküli átadás nem jelenti, hogy ember mindig elérhető.
  4. Indulás előtt kapcsold be az elérhetőségi ütemezést, és az időzónát, illetve munkaidőt a tényleges személyzeti jelenléthez igazítsd. Ennek megfelelően állítsd be a munkaidőn kívüli üzenetet.
  5. Mentsd az Actiont. A bot privát beszélgetésében küldd ezt: I want to talk to a person. Ha megerősítést kér, válaszolj: Yes.
  6. Az Inbox alatt ellenőrizd, hogy már nincs AI-hoz rendelve. Válaszd az Assign to me lehetőséget, és küldd ezt: Hi, this is Alex from Fernway. Which course would you like help with?. Ellenőrizd, hogy az üzenet megérkezik a Telegramban.
  7. Küldj még egy diáküzenetet, miközben ember kezeli a beszélgetést. Ellenőrizd, hogy az AI csendben marad. A hozzárendelési menüben válaszd az AI Agent lehetőséget, majd küldj új kurzuskérdést az automatikus válaszok újraindulásának ellenőrzéséhez.

Élő Telegram-beszélgetés a Quickchat AI Inboxban ember iránti kéréssel, Unassigned állapottal és Assign to me gombbal A kérés Unassigned állapotban hagyja az élő beszélgetést, hogy egy csapattárs az Assign to me segítségével átvehesse. A korábbi brosúraválasz mellett összecsukott Action-hívásjelzés is van.

Az emberi átadás folyamata az AI kurzusválaszaitól a szüneteltetett automatizáción és Inboxból küldött munkatársi válaszon át az újra-hozzárendelésig A diák a Telegramban marad. A sikeres átadáshoz hozzárendelés-változás és kézbesített emberi válasz kell. Az automatizáció folytatásához válaszd az AI Agent lehetőséget a hozzárendelési menüben.

Fernway Telegram-beszélgetés ember iránti kéréssel, átadási visszaigazolással, Alex operátori válaszával és a diák következő üzenetével

Az operátor Inbox-válasza ugyanabba a Telegram-beszélgetésbe érkezik. A diáknak nem kell alkalmazást váltania.

A Quickchat AI Inbox az operátor válaszával, a diák következő üzenetével és újra AI Agenthez rendelt beszélgetéssel Az operátor válasza után a hozzárendelés visszakerül az AI Agenthez. A következő szintbesorolási kérdés az 5. lépésben látható AI-választ kapta.

Egy hiányzó tény átadást eredményezhet, ahogyan a helyi szintbesorolási tesztben is. A két eredményt külön ellenőrizd: a válasz ne találgasson, és az állított átadás változtassa meg az Inbox hozzárendelését. A Human Handoff útmutató részletesebben ismerteti az elérhetőséget és az irányítást.

A chatbot emberi átadásának részletes útmutatója munkaidőn kívüli kérésekre és az újra-hozzárendelés utáni automatikus válaszokra is ad teszteket.

Hogyan viselkedik a bot egy Telegram-csoportban?

Az adatvédelmi mód szabályozza, mely csoportüzeneteket kézbesíti a Telegram a botnak. A Quickchat AI saját botos kapcsolata a kapott üzeneteket dolgozza fel; nem ad hozzá külön „csak említésekre válaszoljon” szűrőt.

Csoportos kézbesítési ábra: címzett parancsok és válaszok bekapcsolt adatvédelem mellett is elérik a botot; a szokásos csoportbeszélgetés kikapcsolt adatvédelemnél vagy adminisztrátor botnál érkezik meg Az ábra az útmutatóban használt üzenettípusokat mutatja. A Telegram a szolgáltatásüzeneteket és a kontextusfüggő parancsirányítást is dokumentálja.

Olyan tanulócsoportnál, ahol a bot közvetlen kérésekre válaszoljon:

  1. Küldd el a /setjoingroups parancsot a BotFathernek, válaszd ki a botot, és engedélyezd a csoporttagságot, ha ki van kapcsolva.
  2. Küldd el a /setprivacy parancsot, válaszd ki a botot, és válaszd az Enable lehetőséget. Maradjon normál tag, adminisztrátori jogok nélkül. Ha hozzáadás után módosítottad az adatvédelmet, távolítsd el és add újra hozzá a botot, hogy a beállítás érvénybe lépjen.
  3. Add a botot egy általad kezelt kis tesztcsoporthoz.
  4. Küldj hétköznapi üzenetet, például: See everyone in class tomorrow. Ebben a beállításban ez nem válthat ki választ.
  5. Küldd el a /schedule@your_bot parancsot, a your_bot helyére a valódi felhasználónevet írva. Ellenőrizd az órarendválaszt, majd azon használd a Telegram Reply gesztusát, és kérdezd: What does B1 cost?.

Az önálló /schedule attól is függhet, melyik botot szólították meg legutóbb. A sima szöveges @mention nem megbízható helyettesítője a címzett parancsnak a szokásos adatvédelmi módban. Használd a fenti teszt egyértelmű formáit. Lásd a Telegram adatvédelmi szabályait.

BotFather bekapcsolt csoporttagsággal és adatvédelmi beállítással a Fernway botnál

A mentett BotFather-beállítás Enable. A saját botoddal futtasd le a csoportüzenet-teszteket, hogy ellenőrizd a csoportbeli kézbesítést.

Az alábbi külön csoportteszt a közös @QuickchatAI_bot botot használta ugyanahhoz a Fernway Agenthez kapcsolva. Megválaszolt egy címzett órarendparancsot és a bot válaszára adott árkérdést. Ez a közös botos alternatívát szemlélteti; a saját Fernway botot privát beszélgetésben ellenőriztük, így a csoportos viselkedése még igényli a fenti teszteket.

Fernway Study Group a közös Quickchat AI bottal, amely címzett órarendparancsra és a B1 árát kérdező válaszüzenetre felel

Ez a csoport a közös @QuickchatAI_bot botot használja. A saját Fernway bot a privát beszélgetések képernyőképein látható identitás.

Az adatvédelem kikapcsolása vagy a bot adminisztrátorrá tétele a hétköznapi csoportos beszélgetést is eljuttathatja az Agenthez, több választ eredményezve. Moderáláshoz a Telegram-csoportkezelési útmutató ismerteti a további jogosultságokat és az Actions vezérlését.

A csoport egyetlen közös beszélgetés. A személyes, kurzushoz kapcsolódó érdeklődések a bot privát beszélgetésébe tartoznak. Ha a csoportban Human Handoff indul, az AI az egész csoportban szünetel az újra-hozzárendelésig; nem keletkezik külön privát beszélgetés az adott diákkal.

Miért nem válaszol a Telegram-botod?

Kezdd a legegyszerűbb privát beszélgetési teszttel, majd ellenőrizd a kapcsolatot és az üzenettípust. A csoportos viselkedés és a fájlkézbesítés további, külön függőségeket hoz.

TünetMit ellenőrizz
A BotFather létrehozta a botot, de az hallgatFejezd be az Agent csatlakoztatását. A BotFather nem ad válaszlogikát.
Nincs üdvözlésNyisd meg a megfelelő botot, küldj /start parancsot, ellenőrizd az Enable your own bot és a beállított Welcome message értékét.
Másik botszolgáltatás kipróbálása után leálltAz a szolgáltatás felülírhatta a webhookot. Csatlakoztasd újra a kívánt szolgáltatást; másik folyamathoz külön botot használj.
Tokencsere után leálltFrissítsd a Bot Token mezőt az új értékkel, és mentsd a kapcsolatot.
Privátban válaszol, csoportban nemEllenőrizd a csoporttagságot, adatvédelmet és a tényleges felhasználónevet. Próbáld a /schedule@your_bot parancsot vagy a bot üzenetére adott választ.
Minden csoportüzenetre válaszolEllenőrizd, hogy nincs-e kikapcsolva az adatvédelem, illetve nem adminisztrátor-e a bot. Térj vissza a fenti csendesebb beállításhoz.
A parancs megjelenik a menüben, de nem odaillő választ kapEllenőrizd a Main Prompt szabályát, a címzett parancsformát is. A menü regisztrálása önmagában nem határoz meg viselkedést.
Azt mondja, elküldte a PDF-et, de nincs mellékletVizsgáld meg a tényleges Action-hívást, a közvetlen PDF-URL-t és a Telegram válaszát. A Telegramban, bekapcsolt saját botos kapcsolattal tesztelj.
Az átadásig válaszol, utána leállEllenőrizd az Inbox hozzárendelését. Az emberhez rendelt vagy nem hozzárendelt beszélgetés személyzetre vagy újra-hozzárendelésre vár.
Az Agent nem tud válaszolni vagy a tesztek leállnakEllenőrizd az elérhető krediteket, a tudásfeldolgozást és az Agent bekapcsolt állapotát.
A Telegram sebességkorlátozási hibát adCsökkentsd az üzenetek gyakoriságát, és tartsd be a Telegram által visszaadott újrapróbálkozási időt.

A bot megosztása előtt saját tartalmaddal ismételd meg az ár, az ismeretlen tény, a PDF és az emberi válasz privát beszélgetési ellenőrzését. Minden Fernway-adatot és hivatkozást cserélj sajátodra. Az integráció aktuális beállításaihoz a Telegram-csatorna dokumentációját használd.

Segíthet a ChatGPT vagy a Claude a bot elkészítésében?

A Quickchat AI-fiókodhoz csatlakozó AI-kliens előkészítheti az Agentet, a tudást, az utasításokat, az Actions elemeit és a tesztadatkészletet. A Telegram-identitást továbbra is te hozod létre a BotFatherben, és a tokenjét a saját botos kezelőfelületi folyamatban adod meg.

Csatlakozz az ellenőrzött ChatGPT-listázáson vagy Claude-listázáson keresztül, a Manage with AI utasításait követve. Add az asszisztensnek a beállítási csomagot és ezt a kérést:

Create a separate learning Agent named Fernway Languages from this tutorial kit. Do not change existing Agents. Set its display name and Identity name, add the knowledge article, and copy the Main Prompt and welcome message exactly. Configure send_course_brochure from action.json but leave it inactive. Use only the System Token reference, never ask me to paste my real Telegram token into chat. Create the Fernway course-answer dataset and evaluation criteria. Prepare Human Handoff using the default rules and show me the availability settings to review. Read back the saved configuration. Do not run tests, spend credits, send Telegram messages or activate Actions yet. List the remaining owner steps: create and configure the bot in BotFather, enter its token under Your own bot, review working hours, activate the Action and complete the real-channel checks. Do not use the shared Telegram connection as a substitute for my own bot.

Az itt használt fiókkezelési kapcsolat különbözik az Agent MCP-eszközként való elérhetővé tételétől. Segíthet a folyamat beállításában, de nem helyettesíti a valódi Telegram-válasz és melléklet ellenőrzését.

Gyakori kérdések

Hogyan készíthetek Telegram-botot kódolás nélkül?

Nyisd meg a hivatalos BotFathert a Telegramban, küldd el a /newbot parancsot, és válassz megjelenítési nevet, valamint bot végű egyedi felhasználónevet. Kapcsold a kapott tokent egy botszolgáltatáshoz, például a Quickchat AI-hoz. Add hozzá a tudásodat és utasításaidat, engedélyezd a kapcsolatot, majd tesztelj privát üzenetet. A BotFather létrehozza az identitást; a csatlakoztatott szolgáltatás adja a válaszokat.

Ingyenes a Telegram-bot létrehozása?

A Telegram-bot BotFatheren keresztüli regisztrációja ingyenes. A Quickchat AI Free csomagot kínál személyes, nem üzleti tanuláshoz, korlátozott AI-kreditkerettel. Üzleti használathoz kereskedelmi csomag kell. Az AI-válaszok és a Simulation Testing krediteket fogyasztanak; a Telegram-identitás létrehozása nem jelent korlátlan AI-használatot.

Hol találom a Telegram-botom tokenjét?

Nyisd meg a hivatalos BotFathert, küldd el a /mybots parancsot, válaszd ki a botot, majd az API Token lehetőséget. Ezt a hitelesítési adatot a botszolgáltatás kijelölt Bot Token mezőjébe illeszd. Ne tedd promptba, tudáscikkbe, nyilvános kódtárba vagy képernyőképre.

Mit tegyek, ha kiszivárog a Telegram-botom tokenje?

A BotFather /revoke parancsával érvénytelenítsd a kikerült tokent, kérj újat, majd frissítsd a csatlakoztatott szolgáltatást és tesztelj választ. A nyilvánosságra került másolatot is távolítsd el, de ne csak a törlésre hagyatkozz: aki elmentette a régi tokent, a visszavonásig használhatta.

Csatlakoztathatok egy Telegram-botot két platformhoz?

A botnak egy webhookcélpontja van a bejövő frissítésekhez. Ha egy második platform felülírja ezt a webhookot, az első többé nem kapja meg őket. Több rendszer továbbra is indíthat kimenő API-hívásokat, de a bejövő üzenetek nem másolódnak automatikusan mindkettőhöz. Független bejövő folyamatokhoz külön botokat használj.

Hogyan adhatok parancsokat a Telegram-botomhoz?

Küldd el a /setcommands parancsot a BotFathernek, válaszd ki a botot, és soronként adj meg egy parancs-leírás párt, kezdő perjel nélkül. Ez létrehozza a menüt. A viselkedést is meg kell valósítanod: ebben az útmutatóban a Main Prompt rendeli a /prices, /schedule, /trial és /help parancsokat a megfelelő válaszokhoz vagy Actionhöz.

Miért válaszol a Telegram-botom privátban, de csoportban nem?

Ellenőrizd, hogy a bot a csoport tagja-e, és próbálj a tényleges felhasználónevére címzett parancsot, például /schedule@your_bot, vagy válaszolj egy üzenetére. Bekapcsolt adatvédelemnél a hétköznapi csoportos beszélgetés nem jut el a nem adminisztrátor bothoz. A sima szöveges említés nem megbízható helyettesítője a címzett parancsnak.

Adhatok AI-t vagy ChatGPT-t egy Telegram-bothoz?

Egy BotFather-botot csatlakoztathatsz AI-szolgáltatáshoz. Ez az útmutató Quickchat AI Agentet használ saját tudással, Main Prompt szöveggel és Actions elemekkel; nem a személyes ChatGPT-beszélgetésedet köti a Telegramhoz. Egy kompatibilis fiókkezelési asszisztens segíthet előkészíteni az Agentet, miközben a saját botos kapcsolatot a tulajdonos fejezi be.

Válaszolhat ez a Telegram-bot hangüzenetekre?

A Quickchat AI Telegram-integrációja jelenleg nem írja át a hangjegyzeteket az Agent számára. Hangmelléklet megjelenhet az Inboxban, de ez az útmutató írott üzenetekre épít. Kérd meg a diákot, hogy írja le a kérdését, vagy egy embert, hogy nézze meg a mellékletet.

Ez automatizálja a személyes Telegram-fiókomat?

Nem. Ez az útmutató külön botidentitást hoz létre saját felhasználónévvel. A Telegram más fiókautomatizálási funkciókat is kínál, de az itt leírt Quickchat AI-kapcsolat a botnak küldött üzeneteket kezeli; nem állít be válaszokat a személyes profilodból.

Quickchat AI Quickchat AI Ask Quickchat AI a question