Kaip sukurti Telegram botą su BotFather ir pridėti AI

Piotr Grudzień
Paskelbta 15 min. skaitymo
Telegram boto kūrimas su BotFather ir Quickchat AI šalia tikro Fernway pokalbio su atsakymais apie kursus, PDF priedu ir žmogaus atsakymu

Norėdami sukurti Telegram botą, atidarykite BotFather, išsiųskite /newbot, pasirinkite pavadinimą ir naudotojo vardą, tada nukopijuokite boto žetoną į jį valdančią paslaugą. Šiame vadove tai Quickchat AI: paslauga suteikia botui AI Agentą, atsakantį pagal jūsų žinias, be kodo rašymo ar serverio priežiūros.

Sukursite Fernway Languages, išgalvotą internetinę anglų kalbos mokyklą. Mokinys gali atidaryti jos Telegram botą, patikrinti kursų kainas, paspausti /schedule, paprašyti PDF kursų gido ir žmogaus pagalbos. Visa patirtis lieka mokinio Telegram pokalbyje; jūsų komanda žinias, Actions ir pokalbius valdo Quickchat AI.

Fernway Languages Telegram atsako apie kursų kainas ir tvarkaraštį, tada pateikia paprašytą PDF kursų gidą

Paruoštas botas Telegram. Atsakymai apie kursus remiasi jo žiniomis, o brošiūra atkeliauja kaip tikras PDF priedas.

Pagrindinis nustatymas apima veiksmus nuo boto sukūrimo iki atsakymų testavimo. Tada pridėkite PDF siuntimą ir perdavimą žmogui. Skyrius apie grupės pokalbį paaiškina, kaip išlaikyti nuspėjamus atsakymus bendroje konversacijoje.

Atsisiųskite Fernway nustatymo rinkinį su žiniomis, Main Prompt, komandų sąrašu, testavimo lapu, avataru ir pavyzdiniu PDF. Failai yra redaguojami pavyzdžiai, kuriuos įklijuojate valdymo skydelyje, o ne automatinis Agento importas.

Ekrano nuotraukos, sąsajos elementų pavadinimai ir kopijuojama demonstracinė medžiaga paliekami anglų kalba, kad galėtumėte atkurti parodytą pavyzdį.

Ko reikia norint sukurti Telegram botą be programavimo?

Reikia Telegram paskyros, Quickchat AI paskyros ir naujo boto šiam pratimui. BotFather sukuria Telegram tapatybę; Quickchat AI vykdo už jos veikiantį Agentą.

  1. Prisijunkite prie Telegram telefone ar kompiuteryje. Naudokite oficialų BotFather, į kurį veda nuoroda 1 veiksme, o ne panašiai pavadintą paskyrą.
  2. Sukurkite Quickchat AI paskyrą ir, jei prašoma, patvirtinkite el. paštą. Free planas leidžia asmeniškai, nekomerciniais tikslais mokytis pagal įtrauktą limitą. Tikram verslo diegimui naudokite komercinį planą. AI atsakymai ir Simulation Testing naudoja kreditus; žr. dabartinius planus ir limitus.
  3. Palikite abi programas atidarytas. Naudokite naują bandomąjį botą, kad pratimas nepakeistų esamo aptarnavimo kanalo. Antra Telegram paskyra padeda patikrinti pirmą kartą atėjusio lankytojo patirtį.

Telegram neima mokesčio už boto registraciją. AI atsakymus generuojanti paslauga turi savo naudojimo limitą. Šiam nustatymui atskiro modelio API rakto nereikia.

Ką daro BotFather, o ką AI?

BotFather valdo boto tapatybę ir nustatymus. Prijungtas Agentas pagal žinias ir instrukcijas nusprendžia, kaip atsakyti. Vien sukurtas botas neturi informacijos apie kursus ar programos, kuri reaguotų į žinutes.

Schema, atskirianti BotFather tapatybės nustatymus nuo Telegram žinučių ir Quickchat AI atsakymų Telegram perduoda mokinio žinutę prijungtai paslaugai. Agento atsakymas grįžta į tą patį pokalbį.

DalisKą nustatoteKą mato mokinys
BotFatherPavadinimą, naudotojo vardą, profilio nuotrauką, aprašymą, komandų meniu ir privatumo režimąBoto tapatybę ir bendravimo pradžios galimybes
Quickchat AIKnowledge Base, Main Prompt, pasveikinimą ir ActionsAtsakymus apie kursus, paprašytą PDF ir perdavimą
Jūsų komandaTikslią informaciją apie kursus ir stebimą InboxŽmogaus atsakymą, kai pokalbiui jo reikia

1 veiksmas: kaip sukurti Telegram botą BotFather?

Išsiųskite /newbot oficialiam BotFather, tada pateikite rodomą pavadinimą ir unikalų naudotojo vardą.

  1. Atidarykite @BotFather Telegram ir pasirinkite Start.
  2. Išsiųskite /newbot.
  3. Paprašius pavadinimo, išsiųskite Fernway Languages. Tai mokiniams rodomas pavadinimas.
  4. Paprašius naudotojo vardo, pasirinkite, pavyzdžiui, fernway_lessons_yourname_bot. yourname pakeiskite unikalia dalimi. Naudokite nuo 5 iki 32 lotyniškų raidžių, skaitmenų ar pabraukimų; raidžių dydis nesvarbus. Šiam standartiniam nemokamam nustatymui naudokite vardą, kuris baigiasi bot. Jei vardas užimtas, bandykite kitą dalį. Reikalavimus atitinkančioms Premium paskyroms BotFather siūlo ir kitų galūnių.
  5. BotFather grąžina boto nuorodą ir autentifikavimo žetoną. Išsaugokite nuorodą; ji atidarys mokiniams skirtą pokalbį. Žetoną laikykite paslaptyje 4 veiksmui.

Šiam vadovui pakanka komandų sąsajos. BotFather gali siūlyti ir Mini App botams valdyti; jei jūsų ekranas skiriasi, naudokite toliau nurodytas komandas.

Pokalbis su patvirtintu BotFather, kuriame matyti newbot komanda, Fernway Languages pavadinimas ir sukūrimo patvirtinimas, uždengus naudotojo vardą ir žetoną

BotFather sukuria tapatybę ir grąžina jos nuorodą bei prisijungimo duomenis. Bandomasis naudotojo vardas ir visas žetonas uždengti.

Kur rasti savo Telegram boto žetoną?

Išsiųskite BotFather /mybots, pasirinkite botą ir atidarykite API Token. Žetonas autentifikuoja to boto vardu siunčiamas užklausas. Klijuokite jį tik į paslaugos tam skirtą prisijungimo duomenų lauką, ne į Agento promptą, žinias, pagalbos pokalbį ar ekrano nuotrauką.

Jei žetonas paviešinamas, išsiųskite BotFather /revoke, pasirinkite botą ir gaukite naują žetoną. Atnaujinkite prijungtą paslaugą ir išbandykite atsakymą. Seni prisijungimo duomenys nebeveiks; boto pervadinimas ar ekrano nuotraukos ištrynimas jų nepanaikina.

Webhook turi vieną paskirties adresą. To paties boto prijungimas prie kitos paslaugos gali pakeisti webhook, kuris pristato gaunamas žinutes Quickchat AI. Atskiros sistemos gali tuo pačiu žetonu atlikti siunčiamus API iškvietimus, bet kiekviena automatiškai negauna įeinančių naujinimų kopijos. Telegram taip pat neleidžia periodiškai tikrinti per getUpdates, kol nustatytas webhook. Atskiram įeinančiam procesui naudokite atskirą botą. Abu mechanizmus aiškina Telegram naujinimų pristatymo dokumentacija.

2 veiksmas: kaip pridėti nuotrauką, aprašymą ir komandų meniu?

Naudokite BotFather profilio komandas, kad botas būtų atpažįstamas dar prieš pirmą mokinio žinutę. Po kiekvienos komandos pasirinkite botą ir pateikite nurodytą reikšmę.

Siųskite BotFatherTada pateikiteKur rodoma
/setnameFernway LanguagesRodomas pavadinimas Telegram
/setuserpicĮkelkite fernway-avatar.png iš rinkinioProfilio nuotrauka
/setdescriptionToliau pateiktą aprašymąĮžanga prieš pradedant pokalbį
/setabouttextToliau pateiktą trumpą profilio tekstąBoto profilis ir bendrinamos nuorodos peržiūra
/setcommandsToliau pateiktą komandų sąrašąMeniu, kurį mokiniai pasirenka pokalbyje

Description (iki 512 simbolių):

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 (iki 120 simbolių):

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

Komandų sąrašas: įklijuokite visas keturias eilutes kartu. Šiame BotFather sąraše komandų pavadinimų pradžioje nėra pasvirojo brūkšnio.

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

Atidarykite boto profilį ir patikrinkite pavadinimą, nuotrauką ir trumpą tekstą. Prieš pasirinkdami Start, atidarykite pokalbį ir patikrinkite įžangą. Atskirus nustatymus Telegram aprašo BotFather vadove.

Prijungę botą 4 veiksme ir pasirinkę Start, atidarykite komandų meniu ir patikrinkite visus keturis punktus. Klijuodami sąrašą į BotFather išlaikykite eilučių lūžius; kitaip keli punktai gali tapti vienu ilgu komandos aprašymu.

Fernway Languages Telegram komandų meniu su prices, schedule, trial ir help po nustatytu pasveikinimu

Paruoštas meniu turi keturis atskirus punktus. Pasveikinimas virš jo nustatomas Quickchat AI 3 veiksme.

Komandos schema: BotFather prideda meniu punktą, Telegram išsiunčia komandos tekstą, o Main Prompt apibrėžia jo reikšmę Įtraukus /schedule į meniu, tvarkaraščio paieška dar neįgyvendinama. Kitas veiksmas Agentui paaiškina šios žinutės reikšmę.

3 veiksmas: kaip Telegram botas atsakys pagal jūsų žinias?

Sukurkite Agentą, pridėkite mokyklos faktus į Knowledge Base, tada atsakymų taisykles įrašykite į Main Prompt. Atskyrus faktus nuo instrukcijų lengviau pakeisti kainą nekeičiant boto elgesio.

Pasirinktos ekrano nuotraukos atidaromos visu dydžiu. Tiksliam tekstui ir užklausų reikšmėms naudokite kopijuojamus blokus.

Pridėkite informaciją apie kursus

  1. Quickchat AI sukurkite naują Agentą vardu Fernway Languages. Identity nustatykite tą patį vardą.
  2. Atidarykite Knowledge Base, pasirinkite Add Article ir į Title įrašykite Fernway Languages course guide.
  3. Įklijuokite toliau pateiktą tekstą į Content, tada pasirinkite Save. Palaukite, kol apdorojimas baigsis ir straipsnis taps Ready. Prieš tikrindami tikrą kanalą atlikite visus rodomus publikavimo ar pakeitimų taikymo veiksmus.

Fernway žinių straipsnio redaktorius su pavadinimu, kursų kainomis ir savaitiniu tvarkaraščiu Faktus pridėkite Knowledge Base. Visas toliau pateiktas kopijuojamas straipsnis apima ir bandomųjų pamokų, pinigų grąžinimo bei lygio nustatymo taisykles.

Kopijuoti Fernway žinių straipsnį
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.

Nenurodyta lygio testo balų riba suteikia prasmingą testą. Agentas gali iš šaltinio atsakyti apie B1 kainą, bet neturėtų išgalvoti mokiniui būtino priėmimo rezultato.

Suteikite komandoms reikšmę

Atidarykite Identity, pasirinkite Main Prompt kortelę su Edit žyma ir įklijuokite visą toliau pateiktą promptą. Palaukite automatinio išsaugojimo, tada vėl atidarykite ir patikrinkite išsaugotą tekstą.

Fernway Languages Identity puslapis su Name ir redaguojama Main Prompt kortele Atidarykite Main Prompt iš Identity. Jo taisyklės nustato Telegram komandų reikšmę.

Kopijuoti visą Main Prompt
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.

Šis promptas apima pasirenkamus brošiūros ir perdavimo veiksmus, kuriuos nustatysite vėliau. Užbaikite juos prieš pateikdami botą kaip visavertę mokinių aptarnavimo paslaugą. Promptas gali paprašyti Action; jis jos nesukuria ir neprijungia Telegram.

Adresuotos formos, pavyzdžiui, /schedule@your_bot, svarbios botui prisijungus prie grupės. Svarbi ir paprasto teksto instrukcija: įprasti šios integracijos atsakymai siunčiami be Telegram Markdown formatavimo.

Nustatykite pasveikinimą

Atidarykite Your Website, pasirinkite skirtuką Text Content ir redaguokite Welcome message. Šį bendrą pasveikinimą naudoja ir nuosavo Telegram boto ryšys:

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.

Welcome message laukas su Fernway pasveikinimu ir siūlomomis komandomis Bendras Welcome message laukas yra Your Website → Text Content; Telegram jį naudoja /start komandai.

Nuosavo boto integracija siunčia nustatytą pasveikinimą lankytojui išsiuntus /start. Jis atskiras nuo BotFather aprašymo prieš pokalbį ir nuo AI atsakymo į klausimą apie kursą.

4 veiksmas: kaip prijungti žetoną prie Quickchat AI?

Prisijunkite per Your own bot, kad naudotumėte ką tik sukurtą Telegram tapatybę.

  1. Atidarykite External Apps, pasirinkite Telegram, tada Your own bot.
  2. Pasirinkite Connect to Telegram, įklijuokite BotFather žetoną į Bot Token, tada dialoge pasirinkite Connect to Telegram, kad jį pateiktumėte.
  3. Įjunkite Enable your own bot, tada pasirinkite Save.
  4. Atidarykite boto t.me nuorodą Telegram. Pasirinkite Start arba išsiųskite /start, kad patikrintumėte pasveikinimą.

Telegram nustatymai Quickchat AI su prijungtu Fernway botu skiltyje Your own bot ir įjungtu Enable your own bot Tikro ryšio skydelis rodo boto tapatybę ir įjungtą būseną. BotFather sukurtai tapatybei naudokite Your own bot.

Quickchat AI Connect to Telegram dialogas su tuščiu Bot Token lauku Prisijungimo duomenis įveskite šiame lauke. Ekrano nuotraukoje žetono sąmoningai nėra.

Bendroji Quickchat AI bot parinktis valdymo skydelyje yra kitoks nustatymas. Ji suteikia konkretaus Agento pokalbio nuorodą nekuriant nuosavo boto; pagrindinis vadovas naudoja jūsų tapatybę ir prisijungimo duomenis. Bendrą variantą aprašo Telegram AI pokalbių boto vadovas.

Jei prijungimo dialoge aprašomas privatumo išjungimas grupėms, šio vadovo adresuotoms komandoms palikite jį įjungtą. Privatūs pokalbiai veikia nepriklausomai nuo grupės privatumo nustatymo. Skirtumą aiškina skyrius apie grupes.

5 veiksmas: kaip išbandyti Telegram botą?

Patikrinkite ir Agento atsakymą, ir Telegram pristatytą žinutę. Testas valdymo skydelyje tikrina atsakymo logiką; tik Telegram pokalbis patikrina visą kanalą.

Patikrinkite atsakymus Quickchat AI

Atidarykite Testing, pasirinkite Create Dataset, pavadinkite Fernway course answers ir pridėkite šias žinutes atskiromis eilutėmis:

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?

Adresuotos komandos eilutėje naudojamas pavyzdinis naudotojo vardas prompto taisyklei patikrinti. Tikrame Telegram teste naudokite tikrą savo boto vardą.

Skiltyje Evaluation criteria naudokite:

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.

Turėdami AI kreditų pasirinkite Run. Kiekviena eilutė pradeda atskirą pokalbį. Tolesnius klausimus tikrinkite viename tęstiniame AI Preview pokalbyje, nelaikydami kitos duomenų rinkinio eilutės kitu to paties dialogo žingsniu.

Šeši užbaigti Fernway Simulation testai su kainų ir komandų atsakymais bei lygio klausimo rezultatu Tikri vietiniai Simulation rezultatai. Atsakymas apie lygį įvertintas prasčiau, nes vertintojas negalėjo matyti perdavimo; Inbox patvirtino tikrą priskyrimo pasikeitimą.

Išbandykite mokinio patirtį Telegram

Išsiųskite šias žinutes tikro boto privačiame pokalbyje, kiekvieną kartą palaukdami atsakymo. Inbox raskite atitinkamą klausimą ir atsakymą.

Klausimą apie lygio testo balą palikite pabaigai, po 6 ir 7 veiksmų. Jis gali perduoti pokalbį darbuotojams ir sustabdyti automatinius atsakymus.

Žinutė arba veiksmasSėkmingas rezultatas
/startPasirodo nustatytas pasveikinimas
How much is the B1 English course?EUR120 už visą keturių savaičių kursą
Meniu paspauskite /scheduleAbu savaitiniai tvarkaraščiai su aiškia UTC žyma
Paspauskite /trial20 minučių bandomosios pamokos užklausa, o prieinamumą patvirtina komanda
I scored 62 on your placement test. Do I qualify for B1?Jokios išgalvotos ribos ar priėmimo išvados; turi patvirtinti komanda

Fernway Languages Telegram atsisako nustatyti tinkamumą B1 pagal 62 balų lygio testo rezultatą

Tikras atsakymas palieka sprendimą dėl lygio komandai. Ankstesnė brošiūra ir žmogaus atsakymas tebėra matomi tame pačiame pokalbyje.

Quickchat AI Inbox su tuo pačiu Telegram klausimu apie lygį, Agento atsakymu ir Unassigned pokalbiu Atitinkamas Inbox vaizdas rodo ir atsakymą, ir pokalbio Unassigned būseną.

Tikrame teste Agentas nenustatė lygio iš balo. Po to Inbox rodė pokalbį kaip Unassigned, kai perdavimas Lack Of Knowledge buvo įjungtas. Atsakymą ir priskyrimą tikrinkite atskirai; atsakymų vertintojas negali nustatyti, kas valdo pokalbį. Lygio patikrą atlikite po kitų pokalbio testų arba prieš tęsdami automatinius atsakymus pasirinkite AI Agent Inbox priskyrimo meniu.

Jei atsakymas klaidingas, peržiūrėkite atitinkamą žinių straipsnį ir išsaugotą promptą, pakeiskite vieną dalyką ir pakartokite tą pačią žinutę naujame pokalbyje. Jei neveikia komanda, patikrinkite tikslią jos taisyklę; jei kursų kaina klaidinga, tikrinkite žinių paiešką ir publikavimą. Užrašykite tikrą atsakymą, o ne spręskite apie sėkmę vien iš žalios ryšio būsenos.

Šešių žinučių rinkinys yra pradžia. AI aptarnavimo Agento testavimo vadovas rodo, kaip prieš paleidimą jį papildyti tikroviškais nesėkmės atvejais ir vertinimo kriterijais.

6 veiksmas: kaip padaryti, kad botas siųstų PDF?

Pridėkite vieną API Action, kuri siunčia nustatytą kursų gidą į dabartinį Telegram pokalbį. Agentas nusprendžia, ar mokinys jo paprašė; integracija pateikia prisijungimo duomenis ir gavėją.

Dokumento Action trijų pastovių šaltinių schema: System Token, dabartinio pokalbio kanalo metaduomenys ir viešas PDF URL Mokinys nepateikia žetono ar pokalbio ID. Action neturi modelio pildomų parametrų.

Atsisiųskite fernway-course-guide.pdf iš rinkinio ir peržiūrėkite pavyzdį. Nustatymas naudoja viešą jo URL šioje svetainėje. Savo failui naudokite tiesioginį HTTPS URL, iš kurio Telegram be prisijungimo gali gauti PDF su teisingu turinio tipu. Per URL gaunami dokumentai turi būti mažesni nei 20 MB. Gavimą iš URL ir failų įkėlimą Telegram skiria failų siuntimo dokumentacijoje.

Atidarykite Actions & MCPs, pasirinkite Add Action, tada API Action kūrimo priemonę ir nustatykite šiuos laukus. Jei siūlomas sugeneruotas juodraštis, prieš aktyvindami palyginkite tikrą užklausą su pateikta konfigūracija.

API Action redaktorius su POST sendDocument, Telegram System Token nuoroda ir dabartinio pokalbio metaduomenimis JSON turinyje Žetono elementas dedamas į URL, o pokalbio metaduomenų elementas į Body. PDF URL yra pastovus.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
Be parametrųNėraPalikite šią dalį tuščią. Visos užklausos reikšmės gaunamos iš ryšio arba nustatytos konfigūracijos.Netaikoma

API Endpoint: metodas ir URL

Pasirinkite POST ir įveskite:

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

Naudokite Add AI Data, kad įterptumėte telegram_bot_token iš System Tokens. Tai nuoroda į prijungto boto prisijungimo duomenis, ne vieta įklijuoti patį žetoną.

Headers

RaktasReikšmė
Content-Typeapplication/json

Body: įklijuokite į API Endpoint skirtuką Body.

{
  "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)"
}

Per Add AI Data įterpkite telegram_chat_id iš pokalbio metaduomenų. Šablono forma yra {{metadata_telegram_chat_id}}. Telegram kanalas jį nustato pagal įeinantį pokalbį, todėl PDF grįžta į tą pačią konversaciją. Dokumento URL ir antraštę palikite pastovius.

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.

Išsaugokite ir aktyvinkite Action. Visame Main Prompt jau yra aiškaus prašymo taisyklė. Bot API metodą aprašo sendDocument.

Patikrinkite failą, ne tik atsakymą

  1. Telegram išsiųskite How much is the B1 English course?. Patikrinkite, ar gaunate kainą be neprašyto failo.
  2. Išsiųskite Can you send me the brochure?.
  3. Patvirtinkite, kad atkeliauja PDF priedas ir jį atidarius matomas Fernway kursų gidas.
  4. Inbox atidarykite tą pokalbį ir išskleiskite iškviestos Action kortelę. Action kortelėje, esančioje Actions & MCPs, atidarykite View logs ir patikrinkite užklausą bei rezultatą. Prieš bendrinant ekrano nuotrauką žetonas turi būti paslėptas.
  5. Patvirtinkite, kad gavėjas yra dabartinis pokalbis ir pagal prašymą išsiųstas vienas dokumentas.

Tikrame teste send_course_brochure grąžino HTTP 200 ir Telegram atsakymą ok: true. Pradinė ekrano nuotrauka rodo gautą fernway-course-guide.pdf priedą mokinio pokalbyje. Užklausos rezultatas ir gautas failas kartu patvirtina pristatymą; vien Agento patvirtinimo teksto nepakanka.

Pristatymą testuokite Telegram. Simulation pokalbiai neturi tikro Telegram boto žetono konteksto. Simulation naudokite atsakymams, o tikrą Telegram pokalbį failo pristatymui tikrinti.

7 veiksmas: kaip perduoti Telegram pokalbį žmogui?

Įjunkite Human Handoff, kad prašymas pasikalbėti su žmogumi pakeistų pokalbio priskyrimą, tada paprašykite kolegos atsakyti iš Inbox.

  1. Atidarykite Actions & MCPs, įjunkite Human Handoff ir pasirinkite Edit Action.
  2. Palikite numatytas Handoff Rules: Media Message, User Frustration, Customer Support Suggestion ir Lack Of Knowledge įjungtos, Irrelevant Advice išjungta. Main Prompt jau susieja /help su prašymu kalbėtis su žmogumi; ši demonstracija neprideda atskiros perdavimo taisyklės.
  3. Prižiūrimam pratimui palikite Human Agents’ availability išjungtą ir užtikrinkite, kad bandymo metu kolega būtų prie Inbox. Email notifications palikite išjungtą. Tokie nustatymai naudoti demonstracijoje; neribotas perdavimas nereiškia, kad žmogus visada pasiekiamas.
  4. Prieš paleidimą įjunkite pasiekiamumo tvarkaraštį ir nustatykite laiko juostą bei darbo valandas pagal tikrą darbuotojų buvimą. Atitinkamai nustatykite pranešimą ne darbo metu.
  5. Išsaugokite Action. Boto privačiame pokalbyje išsiųskite I want to talk to a person. Jei botas paprašys patvirtinimo, atsakykite Yes.
  6. Inbox patikrinkite, ar AI nebepriskirtas. Pasirinkite Assign to me ir išsiųskite Hi, this is Alex from Fernway. Which course would you like help with?. Patikrinkite, ar žinutė atkeliauja į Telegram.
  7. Išsiųskite dar vieną mokinio žinutę, kol pokalbį valdo žmogus. Patvirtinkite, kad AI tyli. Atidarykite priskyrimo meniu ir pasirinkite AI Agent, tada užduokite naują klausimą apie kursą, kad patikrintumėte automatinių atsakymų atnaujinimą.

Tikras Telegram pokalbis Quickchat AI Inbox su prašymu kalbėtis su žmogumi, Unassigned būsena ir Assign to me mygtuku Prašymas palieka tikrą pokalbį Unassigned, kad kolega galėtų pasirinkti Assign to me. Ankstesnis atsakymas su brošiūra taip pat turi suskleistą Action iškvietimo žymeklį.

Perdavimo žmogui eiga nuo AI atsakymų apie kursus per sustabdytą automatizavimą, darbuotojo atsakymą iš Inbox ir pakartotinį priskyrimą Mokinys lieka Telegram. Sėkmingam perdavimui reikia priskyrimo pakeitimo ir pristatyto žmogaus atsakymo. Kai automatika turi tęstis, priskyrimo meniu pasirinkite AI Agent.

Fernway Telegram pokalbis su prašymu kalbėtis su žmogumi, perdavimo patvirtinimu, operatoriaus Alex atsakymu ir tolesne mokinio žinute

Operatoriaus atsakymas iš Inbox atkeliauja į tą patį Telegram pokalbį. Mokinys gali tęsti nekeisdamas programos.

Quickchat AI Inbox su operatoriaus atsakymu, tolesne mokinio žinute ir pokalbiu, vėl priskirtu AI Agent Po operatoriaus atsakymo priskyrimas grąžinamas AI Agent. Į kitą lygio klausimą gautas 5 veiksme parodytas AI atsakymas.

Trūkstamas faktas gali sukelti perdavimą, kaip vietiniame lygio teste. Abu rezultatus tikrinkite atskirai: atsakymas neturi spėlioti, o kiekvienas deklaruojamas perdavimas turi pakeisti priskyrimą Inbox. Human Handoff vadovas plačiau paaiškina pasiekiamumą ir nukreipimą.

Išsamus pokalbių boto perdavimo žmogui vadovas prideda užklausų ne darbo metu ir automatinių atsakymų veikimo po pakartotinio priskyrimo testus.

Kaip botas elgiasi Telegram grupėje?

Privatumo režimas nustato, kurias grupės žinutes Telegram pristato botui. Quickchat AI nuosavo boto ryšys apdoroja gautas žinutes; atskiro filtro „atsakyti tik į paminėjimus“ jis neprideda.

Pristatymo grupėje schema: adresuotos komandos ir atsakymai pasiekia botą su įjungtu privatumu; įprastas grupės pokalbis pasiekia išjungus privatumą arba botui esant administratoriui Schema apima šiame vadove naudojamus žinučių tipus. Telegram taip pat dokumentuoja tarnybines žinutes ir nuo konteksto priklausantį komandų nukreipimą.

Mokinių grupei, kurioje botas turi atsakyti į tiesioginius prašymus:

  1. Išsiųskite BotFather /setjoingroups, pasirinkite botą ir įjunkite narystę grupėse, jei ji išjungta.
  2. Išsiųskite /setprivacy, pasirinkite botą ir Enable. Palikite jį paprastu nariu be administratoriaus teisių. Jei privatumą pakeitėte po pridėjimo, pašalinkite botą ir pridėkite iš naujo, kad nustatymas įsigaliotų.
  3. Pridėkite botą prie mažos bandomosios grupės, kurią valdote.
  4. Išsiųskite paprastą žinutę, pavyzdžiui, See everyone in class tomorrow. Šioje konfigūracijoje ji neturėtų išprovokuoti atsakymo.
  5. Išsiųskite /schedule@your_bot, pakeisdami your_bot tikru naudotojo vardu. Patikrinkite atsakymą su tvarkaraščiu, tada tam atsakymui naudokite Telegram Reply gestą ir paklauskite What does B1 cost?.

Vien /schedule gali priklausyti nuo to, į kurį botą kreiptasi paskutinį kartą. Paprastas tekstinis @mention nėra patikimas adresuotos komandos pakaitalas standartiniu privatumo režimu. Naudokite aiškias ankstesnio testo formas. Žr. Telegram privatumo režimo taisykles.

BotFather su įjungta Fernway boto naryste grupėse ir privatumo nustatymais

Išsaugotas BotFather nustatymas yra Enable. Su savo botu atlikite grupės žinučių patikras, kad įsitikintumėte pristatymu toje grupėje.

Atskirame toliau pateiktame grupės teste naudotas bendras @QuickchatAI_bot, prijungtas prie to paties Fernway Agento. Jis atsakė į adresuotą tvarkaraščio komandą ir kainos klausimą, nusiųstą kaip atsakymą botui. Tai parodo bendro boto alternatyvą; nuosavas Fernway botas patikrintas privačiame pokalbyje, todėl jo elgesiui grupėje vis dar reikia minėtų patikrų.

Fernway Study Group su bendru Quickchat AI botu, atsakančiu į adresuotą tvarkaraščio komandą ir atsakymą su klausimu apie B1 kainą

Ši grupė naudoja bendrą @QuickchatAI_bot. Nuosavas Fernway botas yra tapatybė, parodyta privataus pokalbio ekrano nuotraukose.

Išjungus privatumą ar suteikus botui administratoriaus teises, įprasta grupės diskusija gali pasiekti Agentą ir sukelti daugiau atsakymų. Moderavimui skirtas Telegram grupių valdymo vadovas paaiškina papildomas teises ir Actions valdymą.

Grupė yra vienas bendras pokalbis. Asmeninius klausimus apie kursus reikia užduoti boto privačiame pokalbyje. Jei grupėje suveikia Human Handoff, AI sustabdomas visai grupei iki pakartotinio priskyrimo; atskiras privatus pokalbis su tuo mokiniu nesukuriamas.

Kodėl jūsų Telegram botas neatsako?

Pradėkite paprasčiausiu privataus pokalbio testu, tada patikrinkite ryšį ir žinutės tipą. Elgesys grupėje ir failų pristatymas turi papildomų atskirų priklausomybių.

PožymisKą tikrinti
BotFather sukūrė botą, bet jis tyliUžbaikite Agento prijungimą. BotFather nesuteikia atsakymų logikos.
Nėra pasveikinimoAtidarykite tinkamą botą, išsiųskite /start, patikrinkite Enable your own bot ir nustatytą Welcome message.
Nustojo veikti išbandžius kitą botų paslaugąTa paslauga galėjo pakeisti webhook. Iš naujo prijunkite norimą paslaugą; kitam procesui naudokite atskirą botą.
Nustojo veikti pakeitus žetonąAtnaujinkite Bot Token nauju žetonu ir išsaugokite ryšį.
Atsako privačiai, bet ne grupėjePatikrinkite narystę, privatumą ir tikrą naudotojo vardą. Išbandykite /schedule@your_bot arba atsakykite į jo žinutę.
Atsako į kiekvieną grupės žinutęPatikrinkite, ar privatumas išjungtas arba botas yra administratorius. Grįžkite prie anksčiau aprašytos tylesnės konfigūracijos.
Komanda rodoma meniu, bet atsakymas nesusijęsPatikrinkite Main Prompt taisyklę, įskaitant adresuotą komandos formą. Vien meniu registravimas nenustato elgesio.
Sako, kad išsiuntė PDF, bet priedo nėraPatikrinkite tikrą Action iškvietimą, tiesioginį PDF URL ir Telegram atsakymą. Testuokite Telegram su įjungtu nuosavo boto ryšiu.
Atsako iki perdavimo, paskui sustojaPatikrinkite priskyrimą Inbox. Žmogui priskirtas arba nepriskirtas pokalbis laukia darbuotojų ar pakartotinio priskyrimo.
Agentas negali atsakyti arba testai nebevykstaPatikrinkite turimus kreditus, žinių apdorojimą ir ar Agentas įjungtas.
Telegram grąžina dažnio apribojimo klaidąSumažinkite žinučių dažnį ir laikykitės Telegram nurodyto pakartojimo intervalo.

Prieš bendrindami botą pakartokite kainos, nežinomo fakto, PDF ir žmogaus atsakymo patikras privačiame pokalbyje su savo turiniu. Visus Fernway duomenis ir nuorodas pakeiskite savais. Dabartinę integracijos nustatymo informaciją rasite Telegram kanalo dokumentacijoje.

Ar ChatGPT arba Claude gali padėti sukurti šį botą?

AI klientas, prijungtas prie jūsų Quickchat AI paskyros, gali paruošti Agentą, žinias, instrukcijas, Actions ir testų rinkinį. Telegram tapatybę vis tiek sukuriate BotFather ir jos žetoną įvedate nuosavo boto prijungimo lange.

Prisijunkite per patvirtintą ChatGPT įrašą arba Claude įrašą, laikydamiesi Manage with AI instrukcijų. Duokite asistentui nustatymo rinkinį ir šią užklausą:

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.

Čia naudojamas paskyros valdymo ryšys yra atskiras nuo Agento pateikimo kaip MCP įrankio. Jis gali padėti nustatyti procesą, bet nepanaikina būtinybės patikrinti tikrą Telegram atsakymą ir priedą.

Dažniausiai užduodami klausimai

Kaip sukurti Telegram botą be programavimo?

Atidarykite oficialų BotFather Telegram, išsiųskite /newbot ir pasirinkite rodomą pavadinimą bei unikalų naudotojo vardą, kuris baigiasi bot. Prijunkite gautą žetoną prie botų paslaugos, pavyzdžiui, Quickchat AI. Pridėkite žinias ir instrukcijas, įjunkite ryšį ir patikrinkite privačią žinutę. BotFather sukuria tapatybę; prijungta paslauga pateikia atsakymus.

Ar Telegram boto kūrimas nemokamas?

Telegram boto registracija per BotFather nemokama. Quickchat AI turi Free planą asmeniniam, nekomerciniam mokymuisi su ribotu AI kreditų kiekiu. Verslui reikia komercinio plano. AI atsakymai ir Simulation Testing naudoja kreditus; Telegram tapatybės sukūrimas neapima neriboto AI naudojimo.

Kur rasti savo Telegram boto žetoną?

Atidarykite oficialų BotFather, išsiųskite /mybots, pasirinkite botą ir API Token. Šiuos prisijungimo duomenis įklijuokite į botų paslaugos tam skirtą Bot Token lauką. Nedėkite jų į promptą, žinių straipsnį, viešą saugyklą ar ekrano nuotrauką.

Ką daryti, jei Telegram boto žetonas nutekėjo?

Naudokite /revoke BotFather, kad panaikintumėte paviešintą žetoną, gaukite naują, tada atnaujinkite prijungtą paslaugą ir išbandykite atsakymą. Pašalinkite ir paviešintą kopiją, bet nepasikliaukite vien ištrynimu: kiekvienas, išsaugojęs seną žetoną, galėjo juo naudotis iki atšaukimo.

Ar galiu vieną Telegram botą prijungti prie dviejų platformų?

Botas turi vieną webhook paskirties adresą gaunamiems naujinimams. Jei antra platforma jį pakeičia, pirmoji nebegaus tų naujinimų. Kelios sistemos vis dar gali atlikti siunčiamus API iškvietimus, bet gaunamos žinutės automatiškai nekopijuojamos abiem. Nepriklausomiems įeinantiems procesams naudokite atskirus botus.

Kaip pridėti komandų į savo Telegram botą?

Išsiųskite BotFather /setcommands, pasirinkite botą ir pateikite po vieną komandos bei aprašymo porą eilutėje, be pradinio pasvirojo brūkšnio. Taip sukuriamas meniu. Taip pat turite įgyvendinti elgesį: šiame vadove Main Prompt susieja /prices, /schedule, /trial ir /help su atitinkamais atsakymais arba Action.

Kodėl Telegram botas atsako privačiai, bet ne grupėje?

Patikrinkite, ar botas yra grupėje, ir išbandykite komandą, adresuotą jo tikram naudotojo vardui, pavyzdžiui, /schedule@your_bot, arba atsakykite į jo žinutę. Įjungus privatumą, įprastas grupės pokalbis nepristatomas botui be administratoriaus teisių. Paprastas tekstinis paminėjimas nėra patikimas adresuotos komandos pakaitalas.

Ar galiu prie Telegram boto pridėti AI arba ChatGPT?

Galite prijungti BotFather botą prie AI paslaugos. Šiame vadove naudojamas Quickchat AI Agentas su savo žiniomis, Main Prompt ir Actions; jūsų asmeninis ChatGPT pokalbis neprijungiamas prie Telegram. Suderinamas paskyros valdymo asistentas gali padėti paruošti Agentą, o savininkas užbaigia nuosavo boto prijungimą.

Ar šis Telegram botas gali atsakyti į balso žinutes?

Quickchat AI Telegram integracija šiuo metu netranskribuoja balso įrašų Agentui. Balso priedas gali atsirasti Inbox, tačiau šis vadovas remiasi tekstinėmis žinutėmis. Paprašykite mokinio parašyti klausimą arba žmogaus patikrinti priedą.

Ar tai automatizuoja mano asmeninę Telegram paskyrą?

Ne. Šis vadovas sukuria atskirą boto tapatybę su nuosavu naudotojo vardu. Telegram siūlo kitų paskyros automatizavimo funkcijų, bet čia aprašytas Quickchat AI ryšys apdoroja botui siunčiamas žinutes; jis nenustato atsakymų iš jūsų asmeninio profilio.

Quickchat AI Quickchat AI Ask Quickchat AI a question