Telegram-botin luominen BotFatherilla ja tekoälyn lisääminen

Piotr Grudzień
Julkaistu Lukuaika 14 min
Telegram-botin luominen BotFatherilla ja Quickchat AI:lla, vieressä oikea Fernway-keskustelu, jossa on kurssivastauksia, PDF-liite ja ihmisen vastaus

Kun haluat luoda Telegram-botin, avaa BotFather, lähetä /newbot, valitse nimi ja käyttäjänimi ja kopioi token bottia suorittavaan palveluun. Tässä palvelu on Quickchat AI: se antaa botille omien tietojesi pohjalta vastaavan AI-agentin ilman koodin kirjoittamista tai palvelimen ylläpitoa.

Rakennat Fernway Languagesin, kuvitteellisen englannin verkkokoulun. Oppilas voi avata botin, tarkistaa hinnat, napauttaa /schedule, pyytää PDF-kurssioppaan ja kysyä ihmistä avuksi. Kokemus pysyy oppilaan Telegram-chatissa; tiimisi hallitsee tietoja, Actions-toimintoja ja keskusteluja Quickchat AI:ssa.

Fernway Languages vastaa Telegramissa kurssien hinta- ja aikataulukysymyksiin ja toimittaa sitten pyydetyn PDF-oppaan

Valmis botti Telegramissa. Kurssivastaukset tulevat sen tiedoista ja esite saapuu oikeana PDF-liitteenä.

Perusasetukset etenevät botin luomisesta vastausten testaamiseen. Lisää sitten PDF:n lähetys ja siirto ihmiselle. Ryhmäosio selittää, miten vastaukset pidetään ennakoitavina yhteisessä keskustelussa.

Lataa Fernway-asennuspaketti, joka sisältää tiedot, Main Promptin, komentoluettelon, testilomakkeen, avatarin ja esimerkki-PDF:n. Tiedostot ovat muokattavia esimerkkejä hallintapaneeliin liitettäviksi, eivät agentin automaattinen tuonti.

Kuvakaappaukset, käyttöliittymän nimet ja kopioitavat demoaineistot säilyvät englanniksi, jotta voit toistaa esitetyn esimerkin.

Mitä tarvitset Telegram-botin luomiseen ilman koodia?

Tarvitset Telegram-tilin, Quickchat AI -tilin ja uuden botin harjoitusta varten. BotFather luo Telegram-identiteetin; Quickchat AI suorittaa sen taustalla olevan agentin.

  1. Kirjaudu Telegramiin puhelimella tai tietokoneella. Käytä vaiheessa 1 linkitettyä virallista BotFatheria, älä samannimistä jäljitelmää.
  2. Luo Quickchat AI -tili ja vahvista sähköposti tarvittaessa. Free tukee henkilökohtaista, ei-kaupallista oppimista sisältämällään käyttömäärällä. Oikea yrityskäyttö vaatii kaupallisen tilauksen. AI-vastaukset ja Simulation Testing kuluttavat krediittejä; katso nykyiset tilaukset ja käyttörajat.
  3. Pidä molemmat sovellukset auki. Käytä uutta testibottia, jotta et muuta olemassa olevaa tukikanavaa. Toinen Telegram-tili auttaa tarkistamaan uuden vierailijan kokemuksen.

Telegram ei veloita botin rekisteröinnistä. AI-vastauksia tuottavalla palvelulla on oma käyttökiintiönsä. Et tarvitse erillistä mallin API-avainta tätä toteutusta varten.

Mitä BotFather tekee ja mitä tekoäly tekee?

BotFather hallitsee botin identiteettiä ja asetuksia. Yhdistetty agentti päättää vastauksesta tietojensa ja ohjeidensa avulla. Pelkkä botin luominen ei anna sille kurssitietoja tai viesteihin vastaavaa ohjelmaa.

Kaavio erottaa BotFatherin identiteettiasetukset Telegram-viesteistä ja Quickchat AI:n vastauksista Telegram toimittaa oppilaan viestin yhdistettyyn palveluun. Agentin vastaus palaa samaan chattiin.

OsaMitä määritätMitä oppilas näkee
BotFatherNimi, käyttäjänimi, profiilikuva, kuvaus, komentovalikko ja yksityisyystilaBotin identiteetti ja aloituskohdat
Quickchat AIKnowledge Base, Main Prompt, tervetuloviesti ja ActionsKurssivastaukset, pyydetty PDF ja siirto
TiimisiOikeat kurssitiedot ja valvottu InboxIhmisen vastaus tarvittaessa

Vaihe 1: miten luot Telegram-botin BotFatherissa?

Lähetä /newbot viralliselle BotFatherille ja anna näyttönimi sekä yksilöllinen käyttäjänimi.

  1. Avaa @BotFather Telegramissa ja valitse Start.
  2. Lähetä /newbot.
  3. Kun nimeä kysytään, lähetä Fernway Languages. Oppilaat näkevät tämän näyttönimen.
  4. Valitse käyttäjänimeksi esimerkiksi fernway_lessons_yourname_bot. Korvaa yourname yksilöllisellä loppuosalla. Käytä vähintään 5 ja enintään 32 latinalaista kirjainta, numeroa tai alaviivaa; kirjainkoolla ei ole merkitystä. Tässä tavallisessa maksuttomassa toteutuksessa käytä päätettä bot. Jos nimi on varattu, kokeile toista loppuosaa. BotFather tarjoaa myös muita päätteitä ehdot täyttäville Premium-tileille.
  5. BotFather palauttaa botin linkin ja tunnistautumistokenin. Tallenna linkki oppilaille näkyvän chatin avaamista varten. Pidä token salassa vaihetta 4 varten.

Komentoliittymä riittää tähän ohjeeseen. BotFather voi tarjota myös Mini Appin hallintaa varten; käytä seuraavia komentoja, jos näyttösi on erilainen.

Keskustelu vahvistetun BotFatherin kanssa: newbot, Fernway Languages ja luontivahvistus, käyttäjänimi ja tunniste peitettyinä

BotFather luo identiteetin ja palauttaa linkin sekä tunnisteen. Testikäyttäjänimi ja koko salainen tunniste on peitetty.

Mistä löydät Telegram-botin tokenin?

Lähetä /mybots BotFatherille, valitse botti ja avaa API Token. Token todentaa botin nimissä tehdyt pyynnöt. Liitä se vain palvelun sille tarkoitettuun kenttään, älä promptiin, tietoihin, tukikeskusteluun tai kuvakaappaukseen.

Jos token paljastuu, lähetä /revoke, valitse botti ja hanki korvaava token. Päivitä yhdistetty palvelu ja testaa vastaus. Vanha token lakkaa toimimasta; botin nimen vaihto tai kuvan poistaminen ei mitätöi sitä.

Webhookilla on yksi kohde. Saman botin yhdistäminen toiseen palveluun voi korvata Quickchat AI:lle viestejä toimittavan webhookin. Eri palvelut voivat tehdä lähteviä API-kutsuja samalla tokenilla, mutta eivät saa automaattisesti omaa kopiota saapuvista päivityksistä. Telegram estää myös getUpdates-kyselyn webhookin ollessa käytössä. Käytä erillistä bottia erilliseen saapuvaan työnkulkuun. Telegramin päivitysten toimitusohje selittää molemmat mekanismit.

Vaihe 2: miten lisäät kuvan, kuvauksen ja komentovalikon?

Tee botista tunnistettava BotFatherin profiilikomennoilla ennen oppilaan ensimmäistä viestiä. Valitse jokaisen komennon jälkeen bottisi ja lähetä alla oleva arvo.

Lähetä BotFatherilleAnna sen jälkeenNäkyy tässä
/setnameFernway LanguagesTelegramin näyttönimi
/setuserpicLataa paketista fernway-avatar.pngProfiilikuva
/setdescriptionAlla oleva kuvausEsittely ennen keskustelun aloitusta
/setabouttextAlla oleva lyhyt profiilitekstiBotin profiili ja jaetun linkin esikatselu
/setcommandsAlla oleva komentoluetteloOppilaan keskustelussa napauttama valikko

Description (enintään 512 merkkiä):

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 (enintään 120 merkkiä):

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

Komentoluettelo: liitä nämä neljä riviä yhdessä. Komentojen nimissä ei ole alun kauttaviivaa tässä BotFather-luettelossa.

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

Avaa botin profiili ja tarkista nimi, kuva ja teksti. Avaa chat ennen Start-valintaa tarkistaaksesi esittelyn. Telegram kuvaa asetukset BotFather-ohjeessaan.

Kun olet yhdistänyt botin vaiheessa 4 ja valinnut Start, avaa komentovalikko ja tarkista kaikki neljä kohtaa. Säilytä rivinvaihdot liittäessäsi luetteloa BotFatheriin; muuten useat kohdat voivat muuttua yhdeksi pitkäksi kuvaukseksi.

Fernway Languagesin komentovalikko, jossa prices, schedule, trial ja help määritetyn tervetuloviestin alla

Valmiissa valikossa on neljä erillistä kohtaa. Yläpuolinen tervehdys määritetään Quickchat AI:ssa vaiheessa 3.

Komentokaavio: BotFather lisää valikkokohdan, Telegram lähettää komentotekstin ja Main Prompt määrittää merkityksen /schedule-komennon lisääminen valikkoon ei toteuta aikatauluhakua. Seuraava vaihe kertoo agentille viestin merkityksen.

Vaihe 3: miten botti saadaan vastaamaan omista tiedoistasi?

Luo agentti, lisää koulun faktat kohtaan Knowledge Base ja vastaussäännöt kohtaan Main Prompt. Faktojen ja ohjeiden erottaminen helpottaa hinnan muuttamista vaikuttamatta botin toimintaan.

Kuvakaappaukset avautuvat täysikokoisina valittaessa. Käytä kopioitavia lohkoja tarkkoihin teksteihin ja pyyntöarvoihin.

Lisää kurssitiedot

  1. Luo Quickchat AI:ssa uusi agentti nimeltä Fernway Languages. Aseta Identity-kohdassa sama nimi.
  2. Avaa Knowledge Base, valitse Add Article ja aseta Title-arvoksi Fernway Languages course guide.
  3. Liitä seuraava teksti Content-kenttään ja valitse Save. Odota käsittelyn loppumista ja Ready-tilaa. Tee mahdolliset näytetyt julkaisu- tai käyttöönottovaiheet ennen oikean kanavan testaamista.

Fernway-tietoartikkelin editori, jossa otsikko, kurssihinnat ja viikoittaiset tuntiajat Lisää faktat kohtaan Knowledge Base. Koko kopioitava artikkeli sisältää myös kokeilutunnin, hyvityksen ja tasolle sijoittamisen käytännöt.

Kopioi Fernway-tietoartikkeli
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.

Puuttuva pisteraja mahdollistaa mielekkään testin. Agentti voi vastata B1-hintaan lähteen perusteella, mutta sen ei pidä keksiä osallistumiseen vaadittavaa pistemäärää.

Määritä komentojen merkitys

Avaa Identity, valitse Edit-merkinnällä varustettu Main Prompt ja liitä koko prompti. Odota automaattista tallennusta ja avaa uudelleen tarkistaaksesi tekstin.

Fernway Languagesin Identity-sivu, jossa Name ja muokattava Main Prompt Avaa Main Prompt Identity-kohdasta. Sen säännöt antavat Telegram-komennoille merkityksen.

Kopioi koko 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.

Prompti sisältää valinnaiset esite- ja siirtovaiheet, jotka määrität myöhemmin. Tee ne ennen botin jakamista täydellisenä oppilastukena. Prompti voi pyytää Action-toimintoa; se ei luo sitä tai yhdistä Telegramia.

Osoitetut muodot, kuten /schedule@your_bot, ovat tärkeitä ryhmissä. Myös pelkän tekstin ohje on tärkeä: integraation tavalliset vastaukset lähetetään ilman Telegramin Markdown-muotoilua.

Aseta tervetuloviesti

Avaa Your Website, valitse Text Content ja muokkaa Welcome message. Myös Telegramin oman botin yhteys käyttää tätä yhteistä tervehdystä:

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 -kenttä, jossa Fernway-tervehdys ja komentoehdotukset Yhteinen Welcome message -kenttä löytyy kohdasta Your Website → Text Content; Telegram käyttää sitä /start-komentoon.

Oman botin integraatio lähettää tervehdyksen, kun vierailija lähettää /start. Se on erillinen BotFatherin alkukuvauksesta ja tekoälyn kurssikysymykseen antamasta vastauksesta.

Vaihe 4: miten yhdistät tokenin Quickchat AI:hin?

Yhdistä kohdasta Your own bot, jotta käytät juuri luomaasi Telegram-identiteettiä.

  1. Avaa External Apps, valitse Telegram ja Your own bot.
  2. Valitse Connect to Telegram, liitä BotFather-token kohtaan Bot Token ja lähetä se valitsemalla ikkunassa Connect to Telegram.
  3. Ota Enable your own bot käyttöön ja valitse Save.
  4. Avaa botin t.me-linkki Telegramissa. Valitse Start tai lähetä /start tarkistaaksesi tervehdyksen.

Quickchat AI:n Telegram-asetukset, yhdistetty Fernway kohdassa Your own bot ja Enable your own bot käytössä Oikean yhteyden paneeli näyttää botin identiteetin ja käyttöönoton tilan. Käytä Your own bot -valintaa BotFatherissa luodulle identiteetille.

Quickchat AI:n Connect to Telegram -ikkuna, jossa Bot Token on tyhjä Syötä tunniste tähän kenttään. Kuvassa ei tarkoituksella näy tokenia.

Jaettu Quickchat AI bot on eri toteutus. Se tarjoaa agenttikohtaisen chatlinkin ilman oman botin luomista; pääohje käyttää omaa identiteettiä ja tunnistetta. Telegramin AI-chatbottiohje kuvaa jaetun vaihtoehdon.

Jos yhteysikkuna neuvoo poistamaan ryhmien yksityisyystilan käytöstä, jätä se päälle tämän ohjeen osoitettuja komentoja varten. Yksityiskeskustelut toimivat ryhmäasetuksesta riippumatta. Ryhmäosio selittää valinnan vaikutukset.

Vaihe 5: miten testaat Telegram-bottisi?

Tarkista agentin vastaus ja Telegramiin toimitettu viesti. Hallintapaneelin testi varmistaa vastauslogiikan; vain Telegram-keskustelu varmistaa koko kanavan.

Testaa vastaukset Quickchat AI:ssa

Avaa Testing, valitse Create Dataset, nimeä se Fernway course answers ja lisää viestit erillisille riveille:

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?

Osoitetun komennon rivi käyttää esimerkkikäyttäjänimeä promptisäännön testaamiseen. Käytä oikeassa Telegram-testissä bottisi todellista nimeä.

Käytä kohdassa Evaluation criteria seuraavaa:

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.

Valitse Run, kun AI-krediittejä on saatavilla. Jokainen rivi aloittaa erillisen keskustelun. Testaa jatkokysymykset yhdessä jatkuvassa AI Preview -keskustelussa, älä seuraavalla aineistorivillä seuraavana vuorona.

Kuusi valmistunutta Fernway Simulation -testiä, joissa hinnat, komennot ja tasokysymyksen tulos Oikeat paikalliset Simulation-tulokset. Tasokysymyksen vastaus sai alemman arvion, koska arvioija ei nähnyt siirtoa; Inbox vahvisti todellisen vastuun muutoksen.

Testaa oppilaan kokemus Telegramissa

Lähetä seuraavat viestit oikean botin yksityischatissa ja odota jokaista vastausta. Etsi vastaava kysymys ja vastaus Inbox-näkymästä.

Jätä pistemääräkysymys viimeiseksi vaiheiden 6 ja 7 jälkeen. Se voi siirtää keskustelun henkilökunnalle ja keskeyttää automaattiset vastaukset.

Viesti tai toimintoHyväksytty tulos
/startMääritetty tervetuloviesti tulee näkyviin
How much is the B1 English course?EUR120 koko neljän viikon kurssista
Napauta valikosta /scheduleMolemmat viikkoaikataulut selkeästi UTC-merkittyinä
Napauta /trialPyyntö 20 minuutin kokeilutunnista; tiimi vahvistaa saatavuuden
I scored 62 on your placement test. Do I qualify for B1?Ei keksittyä pisterajaa tai hyväksymispäätöstä; tiimin vahvistus tarvitaan

Fernway Languages kieltäytyy Telegramissa määrittämästä B1-kelpoisuutta 62 pisteen perusteella

Oikea vastaus jättää tasopäätöksen tiimille. Aiempi esite ja ihmisen vastaus näkyvät samassa keskustelussa.

Quickchat AI:n Inbox, jossa sama Telegramin tasokysymys, agentin vastaus ja keskustelun Unassigned-tila Vastaava Inbox-näkymä näyttää vastauksen ja Unassigned-tilan.

Oikeassa testissä agentti ei päätellyt tasoa pisteistä. Inbox näytti sen jälkeen Unassigned, kun Lack Of Knowledge -siirto oli käytössä. Tarkista vastaus ja vastuuhenkilö erikseen; vastausarvioija ei voi määrittää chatin omistajaa. Tee tasotesti muiden keskustelutestien jälkeen tai valitse AI Agent Inboxin vastuuvalikosta ennen automaattisten vastausten jatkamista.

Jos vastaus on väärä, tarkista tietoartikkeli ja tallennettu prompti, muuta yhtä asiaa ja toista viesti uudessa keskustelussa. Komentovirheessä tarkista tarkka sääntö; hintavirheessä tiedonhaku ja julkaisu. Kirjaa oikea vastaus sen sijaan, että hyväksyisit asetukset vihreän yhteystilan perusteella.

Kuusi viestiä on lähtökohta. AI-tukiagentin testausohje näyttää, miten lisäät realistisia virhetilanteita ja arviointikriteerit ennen julkaisua.

Vaihe 6: miten saat botin lähettämään PDF:n?

Lisää yksi API Action, joka lähettää kiinteän kurssioppaan nykyiseen Telegram-chattiin. Agentti päättää, pyysikö oppilas sitä; integraatio antaa tunnisteen ja kohteen.

Kaavio dokumentti-Actionin kolmesta kiinteästä lähteestä: System Token, nykyisen chatin kanavametadata ja julkinen PDF-URL Oppilas ei anna tokenia tai chatin tunnusta. Actionissa ei ole mallin täyttämiä parametreja.

Lataa fernway-course-guide.pdf paketista esimerkin tarkistamista varten. Ohje käyttää sen julkista URL-osoitetta tällä sivustolla. Käytä omalle tiedostollesi suoraa HTTPS-osoitetta, jonka Telegram voi hakea ilman kirjautumista ja joka palauttaa PDF:n oikealla sisältötyypillä. Pidä URL:stä haettavat dokumentit alle 20 Mt:n kokoisina. Telegram erottaa URL-haun tiedostolatauksesta tiedostojen lähetysohjeessa.

Avaa Actions & MCPs, valitse Add Action, valitse API Action -editori ja määritä kentät. Jos editori tarjoaa luodun luonnoksen, vertaa todellista pyyntöä ohjeeseen ennen käyttöönottoa.

API Action -editori, jossa POST sendDocument, Telegram System Token -viittaus ja nykyisen chatin metadata JSON-rungossa Token-merkki kuuluu URL-osoitteeseen; chatin metadatamerkki kohtaan Body. PDF-osoite on kiinteä.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
No parametersEi mitäänJätä osio tyhjäksi. Kaikki arvot tulevat yhteydestä tai kiinteästä ohjeesta.Ei sovelleta

API Endpoint: menetelmä ja URL

Valitse POST ja syötä:

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

Lisää telegram_bot_token kohdasta System Tokens toiminnolla Add AI Data. Se viittaa yhdistetyn botin tunnisteeseen; älä liitä tähän varsinaista tokenia.

Headers

AvainArvo
Content-Typeapplication/json

Body: liitä sisältö API Endpointin Body-välilehdelle.

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

Lisää telegram_chat_id keskustelun metadatasta Add AI Data -toiminnolla. Sen mallimuoto on {{metadata_telegram_chat_id}}. Telegram-kanava asettaa sen saapuvan chatin perusteella, joten PDF palaa samaan keskusteluun. Pidä dokumentin osoite ja kuvateksti kiinteinä.

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.

Tallenna ja ota Action käyttöön. Koko Main Prompt sisältää jo nimenomaista pyyntöä koskevan säännön. Bot API -menetelmä kuvataan kohdassa sendDocument.

Tarkista tiedosto, älä pelkkää vastausta

  1. Lähetä Telegramissa How much is the B1 English course?. Tarkista, että saat hinnan ilman pyytämätöntä tiedostoa.
  2. Lähetä Can you send me the brochure?.
  3. Varmista, että PDF-liite saapuu ja avaa Fernway-kurssioppaan.
  4. Avaa keskustelu Inbox-näkymässä ja laajenna kutsutun Actionin kortti. Avaa Actions & MCPs -kohdan Action-kortista View logs tarkistaaksesi pyynnön ja tuloksen. Peitä token ennen kuvakaappauksen jakamista.
  5. Varmista, että kohde on nykyinen chat ja pyyntö lähetti yhden dokumentin.

Oikeassa testissä send_course_brochure palautti HTTP 200 ja Telegramin ok: true -vastauksen. Alun kuva näyttää liitteen fernway-course-guide.pdf oppilaan chatissa. Pyynnön tulos ja vastaanotettu tiedosto varmistavat yhdessä toimituksen; agentin vahvistusteksti yksin ei riitä.

Tee toimitustesti Telegramissa. Simulation-keskusteluilla ei ole oikean Telegram-bottitokenin kontekstia. Käytä Simulationia vastaustarkistuksiin ja oikeaa chattia tiedoston toimituksen tarkistamiseen.

Vaihe 7: miten siirrät Telegram-chatin ihmiselle?

Ota Human Handoff käyttöön, jotta ihmistä koskeva pyyntö vaihtaa keskustelun vastuuhenkilöä, ja pyydä tiimiläistä vastaamaan Inboxista.

  1. Avaa Actions & MCPs, ota Human Handoff käyttöön ja valitse Edit Action.
  2. Säilytä oletusarvoiset Handoff Rules: Media Message, User Frustration, Customer Support Suggestion ja Lack Of Knowledge käytössä, Irrelevant Advice pois käytöstä. Main Prompt yhdistää jo /help-komennon ihmisen pyytämiseen; demo ei lisää omaa siirtosääntöä.
  3. Jätä valvotussa harjoituksessa Human Agents’ availability pois käytöstä ja pidä tiimiläinen Inboxissa testauksen ajan. Jätä Email notifications pois käytöstä. Näitä asetuksia käytettiin demossa; rajoittamaton siirto ei tarkoita, että ihminen olisi aina saatavilla.
  4. Ota saatavuusaikataulu käyttöön ennen julkaisua ja määritä aikavyöhyke sekä todelliset palveluajat. Mukauta niiden ulkopuolella näytettävä viesti.
  5. Tallenna Action. Lähetä botin yksityischatissa I want to talk to a person.. Jos botti pyytää vahvistusta, vastaa Yes.
  6. Tarkista Inbox-näkymässä, ettei keskustelu ole enää tekoälyn vastuulla. Valitse Assign to me ja lähetä Hi, this is Alex from Fernway. Which course would you like help with?. Tarkista saapuminen Telegramiin.
  7. Lähetä toinen oppilasviesti ihmisen ollessa vastuussa. Varmista, että tekoäly pysyy hiljaa. Avaa vastuuvalikko, valitse AI Agent ja lähetä uusi kurssikysymys varmistaaksesi automaattisten vastausten jatkumisen.

Oikea Telegram-keskustelu Inboxissa, ihmisen pyyntö, Unassigned-tila ja Assign to me -painike Pyyntö jättää oikean chatin Unassigned-tilaan, jotta tiimiläinen voi valita Assign to me. Aiemmassa esitevastauksessa näkyy myös suljettu Action-kutsumerkki.

Siirtoprosessi AI-kurssivastauksista keskeytettyyn automaatioon, Inboxin henkilöstövastaukseen ja vastuun palautukseen Oppilas pysyy Telegramissa. Onnistunut siirto vaatii vastuun muutoksen ja toimitetun ihmisvastauksen. Valitse AI Agent vastuuvalikosta, kun automaation on tarkoitus jatkua.

Fernway-keskustelu, jossa ihmisen pyyntö, siirtovahvistus, Alexin vastaus ja oppilaan jatkoviesti

Työntekijän Inbox-vastaus saapuu samaan Telegram-chattiin. Oppilas voi jatkaa vaihtamatta sovellusta.

Quickchat AI:n Inbox, jossa työntekijän vastaus, oppilaan jatkoviesti ja keskustelu palautettuna AI Agentille Työntekijän vuoron jälkeen vastuuksi palautetaan AI Agent. Seuraava tasokysymys sai vaiheessa 5 esitetyn AI-vastauksen.

Puuttuva tieto voi aiheuttaa siirron, kuten paikallisessa tasotestissä. Tarkista molemmat tulokset: vastaus ei saa arvailla, ja väitetyn siirron täytyy muuttaa Inboxin vastuuta. Human Handoff -ohje selittää saatavuuden ja reitityksen tarkemmin.

Chatbotin ihmiselle siirtämisen ohje lisää palveluajan ulkopuoliset testit sekä tarkistaa automaattisten vastausten jatkumisen vastuun palautuksen jälkeen.

Miten botti toimii Telegram-ryhmässä?

Yksityisyystila määrää, mitkä ryhmäviestit Telegram toimittaa botille. Quickchat AI:n oman botin yhteys käsittelee saamansa viestit; se ei lisää erillistä vain mainintoihin vastaavaa suodatinta.

Ryhmätoimituskaavio: osoitetut komennot ja vastaukset saapuvat yksityisyystilan ollessa päällä; tavallinen keskustelu saapuu tilan ollessa pois tai botin ollessa ylläpitäjä Kaavio kattaa tämän ohjeen viestityypit. Telegram dokumentoi myös palveluviestit ja kontekstista riippuvan komentoreitityksen.

Kurssiryhmään, jossa botti vastaa suoriin pyyntöihin:

  1. Lähetä /setjoingroups BotFatherille, valitse botti ja salli ryhmiin liittyminen, jos se on estetty.
  2. Lähetä /setprivacy, valitse botti ja Enable. Pidä se tavallisena jäsenenä ilman ylläpitäjän oikeuksia. Jos muutit yksityisyystilaa lisäämisen jälkeen, poista botti ja lisää se uudelleen, jotta asetus tulee voimaan.
  3. Lisää botti pieneen hallitsemaasi testiryhmään.
  4. Lähetä tavallinen viesti, kuten See everyone in class tomorrow.. Sen ei pitäisi aiheuttaa vastausta näillä asetuksilla.
  5. Lähetä /schedule@your_bot ja korvaa your_bot oikealla käyttäjänimellä. Tarkista aikatauluvastaus ja käytä siihen Telegramin Reply-toimintoa kysyäksesi What does B1 cost?.

Pelkkä /schedule voi riippua siitä, mitä bottia viimeksi puhuteltiin. Tekstimuotoinen @mention ei luotettavasti korvaa osoitettua komentoa tavallisessa yksityisyystilassa. Käytä testin täsmällisiä muotoja. Katso Telegramin yksityisyystilan säännöt.

BotFather näyttää Fernway-botin ryhmäjäsenyyden ja yksityisyystilan käytössä

Tallennettu asetus on Enable. Tee ryhmäviestitarkistukset omalla botillasi varmistaaksesi toimituksen kyseiseen ryhmään.

Erillinen ryhmätesti käytti jaettua @QuickchatAI_bot-bottia, joka oli yhdistetty samaan Fernway-agenttiin. Se vastasi osoitettuun aikataulukomentoon ja botin viestiin lähetettyyn hintakysymykseen. Tämä esittelee jaetun vaihtoehdon; oma Fernway-bottimme varmistettiin yksityischatissa, joten sen ryhmätoiminta tarvitsee edelleen yllä olevat testit.

Fernway Study Group, jossa jaettu Quickchat AI -botti vastaa osoitettuun aikataulukomentoon ja vastauksena lähetettyyn B1-hintakysymykseen

Tämä ryhmä käyttää jaettua @QuickchatAI_bot-bottia. Oma Fernway-botti näkyy yksityiskeskustelujen kuvissa.

Yksityisyystilan poistaminen tai ylläpitäjän oikeudet voivat toimittaa tavallisen ryhmäkeskustelun agentille ja lisätä vastauksia. Telegram-ryhmän hallintaohje selittää moderoinnin lisäoikeudet ja Action-rajoitukset.

Ryhmä on yksi yhteinen keskustelu. Henkilökohtaiset kurssikyselyt kuuluvat botin yksityischattiin. Jos Human Handoff käynnistyy ryhmässä, se pysäyttää tekoälyn koko ryhmältä vastuun palautukseen asti; oppilaalle ei luoda erillistä yksityiskeskustelua.

Miksi Telegram-bottisi ei vastaa?

Aloita yksinkertaisimmasta yksityistestistä ja tarkista sitten yhteys sekä viestityyppi. Ryhmätoiminta ja tiedostotoimitus lisäävät omat riippuvuutensa.

OireTarkistettava asia
BotFather loi botin, mutta se vaikeneeViimeistele agentin yhteys. BotFather ei tuota vastauslogiikkaa.
Tervehdystä ei tuleAvaa oikea botti, lähetä /start ja tarkista Enable your own bot sekä Welcome message.
Se pysähtyi toisen palvelun kokeilun jälkeenPalvelu saattoi korvata webhookin. Yhdistä haluttu palvelu uudelleen ja käytä toiseen työnkulkuun erillistä bottia.
Se pysähtyi tokenin vaihdon jälkeenPäivitä Bot Token uudella arvolla ja tallenna yhteys.
Se vastaa yksityisesti mutta ei ryhmässäTarkista jäsenyys, yksityisyystila ja oikea käyttäjänimi. Kokeile /schedule@your_bot tai vastaa botin viestiin.
Se vastaa jokaiseen ryhmäviestiinTarkista, onko yksityisyystila pois tai botti ylläpitäjä. Palaa yllä olevaan hiljaisempaan toteutukseen.
Valikkokomento saa epäolennaisen vastauksenTarkista Main Prompt -sääntö ja osoitettu muoto. Valikon rekisteröinti ei määritä toimintaa.
Se väittää lähettäneensä PDF:n, mutta liitettä ei näyTarkista oikea Action-kutsu, suora PDF-URL ja Telegramin vastaus. Testaa Telegramissa oman botin yhteys käytössä.
Se vastaa siirtoon asti ja pysähtyyTarkista Inboxin vastuu. Ihmiselle osoitettu tai osoittamaton keskustelu odottaa henkilöstöä tai vastuun palautusta.
Agentti ei vastaa tai testit pysähtyvätTarkista krediitit, tiedon käsittely ja agentin käyttöönotto.
Telegram palauttaa nopeusrajoitusvirheenVähennä viestimäärää ja noudata Telegramin palauttamaa uudelleenyritysväliä.

Toista ennen botin jakamista yksityiset hinta-, tuntematon tieto-, PDF- ja ihmisvastaustestit oikealla sisällölläsi. Korvaa kaikki Fernway-tiedot ja linkit omillasi. Käytä ajantasaisena asennusviitteenä Telegram-kanavan dokumentaatiota.

Voivatko ChatGPT tai Claude auttaa botin luomisessa?

Quickchat AI -tiliisi yhdistetty AI-asiakas voi valmistella agentin, tiedot, ohjeet, Actions-toiminnot ja testiaineiston. Luot silti itse Telegram-identiteetin BotFatherissa ja syötät tokenin hallintapaneelin oman botin työnkulussa.

Yhdistä vahvistetun ChatGPT-listauksen tai Claude-listauksen kautta ja noudata Manage with AI -ohjetta. Anna avustajalle paketti ja tämä pyyntö:

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.

Tässä käytetty tilinhallintayhteys on erillinen agentin tarjoamisesta MCP-työkaluna. Se auttaa työnkulun määrittämisessä, mutta ei poista tarvetta tarkistaa oikeaa Telegram-vastausta ja liitettä.

Usein kysytyt kysymykset

Miten luon Telegram-botin ilman ohjelmointia?

Avaa virallinen BotFather Telegramissa, lähetä /newbot ja valitse näyttönimi sekä yksilöllinen bot-päätteinen käyttäjänimi. Yhdistä saamasi token palveluun, kuten Quickchat AI:hin. Lisää tiedot ja ohjeet, ota yhteys käyttöön ja testaa yksityisviesti. BotFather luo identiteetin; yhdistetty palvelu tuottaa vastaukset.

Onko Telegram-botin luominen ilmaista?

Rekisteröinti BotFatherilla on ilmaista. Quickchat AI:n Free-tilaus tarjoaa rajallisen määrän AI-krediittejä henkilökohtaiseen, ei-kaupalliseen oppimiseen. Yrityskäyttö vaatii kaupallisen tilauksen. AI-vastaukset ja Simulation Testing kuluttavat krediittejä; Telegram-identiteetin luominen ei sisällä rajatonta tekoälyn käyttöä.

Mistä löydän Telegram-bottini tokenin?

Avaa virallinen BotFather, lähetä /mybots, valitse bottisi ja API Token. Liitä tunniste palvelun Bot Token -kenttään. Älä laita sitä promptiin, tietoartikkeliin, julkiseen koodivarastoon tai kuvakaappaukseen.

Mitä teen, jos Telegram-botin token vuotaa?

Mitätöi paljastunut token BotFatherin /revoke-komennolla, hanki uusi, päivitä yhdistetty palvelu ja testaa vastaus. Poista myös paljastunut kopio, mutta älä luota pelkkään poistamiseen: vanhan tokenin tallentanut voi käyttää sitä mitätöintiin asti.

Voinko yhdistää yhden Telegram-botin kahteen alustaan?

Botilla on yksi webhook-kohde saapuville päivityksille. Jos toinen alusta korvaa webhookin, ensimmäinen lakkaa vastaanottamasta niitä. Useat järjestelmät voivat silti tehdä lähteviä API-kutsuja, mutta saapuvia viestejä ei kopioida automaattisesti molemmille. Käytä erillisiä botteja riippumattomiin saapuviin työnkulkuihin.

Miten lisään komentoja Telegram-bottiin?

Lähetä /setcommands BotFatherille, valitse botti ja anna kullekin riville komento ja kuvaus ilman alun kauttaviivaa. Tämä luo valikon. Myös toiminta täytyy toteuttaa: tässä ohjeessa Main Prompt yhdistää komennot /prices, /schedule, /trial ja /help oikeisiin vastauksiin tai Action-toimintoon.

Miksi botti vastaa yksityisesti mutta ei ryhmässä?

Tarkista, että botti kuuluu ryhmään, ja kokeile sen oikealle käyttäjänimelle osoitettua komentoa, kuten /schedule@your_bot, tai vastaa sen viestiin. Kun yksityisyystila on päällä, botti ilman ylläpitäjän oikeuksia ei saa tavallista ryhmäkeskustelua. Pelkkä tekstimaininta ei korvaa osoitettua komentoa luotettavasti.

Voinko lisätä tekoälyn tai ChatGPT:n Telegram-bottiin?

Voit yhdistää BotFather-botin tekoälypalveluun. Tässä ohjeessa käytetään Quickchat AI -agenttia, jolla on omat tiedot, Main Prompt ja Actions; omaa ChatGPT-keskusteluasi ei yhdistetä Telegramiin. Yhteensopiva tilinhallinta-avustaja voi valmistella agentin, ja omistaja viimeistelee oman botin yhteyden.

Voiko tämä Telegram-botti vastata ääniviesteihin?

Quickchat AI:n Telegram-integraatio ei tällä hetkellä litteroi ääniviestejä agentille. Ääniliite voi näkyä Inboxissa, mutta tämä ohje käyttää kirjoitettuja viestejä. Pyydä oppilasta kirjoittamaan kysymys tai ihmistä tarkistamaan liite.

Automatisoiko tämä henkilökohtaisen Telegram-tilini?

Ei. Ohje luo erillisen botti-identiteetin omalla käyttäjänimellä. Telegram tarjoaa muita tilin automatisointitoimintoja, mutta tässä kuvattu Quickchat AI -yhteys käsittelee botille lähetettyjä viestejä eikä määritä vastauksia henkilökohtaisesta profiilistasi.

Quickchat AI Quickchat AI Ask Quickchat AI a question