Cum creezi un bot Telegram cu BotFather și adaugi AI

Piotr Grudzień
Publicat 18 min de lectură
Crearea unui bot Telegram cu BotFather și Quickchat AI, alături de o conversație Fernway reală cu răspunsuri despre cursuri, un PDF atașat și răspunsul unui operator

Pentru a crea un bot Telegram, deschide BotFather, trimite /newbot, alege un nume și un nume de utilizator, apoi copiază tokenul botului în serviciul care îl va rula. În acest tutorial, serviciul este Quickchat AI: îi oferă botului un Agent AI care răspunde pe baza informațiilor tale, fără să scrii cod sau să administrezi un server.

Vei construi Fernway Languages, o școală de engleză online fictivă. Un cursant poate deschide botul Telegram, verifica prețurile cursurilor, apăsa /schedule, cere un ghid al cursurilor în format PDF și solicita ajutorul unei persoane. Întregul parcurs rămâne în chatul Telegram al cursantului; echipa ta gestionează cunoștințele, Actions și conversațiile în Quickchat AI.

Fernway Languages în Telegram răspunde la întrebări despre prețuri și orarul cursurilor, apoi trimite ghidul PDF solicitat

Botul final în Telegram. Răspunsurile despre cursuri provin din baza sa de cunoștințe, iar broșura sosește ca un atașament PDF real.

Configurarea de bază începe cu crearea botului și continuă până la testarea răspunsurilor. Adaugă apoi trimiterea PDF-ului și transferul către un operator. Secțiunea despre grupuri explică modul în care păstrezi răspunsurile previzibile într-o conversație comună.

Descarcă pachetul de configurare Fernway cu informațiile, Main Prompt, lista de comenzi, fișa de test, avatarul și PDF-ul exemplu. Fișierele sunt exemple editabile de introdus în panoul de control, nu un import automat al Agentului.

Capturile de ecran, denumirile din interfață și exemplele de copiat rămân în engleză, astfel încât să poți reproduce configurația și mesajele de test din demonstrație.

De ce ai nevoie pentru a crea un bot Telegram fără cod?

Ai nevoie de un cont Telegram, un cont Quickchat AI și un bot nou pentru exercițiu. BotFather creează identitatea Telegram; Quickchat AI rulează Agentul din spatele ei.

  1. Conectează-te la Telegram pe mobil sau pe computer. Folosește contul oficial BotFather indicat în Pasul 1, nu un cont cu un nume asemănător.
  2. Creează un cont Quickchat AI și confirmă adresa de e-mail dacă ți se solicită. Planul Free permite învățarea personală, necomercială, în limitele consumului inclus. Folosește un plan comercial pentru utilizarea reală într-o afacere. Răspunsurile AI și Simulation Testing consumă credite; consultă planurile și limitele actuale.
  3. Păstrează ambele aplicații deschise. Folosește un bot de test nou, astfel încât exercițiul să nu modifice un canal de asistență existent. Un al doilea cont Telegram este util pentru a verifica experiența unui vizitator nou.

Telegram nu percepe o taxă pentru înregistrarea unui bot. Serviciul care generează răspunsurile AI are propriile limite de utilizare. Pentru această configurare nu ai nevoie de o cheie API separată pentru un model.

Ce face BotFather și ce face AI-ul?

BotFather gestionează identitatea și setările botului. Agentul conectat stabilește răspunsul folosind cunoștințele și instrucțiunile sale. Simpla creare a botului nu îi oferă informații despre cursuri sau un program care răspunde la mesaje.

Diagramă care separă setările de identitate din BotFather de mesajele Telegram și de răspunsurile Quickchat AI Telegram livrează mesajul cursantului serviciului conectat. Răspunsul Agentului revine în același chat.

ComponentăCe configureziCe vede cursantul
BotFatherNume, nume de utilizator, imagine de profil, descriere, meniu de comenzi și mod de confidențialitateIdentitatea botului și punctele de acces
Quickchat AIKnowledge Base, Main Prompt, mesajul de bun venit și ActionsRăspunsuri despre cursuri, PDF-ul solicitat și transferul către un operator
Echipa taInformații corecte despre cursuri și o Inbox monitorizatăUn răspuns uman când conversația are nevoie de el

Pasul 1: Cum creezi un bot Telegram în BotFather?

Trimite /newbot către contul oficial BotFather, apoi furnizează un nume afișat și un nume de utilizator unic.

  1. Deschide @BotFather în Telegram și selectează Start.
  2. Trimite /newbot.
  3. Când ți se cere un nume, trimite Fernway Languages. Acesta este numele afișat cursanților.
  4. Când ți se cere un nume de utilizator, alege ceva precum fernway_lessons_yourname_bot. Înlocuiește yourname cu un sufix unic. Folosește între 5 și 32 de litere latine, cifre sau caractere de subliniere; numele de utilizator nu fac diferența între majuscule și minuscule. Pentru această configurare gratuită standard, folosește un nume care se termină în bot. Dacă numele este ocupat, încearcă alt sufix. BotFather oferă și alte terminații conturilor Premium eligibile.
  5. BotFather returnează linkul botului și tokenul său de autentificare. Salvează linkul; îl vei folosi pentru a deschide chatul destinat cursantului. Păstrează tokenul privat pentru Pasul 4.

Interfața cu comenzi este suficientă pentru acest tutorial. BotFather poate oferi și o Mini App pentru administrarea boților; folosește comenzile de mai jos dacă ecranul tău arată diferit.

Conversație verificată cu BotFather care arată comanda newbot, numele Fernway Languages și confirmarea creării, cu numele de utilizator și tokenul mascate

BotFather creează identitatea și returnează linkul și tokenul. Numele de utilizator de test și întregul token sunt mascate.

Unde găsești tokenul botului tău Telegram?

Trimite /mybots către BotFather, selectează botul și deschide API Token. Tokenul autentifică cererile făcute în numele acelui bot. Lipește-l numai în câmpul dedicat din serviciu, nu în promptul Agentului, în baza de cunoștințe, într-un chat de asistență sau într-o captură de ecran.

Dacă un token este expus, trimite /revoke către BotFather, selectează botul și obține un token nou. Actualizează serviciul conectat cu noul token și testează un răspuns. Vechiul token nu mai funcționează; schimbarea numelui botului sau ștergerea unei capturi nu îl invalidează.

Un webhook are o singură destinație. Conectarea aceluiași bot la alt serviciu poate înlocui webhookul care livrează mesajele primite către Quickchat AI. Servicii separate pot face apeluri API de ieșire cu același token, dar nu primesc automat fiecare o copie a actualizărilor de intrare. Telegram împiedică și interogarea periodică prin getUpdates cât timp există un webhook instalat. Folosește un bot separat pentru un flux separat de mesaje primite. Documentația Telegram despre livrarea actualizărilor explică cele două mecanisme.

Pasul 2: Cum adaugi o imagine, o descriere și un meniu de comenzi?

Folosește comenzile de profil din BotFather pentru ca botul să poată fi recunoscut înainte ca un cursant să trimită primul mesaj. După fiecare comandă, alege botul și trimite valoarea de mai jos.

Trimite către BotFatherApoi furnizeazăUnde apare
/setnameFernway LanguagesNumele afișat în Telegram
/setuserpicÎncarcă fernway-avatar.png din pachetImaginea de profil
/setdescriptionDescrierea de mai josIntroducerea afișată înainte de începerea chatului
/setabouttextTextul scurt de profil de mai josProfilul botului și previzualizarea linkului distribuit
/setcommandsLista de comenzi de mai josMeniul pe care îl folosesc cursanții în conversație

Description (maximum 512 caractere):

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 (maximum 120 de caractere):

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

Lista de comenzi: lipește împreună aceste patru rânduri. Numele comenzilor din această listă BotFather nu încep cu o bară oblică.

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

Deschide profilul botului pentru a verifica numele, imaginea și textul de prezentare. Deschide chatul înainte de a selecta Start pentru a verifica introducerea. Telegram descrie setările individuale în ghidul BotFather.

După conectarea botului în Pasul 4 și selectarea Start, deschide meniul de comenzi și verifică toate cele patru intrări. Păstrează rândurile separate când lipești lista în BotFather; altfel, mai multe intrări pot deveni o singură descriere lungă de comandă.

Meniul de comenzi Fernway Languages din Telegram, cu prices, schedule, trial și help sub mesajul de bun venit configurat

Meniul final are patru intrări separate. Mesajul de deasupra lui se configurează în Quickchat AI în Pasul 3.

Diagramă a fluxului unei comenzi: BotFather adaugă intrarea în meniu, Telegram trimite textul comenzii, iar Main Prompt îi definește sensul Adăugarea /schedule în meniu nu implementează căutarea orarului. Pasul următor îi spune Agentului ce înseamnă acel mesaj.

Pasul 3: Cum faci botul Telegram să răspundă din informațiile tale?

Creează un Agent, adaugă informațiile școlii în Knowledge Base, apoi introdu regulile de răspuns în Main Prompt. Separarea faptelor de instrucțiuni permite schimbarea mai ușoară a unui preț fără a modifica comportamentul botului.

Capturile se deschid la dimensiunea completă când le selectezi. Folosește blocurile de copiat pentru textul exact și valorile cererilor.

Adaugă informațiile despre cursuri

  1. În Quickchat AI, creează un Agent nou și numește-l Fernway Languages. În Identity, setează același nume.
  2. Deschide Knowledge Base, selectează Add Article și folosește Fernway Languages course guide drept Title.
  3. Lipește textul următor în Content, apoi selectează Save. Așteaptă finalizarea procesării și afișarea stării Ready. Finalizează orice pas de publicare sau aplicare afișat înainte de a testa canalul real.

Editorul articolului de cunoștințe Fernway, cu titlul, prețurile cursurilor și orarul săptămânal Adaugă informațiile în Knowledge Base. Articolul complet de copiat de mai jos include și regulile pentru lecții de probă, rambursări și stabilirea nivelului.

Copiază articolul de cunoștințe Fernway
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.

Lipsa pragului de punctaj pentru stabilirea nivelului oferă un test relevant. Agentul poate răspunde cu prețul B1 dintr-o sursă, dar nu ar trebui să inventeze punctajul necesar unui cursant pentru înscriere.

Definește sensul comenzilor

Deschide Identity, selectează cardul Main Prompt marcat Edit și lipește promptul complet de mai jos. Lasă salvarea automată să se încheie, apoi redeschide-l pentru a verifica textul salvat.

Pagina Identity pentru Fernway Languages, cu Name și cardul Main Prompt editabil Deschide Main Prompt din Identity. Regulile sale definesc sensul comenzilor Telegram.

Copiază Main Prompt complet
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.

Acest prompt include pașii opționali pentru broșură și transfer, pe care îi vei configura mai târziu. Finalizează-i înainte de a distribui botul ca serviciu complet de asistență pentru cursanți. Un prompt poate solicita o Action; nu creează acea Action și nu conectează Telegram.

Formele adresate, precum /schedule@your_bot, contează când botul intră într-un grup. Contează și instrucțiunea de a folosi text simplu: răspunsurile obișnuite prin această integrare sunt trimise fără formatare Telegram Markdown.

Configurează mesajul de bun venit

Deschide Your Website, selectează fila Text Content și editează Welcome message. Acest mesaj comun este folosit și de conexiunea Telegram pentru botul propriu:

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.

Câmpul Welcome message cu salutul Fernway și sugestiile de comenzi Câmpul comun Welcome message se află în Your Website → Text Content; Telegram îl folosește pentru /start.

Integrarea botului propriu trimite acest salut configurat când un vizitator trimite /start. Este separat de descrierea BotFather afișată înainte de chat și de un răspuns AI la o întrebare despre cursuri.

Pasul 4: Cum conectezi tokenul la Quickchat AI?

Conectează-te prin Your own bot pentru a folosi identitatea Telegram tocmai creată.

  1. Deschide External Apps, selectează Telegram și alege Your own bot.
  2. Selectează Connect to Telegram, lipește tokenul de la BotFather în Bot Token, apoi selectează Connect to Telegram în dialog pentru a-l trimite.
  3. Activează Enable your own bot, apoi selectează Save.
  4. Deschide linkul t.me al botului în Telegram. Selectează Start sau trimite /start pentru a verifica salutul.

Setările Telegram din Quickchat AI arată botul Fernway conectat în Your own bot, cu Enable your own bot activat Panoul conexiunii reale arată identitatea botului și starea activată. Folosește Your own bot pentru identitatea creată în BotFather.

Dialogul Quickchat AI Connect to Telegram cu câmpul Bot Token gol Introdu tokenul în acest câmp. Captura nu conține în mod intenționat niciun token.

Opțiunea comună Quickchat AI bot din panou reprezintă o altă configurare. Oferă un link de chat specific Agentului, fără crearea unui bot propriu; demonstrația principală folosește propria identitate și propriul token. Ghidul pentru chatbot AI pe Telegram acoperă varianta comună.

Dacă dialogul de conectare descrie dezactivarea modului de confidențialitate pentru grupuri, păstrează confidențialitatea activată pentru fluxul cu comenzi adresate din acest tutorial. Chaturile private funcționează independent de setarea de confidențialitate a grupului. Secțiunea despre grupuri explică această alegere.

Pasul 5: Cum testezi botul Telegram?

Verifică atât răspunsul Agentului, cât și mesajul livrat în Telegram. Un test în panoul de control verifică logica răspunsului; numai o conversație Telegram verifică întregul canal.

Testează răspunsurile în Quickchat AI

Deschide Testing, alege Create Dataset, numește-l Fernway course answers și adaugă aceste mesaje ca rânduri separate:

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?

Rândul cu o comandă adresată folosește un nume de utilizator exemplu pentru a verifica regula promptului. Pentru testul real în Telegram, folosește numele efectiv al botului.

În Evaluation criteria, folosește:

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.

Alege Run când ai credite AI disponibile. Fiecare rând începe o conversație separată. Folosește o singură conversație continuă în AI Preview pentru a testa întrebări ulterioare, fără a considera următorul rând din set drept următoarea replică.

Șase teste Fernway Simulation finalizate, cu răspunsuri la prețuri și comenzi și rezultatul întrebării despre stabilirea nivelului Rezultate reale din Simulation local. Răspunsul despre nivel a primit un scor mai mic deoarece evaluatorul nu putea observa transferul; Inbox a confirmat schimbarea efectivă a responsabilului.

Testează experiența cursantului în Telegram

Trimite următoarele mesaje în chatul privat al botului real și așteaptă fiecare răspuns. Folosește Inbox pentru a găsi întrebarea și răspunsul corespunzătoare.

Lasă întrebarea despre punctajul de nivel pentru final, după Pașii 6 și 7. Aceasta poate transfera conversația către personal și poate întrerupe răspunsurile automate.

Mesaj sau acțiuneRezultat corect
/startApare mesajul de bun venit configurat
How much is the B1 English course?EUR120 pentru întregul curs de patru săptămâni
Apasă /schedule în meniuAmbele orare săptămânale, marcate clar UTC
Apasă /trialO solicitare pentru o lecție de probă de 20 de minute, cu disponibilitatea lăsată în seama echipei
I scored 62 on your placement test. Do I qualify for B1?Niciun prag inventat sau verdict de eligibilitate; echipa trebuie să confirme

Fernway Languages în Telegram refuză să stabilească eligibilitatea pentru B1 dintr-un punctaj de 62 la testul de nivel

Răspunsul real lasă decizia privind nivelul în seama echipei. Broșura și răspunsul uman anterior rămân vizibile în aceeași conversație.

Quickchat AI Inbox cu aceeași întrebare Telegram despre nivel, răspunsul Agentului și o conversație Unassigned Vizualizarea corespunzătoare din Inbox arată atât răspunsul, cât și starea Unassigned a conversației.

În testul real, Agentul nu a dedus un nivel din punctaj. Inbox a afișat ulterior conversația ca Unassigned, cu transferul Lack Of Knowledge activat. Verifică separat răspunsul și atribuirea; un evaluator al răspunsurilor nu poate stabili cine deține chatul. Rulează această verificare de nivel după celelalte teste de conversație sau selectează AI Agent în meniul responsabilului din Inbox înainte de a continua răspunsurile automate.

Dacă un răspuns este greșit, verifică articolul relevant și promptul salvat, modifică un singur lucru și repetă același mesaj într-o conversație nouă. Pentru o comandă care eșuează, verifică regula exactă; pentru un preț greșit, verifică regăsirea și publicarea informațiilor. Înregistrează răspunsul efectiv, fără să consideri configurarea corectă doar fiindcă indicatorul conexiunii este verde.

Setul de șase mesaje este un punct de pornire. Ghidul de testare a unui Agent AI de asistență arată cum îl extinzi cu situații realiste de eroare și o grilă de evaluare înainte de lansare.

Pasul 6: Cum faci botul să trimită un PDF?

Adaugă o singură API Action care trimite un ghid fix al cursurilor în chatul Telegram curent. Agentul decide dacă l-a cerut cursantul; integrarea furnizează tokenul și destinația.

Diagramă cu cele trei surse fixe pentru Action de document: System Token, metadatele canalului pentru chatul curent și un URL public al PDF-ului Cursantul nu furnizează un token sau un ID de chat. Această Action nu are parametri completați de model.

Descarcă fernway-course-guide.pdf din pachet pentru a verifica exemplul. Configurarea folosește URL-ul său public de pe acest site. Pentru fișierul tău, folosește un URL HTTPS direct pe care Telegram îl poate accesa fără autentificare și care returnează un PDF cu tipul de conținut corect. Păstrează documentele preluate prin URL sub 20 MB. Telegram distinge preluarea prin URL de încărcarea fișierelor în documentația despre trimiterea fișierelor.

Deschide Actions & MCPs, selectează Add Action, alege constructorul API Action și configurează aceste câmpuri. Dacă acesta oferă o schiță generată, verifică cererea efectivă față de configurația de mai jos înainte de activare.

Editorul API Action cu POST sendDocument, o referință Telegram System Token și metadatele chatului curent în corpul JSON Elementul tokenului aparține URL-ului; cel pentru metadatele chatului aparține câmpului Body. URL-ul PDF-ului este fix.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
Fără parametriNiciunulLasă această secțiune goală. Toate valorile cererii provin din conexiune sau din configurația fixă.Nu se aplică

API Endpoint: metodă și URL

Alege POST și introdu:

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

Folosește Add AI Data pentru a insera telegram_bot_token din System Tokens. Aceasta este o referință la tokenul botului conectat, nu un loc în care să lipești tokenul propriu-zis.

Headers

CheieValoare
Content-Typeapplication/json

Body: lipește în fila Body a API Endpoint.

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

Inserează telegram_chat_id din metadatele conversației prin Add AI Data. Forma sa de șablon este {{metadata_telegram_chat_id}}. Canalul Telegram îl setează pe baza chatului de intrare, astfel încât PDF-ul revine în conversația respectivă. Lasă URL-ul documentului și textul atașamentului fixe.

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.

Salvează și activează această Action. Main Prompt complet conține deja regula pentru solicitarea explicită. Metoda Bot API este documentată la sendDocument.

Verifică fișierul, nu doar răspunsul

  1. În Telegram, trimite How much is the B1 English course?. Verifică dacă primești prețul fără un fișier nesolicitat.
  2. Trimite Can you send me the brochure?.
  3. Confirmă că sosește un atașament PDF și că deschide ghidul cursurilor Fernway.
  4. În Inbox, deschide conversația și extinde cardul apelului Action. Pe cardul Action din Actions & MCPs, deschide View logs pentru a verifica cererea și rezultatul. Tokenul trebuie mascat înainte de distribuirea unei capturi.
  5. Confirmă că destinația este chatul curent și că s-a trimis un singur document pentru solicitare.

În testul real, send_course_brochure a returnat HTTP 200 cu răspunsul Telegram ok: true. Captura de la început arată atașamentul rezultat fernway-course-guide.pdf în chatul cursantului. Rezultatul cererii și fișierul primit verifică împreună livrarea; textul de confirmare al Agentului singur nu o dovedește.

Rulează testul de livrare în Telegram. Conversațiile Simulation nu au contextul real al tokenului botului Telegram. Folosește Simulation pentru verificarea răspunsurilor și chatul Telegram real pentru verificarea livrării fișierului.

Pasul 7: Cum transferi un chat Telegram către o persoană?

Activează Human Handoff, astfel încât o solicitare de ajutor uman să schimbe responsabilul conversației, apoi cere unui coleg să răspundă din Inbox.

  1. Deschide Actions & MCPs, activează Human Handoff și selectează Edit Action.
  2. Păstrează valorile implicite pentru Handoff Rules, cu Media Message, User Frustration, Customer Support Suggestion și Lack Of Knowledge activate, iar Irrelevant Advice dezactivată. Main Prompt asociază deja /help cu o solicitare pentru o persoană; demonstrația nu adaugă o regulă personalizată de transfer.
  3. Pentru exercițiul supravegheat, lasă Human Agents’ availability dezactivată și păstrează un coleg la Inbox în timpul testelor. Lasă Email notifications dezactivată. Acestea au fost setările demonstrației; un transfer fără restricții de program nu înseamnă că o persoană este mereu disponibilă.
  4. Înainte de lansare, activează programul de disponibilitate și setează fusul orar și orele de lucru în funcție de prezența reală a echipei. Configurează corespunzător mesajul din afara programului.
  5. Salvează această Action. În chatul privat al botului, trimite I want to talk to a person. Dacă botul cere confirmare, răspunde Yes.
  6. În Inbox, verifică dacă AI-ul nu mai este responsabil de conversație. Selectează Assign to me și trimite Hi, this is Alex from Fernway. Which course would you like help with?. Verifică dacă mesajul ajunge în Telegram.
  7. Trimite încă un mesaj al cursantului cât timp persoana deține chatul. Confirmă că AI-ul nu intervine. Deschide meniul responsabilului și selectează AI Agent, apoi trimite o nouă întrebare despre cursuri pentru a verifica reluarea răspunsurilor automate.

Conversație Telegram reală în Quickchat AI Inbox, cu solicitarea de ajutor uman, starea Unassigned și butonul Assign to me Solicitarea lasă chatul real în starea Unassigned, pregătit pentru un coleg care selectează Assign to me. Răspunsul anterior despre broșură are și un indicator restrâns al apelului Action.

Ciclul de transfer de la răspunsuri AI despre cursuri la automatizare întreruptă, răspuns uman din Inbox și reatribuire Cursantul rămâne în Telegram. Un transfer reușit necesită schimbarea responsabilului și livrarea unui răspuns uman. Selectează AI Agent în meniul responsabilului când automatizarea trebuie reluată.

Conversația Fernway din Telegram arată solicitarea unei persoane, confirmarea transferului, răspunsul operatorului Alex și mesajul ulterior al cursantului

Răspunsul operatorului din Inbox ajunge în același chat Telegram. Cursantul poate continua fără să schimbe aplicația.

Quickchat AI Inbox arată răspunsul operatorului, mesajul ulterior al cursantului și conversația reatribuită către AI Agent După intervenția operatorului, conversația revine la AI Agent. Următoarea întrebare despre nivel a primit răspunsul AI prezentat în Pasul 5.

O informație lipsă poate duce la transfer, așa cum s-a întâmplat în testul local despre nivel. Verifică separat ambele rezultate: răspunsul trebuie să evite presupunerile, iar orice transfer pretins trebuie să schimbe responsabilul din Inbox. Ghidul Human Handoff explică mai detaliat disponibilitatea și rutarea.

Tutorialul despre transferul de la chatbot la un operator adaugă teste pentru solicitări în afara programului și pentru a verifica dacă răspunsurile automate continuă să funcționeze după reatribuire.

Cum se comportă botul într-un grup Telegram?

Modul de confidențialitate controlează ce mesaje de grup livrează Telegram unui bot. Conexiunea Quickchat AI pentru botul propriu procesează mesajele pe care le primește; nu adaugă un filtru separat care limitează răspunsurile doar la mențiuni.

Diagramă a livrării în grup: comenzile adresate și replicile ajung la bot cu confidențialitatea activată; discuțiile obișnuite ajung când aceasta este dezactivată sau botul este administrator Diagrama acoperă tipurile de mesaje folosite în tutorial. Telegram documentează și mesajele de serviciu și rutarea comenzilor în funcție de context.

Pentru un grup de curs în care botul trebuie să răspundă solicitărilor directe:

  1. Trimite /setjoingroups către BotFather, alege botul și activează participarea la grupuri dacă este dezactivată.
  2. Trimite /setprivacy, alege botul și selectează Enable. Păstrează-l ca membru obișnuit, fără drepturi de administrator. Dacă ai schimbat modul de confidențialitate după adăugare, elimină botul și adaugă-l din nou pentru ca setarea să se aplice.
  3. Adaugă botul într-un grup mic de test pe care îl controlezi.
  4. Trimite un mesaj obișnuit, precum See everyone in class tomorrow. Acesta nu ar trebui să declanșeze un răspuns în această configurație.
  5. Trimite /schedule@your_bot, înlocuind your_bot cu numele de utilizator real. Verifică răspunsul despre orar, apoi folosește funcția Reply din Telegram pe acel răspuns pentru a întreba What does B1 cost?.

Un simplu /schedule poate depinde de botul căruia i s-a adresat ultima comandă. O mențiune @mention în text simplu nu este un înlocuitor sigur pentru o comandă adresată în modul de confidențialitate standard. Folosește formele explicite din testul de mai sus. Consultă regulile Telegram pentru modul de confidențialitate.

BotFather arată participarea la grupuri și confidențialitatea activate pentru botul Fernway

Setarea salvată în BotFather este Enable. Rulează verificările mesajelor de grup cu botul propriu pentru a confirma livrarea în grupul respectiv.

Testul separat de grup de mai jos a folosit botul comun @QuickchatAI_bot, conectat la același Agent Fernway. Acesta a răspuns unei comenzi adresate despre orar și unei întrebări despre preț trimise ca replică la mesajul botului. Exemplul ilustrează alternativa cu botul comun; botul nostru propriu Fernway a fost verificat în chat privat, deci comportamentul său în grup necesită în continuare testele de mai sus.

Fernway Study Group cu botul comun Quickchat AI, care răspunde unei comenzi adresate despre orar și unei replici cu întrebarea despre prețul cursului B1

Acest grup folosește botul comun @QuickchatAI_bot. Botul propriu Fernway este identitatea prezentată în capturile din chatul privat.

Dezactivarea confidențialității sau promovarea botului la administrator poate face ca discuțiile obișnuite din grup să ajungă la Agent și să producă mai multe răspunsuri. Pentru moderare, tutorialul despre administrarea grupurilor Telegram explică permisiunile suplimentare și controalele pentru Actions.

Un grup reprezintă o singură conversație comună. Întrebările personale legate de cursuri aparțin chatului privat al botului. Dacă Human Handoff se declanșează în grup, AI-ul se oprește pentru întregul grup până la reatribuire; nu creează o conversație privată separată pentru acel cursant.

De ce nu răspunde botul tău Telegram?

Începe cu cel mai simplu test de chat privat, apoi verifică conexiunea și tipul mesajului. Comportamentul în grup și livrarea fișierelor introduc dependențe separate.

ProblemăCe verifici
BotFather a creat botul, dar acesta taceFinalizează conectarea Agentului. BotFather nu furnizează logica răspunsurilor.
Nu apare salutulDeschide botul corect, trimite /start și verifică Enable your own bot și Welcome message configurat.
S-a oprit după încercarea altui serviciu de boțiServiciul poate să fi înlocuit webhookul. Reconectează serviciul dorit; folosește un bot separat pentru celălalt flux.
S-a oprit după înlocuirea tokenuluiActualizează Bot Token cu noua valoare și salvează conexiunea.
Răspunde în privat, dar nu în grupVerifică apartenența la grup, confidențialitatea și numele de utilizator real. Încearcă /schedule@your_bot sau o replică la un mesaj al botului.
Răspunde la fiecare mesaj din grupVerifică dacă modul de confidențialitate este dezactivat sau botul este administrator. Revino la configurația mai puțin intruzivă de mai sus.
O comandă apare în meniu, dar primește un răspuns irelevantVerifică regula Main Prompt, inclusiv forma adresată a comenzii. Înregistrarea în meniu nu definește singură comportamentul.
Spune că a trimis PDF-ul, dar nu apare atașamentulVerifică apelul Action efectiv, URL-ul direct al PDF-ului și răspunsul Telegram. Testează prin Telegram, cu conexiunea botului propriu activată.
Răspunde până la transfer, apoi se opreșteVerifică responsabilul din Inbox. O conversație deținută de o persoană sau neatribuită așteaptă personalul ori reatribuirea.
Agentul nu poate răspunde sau testele nu mai ruleazăVerifică creditele disponibile, procesarea informațiilor și dacă Agentul este activat.
Telegram returnează o eroare de limitare a frecvențeiRedu frecvența mesajelor și respectă intervalul de reîncercare returnat de Telegram.

Înainte de a distribui botul, repetă în privat testele pentru preț, informații necunoscute, PDF și răspuns uman, folosind conținutul tău real. Înlocuiește toate detaliile și linkurile Fernway cu ale tale. Pentru referința actuală de configurare, folosește documentația canalului Telegram.

Pot ChatGPT sau Claude să ajute la construirea acestui bot?

Un client AI conectat la contul tău Quickchat AI poate pregăti Agentul, cunoștințele, instrucțiunile, Actions și setul de teste. Tot tu creezi identitatea Telegram în BotFather și introduci tokenul în fluxul pentru botul propriu din panou.

Conectează-te prin listarea verificată ChatGPT sau listarea Claude, urmând instrucțiunile Manage with AI. Oferă asistentului pachetul de configurare și această cerere:

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.

Conexiunea pentru administrarea contului folosită aici este separată de expunerea unui Agent ca instrument MCP. Poate ajuta la configurarea fluxului; nu elimină necesitatea verificării unui răspuns Telegram real și a atașamentului.

Întrebări frecvente

Cum creez un bot Telegram fără cod?

Deschide contul oficial BotFather în Telegram, trimite /newbot și alege un nume afișat și un nume de utilizator unic terminat în bot. Conectează tokenul primit la un serviciu pentru boți, precum Quickchat AI. Adaugă informațiile și instrucțiunile tale, activează conexiunea și testează apoi un mesaj privat. BotFather creează identitatea; serviciul conectat furnizează răspunsurile.

Este gratuită crearea unui bot Telegram?

Înregistrarea unui bot Telegram prin BotFather este gratuită. Quickchat AI oferă planul Free pentru învățare personală, necomercială, cu un număr limitat de credite AI. Utilizarea în afaceri necesită un plan comercial. Răspunsurile AI și Simulation Testing consumă credite; crearea identității Telegram nu include utilizare AI nelimitată.

Unde găsesc tokenul botului meu Telegram?

Deschide contul oficial BotFather, trimite /mybots, alege botul și selectează API Token. Lipește tokenul în câmpul dedicat Bot Token al serviciului pentru boți. Nu îl introduce într-un prompt, într-un articol de cunoștințe, într-un repository public sau într-o captură de ecran.

Ce fac dacă tokenul botului meu Telegram este expus?

Folosește /revoke în BotFather pentru a invalida tokenul expus, obține unul nou, apoi actualizează serviciul conectat și testează un răspuns. Elimină și copia expusă, dar nu te baza doar pe ștergere: oricine a salvat vechiul token îl poate folosi până la revocare.

Pot conecta un bot Telegram la două platforme?

Un bot are o singură destinație webhook pentru actualizările primite. Dacă o a doua platformă înlocuiește webhookul, prima nu mai primește acele actualizări. Mai multe sisteme pot face în continuare apeluri API de ieșire, dar mesajele primite nu sunt copiate automat către ambele. Folosește boți separați pentru fluxuri independente de intrare.

Cum adaug comenzi botului meu Telegram?

Trimite /setcommands către BotFather, alege botul și furnizează câte o pereche comandă-descriere pe rând, fără o bară oblică la început. Astfel creezi meniul. Trebuie să implementezi și comportamentul: în acest tutorial, Main Prompt asociază /prices, /schedule, /trial și /help cu răspunsurile corespunzătoare sau cu o Action.

De ce botul meu Telegram răspunde în privat, dar nu în grup?

Verifică dacă botul aparține grupului și încearcă o comandă adresată numelui său real de utilizator, precum /schedule@your_bot, sau răspunde unui mesaj al său. Cu confidențialitatea activată, discuțiile obișnuite din grup nu sunt livrate unui bot fără drepturi de administrator. O mențiune în text simplu nu înlocuiește în mod fiabil o comandă adresată.

Pot adăuga AI sau ChatGPT unui bot Telegram?

Poți conecta un bot BotFather la un serviciu AI. Acest tutorial folosește un Agent Quickchat AI cu propriile cunoștințe, Main Prompt și Actions; nu conectează conversația ta personală ChatGPT la Telegram. Un asistent compatibil pentru administrarea contului poate pregăti Agentul, în timp ce proprietarul finalizează conexiunea botului propriu.

Poate acest bot Telegram să răspundă la mesaje vocale?

Integrarea Telegram din Quickchat AI nu transcrie în prezent mesajele vocale pentru Agent. Un atașament audio poate apărea în Inbox, dar tutorialul se bazează pe mesaje scrise. Cere cursantului să scrie întrebarea sau roagă o persoană să verifice atașamentul.

Acest proces îmi automatizează contul personal de Telegram?

Nu. Tutorialul creează o identitate de bot separată, cu propriul nume de utilizator. Telegram oferă alte funcții de automatizare a contului, dar conexiunea Quickchat AI descrisă aici gestionează mesajele trimise botului; nu configurează răspunsuri din profilul tău personal.

Quickchat AI Quickchat AI Ask Quickchat AI a question