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.
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.
- 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.
- 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.
- 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.
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 be | Mit lát a diák |
|---|---|---|
| BotFather | Név, felhasználónév, profilkép, leírás, parancsmenü és adatvédelmi mód | A bot identitását és a kapcsolatfelvételi lehetőségeket |
| Quickchat AI | Knowledge Base, Main Prompt, üdvözlő üzenet és Actions | Kurzusválaszokat, a kért PDF-et és az átadást |
| A csapatod | Pontos kurzusinformációk és figyelt Inbox | Emberi 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.
- Nyisd meg a @BotFather fiókot a Telegramban, és válaszd a Start lehetőséget.
- Küldd el a
/newbotparancsot. - Amikor nevet kér, küldd el:
Fernway Languages. Ezt a megjelenítési nevet látják a diákok. - Felhasználónévként válassz például
fernway_lessons_yourname_botnevet. Ayournameré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áshozbotvé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. - 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.
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 BotFathernek | Ezután ezt add meg | Itt jelenik meg |
|---|---|---|
/setname | Fernway Languages | A megjelenítési név a Telegramban |
/setuserpic | Töltsd fel a csomagból a fernway-avatar.png fájlt | A profilkép |
/setdescription | Az alábbi leírás | A beszélgetés megkezdése előtti bemutatkozás |
/setabouttext | Az alábbi rövid profilszöveg | A bot profilja és a megosztott hivatkozás előnézete |
/setcommands | Az alábbi parancslista | A 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 /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
- A Quickchat AI-ban hozz létre új Agentet
Fernway Languagesnéven. Az Identity alatt ugyanazt a nevet állítsd be. - 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. - 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 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.
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 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.
- Nyisd meg az External Apps részt, válaszd a Telegram, majd a Your own bot lehetőséget.
- 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.
- Kapcsold be az Enable your own bot kapcsolót, majd válaszd a Save lehetőséget.
- Nyisd meg a bot
t.mehivatkozását a Telegramban. Válaszd a Start lehetőséget, vagy küldj/startparancsot az üdvözlés ellenőrzéséhez.
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.
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.
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űvelet | Sikeres eredmény |
|---|---|
/start | Megjelenik 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üben | Mindkét heti órarend, egyértelmű UTC-jelöléssel |
Érintsd meg a /trial parancsot | 20 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 |
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 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 Name
send_course_brochure
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Nincsenek paraméterek | Nincs | Hagyd ü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-Type | application/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
- 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. - Küldd ezt:
Can you send me the brochure?. - Erősítsd meg, hogy megérkezik a PDF-melléklet, és megnyitva a Fernway kurzusismertető látható.
- 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.
- 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.
- Nyisd meg az Actions & MCPs részt, kapcsold be a Human Handoff funkciót, és válaszd az Edit Action lehetőséget.
- 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
/helpparancsot; a demó nem ad hozzá egyéni átadási szabályt. - 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ő.
- 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.
- 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. - 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. - 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.
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.
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.
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.
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:
- Küldd el a
/setjoingroupsparancsot a BotFathernek, válaszd ki a botot, és engedélyezd a csoporttagságot, ha ki van kapcsolva. - Küldd el a
/setprivacyparancsot, 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. - Add a botot egy általad kezelt kis tesztcsoporthoz.
- 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. - Küldd el a
/schedule@your_botparancsot, ayour_bothelyé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.
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.
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ünet | Mit ellenőrizz |
|---|---|
| A BotFather létrehozta a botot, de az hallgat | Fejezd be az Agent csatlakoztatását. A BotFather nem ad válaszlogikát. |
| Nincs üdvözlés | Nyisd 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állt | Az 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állt | Frissítsd a Bot Token mezőt az új értékkel, és mentsd a kapcsolatot. |
| Privátban válaszol, csoportban nem | Ellenő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álaszol | Ellenő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 kap | Ellenő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éklet | Vizsgá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áll | Ellenő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állnak | Ellenőrizd az elérhető krediteket, a tudásfeldolgozást és az Agent bekapcsolt állapotát. |
| A Telegram sebességkorlátozási hibát ad | Csö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.











