Un chatbot AI pentru Telegram poate răspunde folosind informațiile firmei, în grup sau în privat. Quickchat AI conectează un Agent AI la Telegram printr-un bot comun: adaugă-l în grup, confirmă conexiunea în panoul de control, iar membrii îl pot menționa pentru a pune întrebări. Nu ai nevoie de cod sau de un token BotFather.
Ghidul construiește Saltmarsh Sailing School, o școală fictivă cu un grup de membri și solicitări private. Doi Agenți folosesc aceleași informații: Saltmarsh Group răspunde public, iar Saltmarsh Sailing School preia cereri private pentru lecții de probă și implică un om pentru rambursări. Cererea ajunge la birou, fără a reprezenta o rezervare confirmată.
Doi Agenți separă responsabilitățile. Agentul de grup nu are Action pentru transfer sau înregistrarea cererilor; cel privat gestionează solicitările și răspunsurile personalului.
Urmează traseul de mai jos. Extensia Google Sheets este opțională; poți finaliza mai întâi răspunsurile și transferul către un om.
| Ce construiești | Punct de verificare |
|---|---|
| 1. Cunoștințe și instrucțiuni | Agentul știe prețul cursului și nu inventează informații lipsă. |
| 2. Conectarea grupului | Răspunde la mențiuni și tace în conversațiile obișnuite. |
| 3. Chat privat | Linkul complet deschide conversația cu Agentul corect. |
| 4. Cereri opționale pentru lecții | Datele obligatorii devin un rând pe care personalul îl poate procesa. |
| 5. Human Handoff | Un om preia conversația, iar AI se oprește. |
| 6. Testare | Verifici separat răspunsurile, direcționarea și efectele externe. |
Descarcă kitul Saltmarsh pentru Telegram cu informațiile exacte, Main Prompt, rețeta Action, criteriile de evaluare și mesajele de test. Sunt fișiere editabile pentru pașii următori, nu un import automat al Agentului. Fișierele demonstrative, mesajele și capturile rămân în engleză pentru a corespunde exemplului verificat.
De ce ai nevoie pentru un chatbot Telegram?
Ai nevoie de un cont Quickchat AI, doi Agenți și un cont Telegram autorizat să adauge un bot într-un grup de test. Înregistrarea opțională a cererilor necesită și un cont Google care poate autoriza Google Sheets.
- Creează un cont Quickchat AI și verifică adresa de e-mail dacă ți se solicită. Free permite învățare personală, necomercială. Planurile se aplică fiecărui Agent; o firmă care îi folosește pe amândoi are nevoie de acoperire comercială pentru fiecare. Preview și Simulation consumă credite AI. Consultă planurile actuale.
- Creează grupul Telegram
Saltmarsh Members. Într-un grup de test poți verifica mențiunile, lipsa răspunsului și continuările înainte să inviți clienți. - Folosește propriul cont Telegram pentru acest ghid, inclusiv pentru mesajele vizitatorului. Poți opera și Inbox din Quickchat AI. Înainte de a invita clienți, roagă un coleg să verifice experiența din alt cont.
- Dezarhivează kitul. Păstrează împreună informațiile școlii; înainte de lansare, înlocuiește-le cu propriile reguli verificate.
Capturile Quickchat App arată o aplicație care rulează local, cu configurația fictivă Saltmarsh; legendele identifică datele de test pentru conexiuni. Capturile Telegram și Google Sheets arată răspunsurile reale și cererea salvată în demonstrația conectată. Datele personale ale contului sunt eliminate prin decupare sau ascunse explicit. Folosește lista finală pentru a repeta verificările cu propriile informații și conturi conectate.
Pasul 1: Cum înveți chatbotul Telegram informațiile firmei?
Pune datele firmei în Knowledge Base, iar instrucțiunile de lucru în Main Prompt. Separarea lor simplifică modificarea unui răspuns fără schimbarea comportamentului Agentului.
Prețurile și politicile sunt fapte din surse. Concizia, incertitudinea și direcționarea sunt instrucțiuni.
Creează Agentul și adaugă informațiile
- Într-un cont nou, alege Set up manually. Într-un cont existent, selectează întâi Add new AI Agent, apoi configurarea manuală.
- În Identity, introdu
Saltmarsh Groupîn Name your AI Agent. Lipeștegroup-main-prompt.txtdin kit în Describe what you want your agent to do. - Continuă configurarea fără aplicații externe. Finalizează alegerea planului, folosind Skip for now dacă începi cu un cont pentru învățare.
- Deschide Knowledge Base > Add Article. Introdu
Courses and trial enquiriesîn Create custom article, selectează Create article, lipeștesaltmarsh-courses.txtîn Content, apoi Save. - Repetă pentru
Weather, parking and personal enquiriescusaltmarsh-policies.txt. Așteaptă ca ambele articole să afișeze Ready. - Deschide Actions & MCPs la Saltmarsh Group. Lasă Human Handoff dezactivat și nu adăuga Action pentru cereri de lecții.
- Selectează Add new AI Agent și repetă configurarea pentru
Saltmarsh Sailing School, cumain-prompt.txtși aceleași două fișiere de cunoștințe. Acest Agent gestionează conversațiile private. Înainte de modificări, selectează Agentul dorit în selectorul contului.
Două surse scurte arată clar ce știe Agentul. Verifică Ready înaintea testului de cunoștințe.
| Informații | Faptele exacte din exemplu |
|---|---|
| Cursuri | Start Sailing: două zile, EUR 240. Day Skipper theory: cinci seri, EUR 310. Lecție privată: 90 de minute, EUR 95. |
| Date | Sezon din aprilie până în octombrie; date publicate cu o lună înainte. Nu există disponibilitate în timp real sau următoarea dată. |
| Echipament | Jachetă impermeabilă, încălțăminte care nu lasă urme și haine de schimb. Școala oferă veste de flotabilitate. |
| Vreme | Peste 25 de noduri sau furtuni: reprogramare la prima dată disponibilă, fără cost suplimentar. Instructorul decide în dimineața respectivă. |
| Parcare | Gratuită la club. Codul porții se trimite cu o zi înainte; codul efectiv lipsește. |
| Lecții de probă | Colectează numele, ziua preferată din săptămână și experiența de navigație. Biroul confirmă disponibilitatea și prețul. |
Închirierea costumelor de neopren lipsește intenționat. Agentul trebuie să spună că nu poate confirma, nu să inventeze un da sau nu. Regula meteo nu oferă prognoza de azi, iar prețul unei lecții private nu stabilește prețul unei lecții de probă.
Setează Main Prompt și verifică un răspuns
- Deschide Identity > Main Prompt la fiecare Agent și verifică promptul Saltmarsh corespunzător. Cel de grup răspunde la întrebări generale și indică linkul privat fixat în grup; cel privat colectează cereri și folosește Human Handoff.
- Deschide AI Preview și întreabă
How much is Start Sailing?. Verifică două zile și EUR 240. - Întreabă
Do you rent wetsuits?. Verifică dacă răspunsul recunoaște lipsa informației.
Promptul Agentului privat definește colectarea și transferul. Agentul de grup are prompt separat și ambele Actions dezactivate.
Două decupaje din setările reale ale Agentului de grup. Poate răspunde din cunoștințe, dar nu are Action pentru cereri sau transfer.
Doi Agenți fac direcționarea explicită. Cel de grup nu poate declanșa accidental un transfer; cel privat poate preda o rambursare fără a opri grupul. Preview verifică informațiile școlii, iar pașii următori verifică fiecare conexiune Telegram.
Pasul 2: Cum adaugi chatbotul AI într-un grup Telegram?
Deschide External Apps > Telegram, adaugă botul comun în grup, apoi revino în Quickchat AI și selectează Confirm. Agentul tace în grup până la confirmare.
Apartenența la Telegram și confirmarea în Quickchat AI sunt pași separați.
- Selectează Saltmarsh Group în selectorul de Agenți. Deschide External Apps, selectează Telegram și găsește Quickchat AI bot.
- Selectează Add to a Telegram group. În Telegram, alege
Saltmarsh Membersși aprobă adăugarea botului. - Revino în Quickchat AI. În Waiting for your confirmation, verifică numele grupului și Added by.
- Selectează Confirm pentru grupul corect. Acesta ar trebui să apară în Connected chats, cu activarea pornită.
- În Telegram, scrie
@și selectează botul din lista de mențiuni. ÎntreabăHow much is Start Sailing?. Numele botului comun este de obicei@QuickchatAI_bot; folosește numele real din grup. - Răspunde direct acelei replici cu
What should I bring?. Apoi trimite separat, fără mențiune:Does anyone know the gate code?. Botul comun trebuie să răspundă replicii și să ignore mesajul obișnuit.
Alege Saltmarsh Members în Telegram, apoi revino în Quickchat AI pentru a confirma conexiunea.
Interfață locală reală cu un grup de test preîncărcat, care arată unde apare Confirm. Ilustrează controlul, fără a demonstra conectarea unui grup Telegram real.
Grupul confirmat a primit răspunsul așteptat despre curs. Menționează botul folosind numele său real de utilizator.
Răspunsul la mesajul botului funcționează fără o nouă mențiune. Răspunsul enumeră informațiile furnizate despre echipament.
Confirmarea contează deoarece datele invitației apar în grup. Quickchat AI cere o decizie din cont înainte să trateze grupul ca destinație a Agentului. Nu confirma un grup necunoscut. Documentația conexiunii Telegram explică aceeași limită.
Finalizează confirmarea înainte de a părăsi configurarea. Dacă botul iese dintr-un grup neconfirmat, generează un link nou Add to a Telegram group, adaugă-l din nou și confirmă imediat grupul în așteptare în Quickchat AI. Adăugarea botului prin căutarea membrilor în Telegram nu înlocuiește acest flux de conectare.
Eticheta Admin indică statutul botului în Telegram. Nu este necesară pentru răspunsurile obișnuite ale botului comun. Nici acordarea rolului de administrator nu schimbă regula mențiunilor sau replicilor.
Pasul 3: Cum activezi conversațiile private Telegram?
Activează Direct message link și distribuie URL-ul complet generat. Linkul selectează Agentul în botul comun, astfel încât clienții pot scrie în privat fără a-l adăuga într-un grup.
Grupul este o conversație comună. Mută datele personale și transferurile către personal în mesaje private.
- Selectează Agentul privat Saltmarsh Sailing School. În External Apps > Telegram, activează Direct message link. Lasă conexiunile la grupuri necompletate.
- Copiază linkul generat. Păstrează parametrul
start=; un simplu link către botul comun nu identifică Agentul. - Deschide-l în Telegram și apasă Start dacă este cerut.
- Întreabă
How much is Start Sailing?fără menționarea botului. Verifică răspunsul școlii și găsește conversația în Inbox. - Fixează linkul în mesajul de bun venit al grupului, înainte ca oamenii să publice date personale.
Folosește linkul generat pentru propriul Agent. Configurația locală nu este dovadă de livrare într-un cont Telegram real.
Telegram a livrat mesajul de bun venit Saltmarsh după Start. Verifică apoi un răspuns bazat pe cunoștințe; salutul singur nu testează regăsirea informațiilor.
Două decupaje din același ecran Telegram arată invitația fixată. Valoarea start a linkului demonstrativ este omisă; fixează propriul link generat complet.
Un chat privat cu botul comun este legat de un singur Agent la un moment dat. Linkul altui Agent poate schimba asocierea. Pentru propria identitate Telegram și un fir dedicat, urmează varianta cu bot propriu.
Dezactivarea Direct message link blochează conexiunile noi prin acel link. Pentru un chat existent, folosește comutatorul său sau Disconnect. Linkul este o intrare publică, nu o restricție de acces la informații confidențiale.
Pasul 4: Cum salvezi o cerere de lecție de probă în Google Sheets?
Integrarea Google Sheets creează o foaie și o Action de adăugare a rândurilor. Adapteaz-o pentru cele trei câmpuri obligatorii, apoi verifică rândul real. Pasul este opțional și funcționează cu botul comun Telegram.
Rezultatul este o solicitare pentru personal. Nu rezervă un loc și nu stabilește prețul lecției de probă.
Conectează Sheets și configurează o Action
- La Saltmarsh Sailing School, deschide Actions & MCPs > Add Action > Google Sheets și Connect Google Sheets. Autentifică-te în contul Google dorit și aprobă accesul solicitat.
- Deschide foaia creată Quickchat Leads. Păstrează fila Leads, deoarece URL-ul Action o vizează.
- Înlocuiește antetul în această ordine:
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - În Actions & MCPs, editează Action generată
log_lead_to_google_sheet. Urmează rețeta de mai jos. Schimbă împreună parametrii, corpul cererii și antetele pentru a păstra ordinea corectă.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Numele oferit de persoană pentru această cerere. Solicită-l dacă lipsește. | Da |
| Text | preferred_weekday | Ziua preferată din săptămână, de exemplu marți. Este o preferință, nu o dată confirmată. | Da |
| Text | sailing_experience | Experiența declarată de navigație, de exemplu începător. Întreabă dacă lipsește; nu o deduce. | Da |
Setează No default pentru toate cele trei câmpuri și elimină parametrii impliciți pentru e-mail și întrebare. Rețeta cere doar aceste trei date. Numele Telegram este opțional și nu este un contact obligatoriu fiabil; linkul conversației permite personalului să revină la solicitare.
Metodă și URL: păstrează URL-ul POST generat. Conține deja ID-ul foii, fila Leads și valueInputOption=RAW. Nu trebuie completat un ID substituent.
Antete: păstrează configurația integrării.
| Antet | Valoare |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
În fila Body a API Endpoint, folosește:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Utilizează Add AI Data pentru parametrii și variabilele conversației. Primele trei valori provin din conversație; ultimele două sunt furnizate de Quickchat AI.
API Action Description
In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.
În Advanced settings > Run only when, adaugă telegram_chat_type equals private. Folosește cheia simplă, fără metadata_ sau acolade. Astfel, cererea HTTP nu rulează pentru un mesaj de grup, chiar dacă modelul încearcă. Documentația condițiilor de rulare explică verificarea.
Setează Response filter la $.updates.updatedRows, pentru a returna numărul rândurilor în locul unui răspuns inutil de mare. Lasă Action activată.
Cheia simplă este telegram_chat_type. Condiția se verifică înaintea trimiterii cererii.
Configurație locală a rețetei. URL-ul Sheets și autorizarea OAuth trebuie obținute din propria conexiune Google.
Verifică rândul, apoi cererea incompletă
Trimite următorul mesaj prin linkul privat Telegram al Agentului:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Verifică trei locuri: răspunsul descrie o solicitare, cardul Action din Inbox arată valorile primite, iar fila reală Leads conține rândul corespunzător. Nici un răspuns liniștitor, nici un scor mare în Simulation nu demonstrează scrierea în Sheets.
Agentul a înregistrat numele furnizat, preferința pentru marți și experiența de începător. Disponibilitatea și prețul exact trebuie încă confirmate de birou.
Două detalii ale aceluiași rând salvat păstrează lizibile toate cele cinci coloane. Linkul conversației specific contului este ascuns; celelalte patru valori sunt neschimbate.
Începe un test separat cu I would like a trial lesson. Înainte să execute Action, Agentul trebuie să ceară câmpurile lipsă, câte o întrebare. Încearcă și How much is Start Sailing?; o întrebare obișnuită nu trebuie să creeze un rând. Promptul cere o singură scriere per solicitare, dar rețeta nu este un sistem de rezervări idempotent. Verifică duplicatele înainte de utilizarea operațională.
Pasul 5: Cum transferi o conversație Telegram unui om?
Configurează Human Handoff, apoi verifică atribuirea în Inbox. O instrucțiune care spune „biroul va răspunde” nu transferă singură responsabilitatea și nu oprește AI.
Verificarea este schimbarea atribuirii. Un om finalizează cazul; revenirea la AI se testează separat.
- Selectează Saltmarsh Sailing School, apoi Actions & MCPs > Human Handoff și activează-l. Lasă Action oprită pe Saltmarsh Group.
- În Handoff Rules, selectează +. Introdu
Private enquiriesîn Rule Name, lipeștehandoff-rule.txtîn Description și activează State. Rândurile noi sunt inactive. Regula acoperă rambursările, reclamațiile, cererile de a vorbi cu un om și acceptarea ajutorului uman pentru Agentul privat. - Golește Keywords, dezactivează regulile predefinite și salvează cu o singură regulă personalizată activă. Grupul este izolat prin Human Handoff dezactivat pe Agentul separat; regula descrie când transferă Agentul privat.
- Setează Confirmation la
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Configurează Human Agents’ availability după programul real și folosește un mesaj sincer în afara programului. - Din chatul privat Telegram, trimite
I want a refund for last week. Can I speak to a person?. - În Inbox, găsește conversația, verifică atribuirea, selectează Assign to me și trimite
Hi, I’m Alex from the office. I’ll review your request.Verifică sosirea în Telegram. - Trimite alt mesaj de client cât timp conversația aparține omului. AI trebuie să tacă. Operatorul finalizează cazul și îl rezolvă în Inbox. Revenirea la AI este un test separat.
State este activ pentru regula personalizată. Declanșatoarele predefinite sunt oprite, rămânând o singură regulă de verificat.
Cererea reală din Telegram a declanșat Handoff. Atribuirea în Inbox și răspunsul trimis de operator au fost verificate separat.
În verificarea reală, conversația a trecut în Unassigned, gata să fie preluată de o persoană. Operatorul a selectat Assign to me, a trimis răspunsul biroului, iar Telegram l-a acceptat. Captura de mai sus arată răspunsul de transfer; nu arată mesajul ulterior al operatorului. Verifică atât atribuirea, cât și livrarea când repeți testul.
Lasă cazul la operator până când este rezolvat. În testul nostru local de rambursare, revenirea la AI Agent a permis un răspuns înainte ca Handoff să se declanșeze din nou. Revenirea la AI necesită propriul test ulterior reușit; nu face parte din criteriile de finalizare ale acestui flux. Ghidul de transfer către o persoană explică mai detaliat personalul și responsabilitatea.
Pasul 6: Cum testezi chatbotul Telegram complet?
Folosește Testing pentru verificări repetabile ale răspunsurilor, apoi verifică separat Telegram real și efectele externe. Modelul poate răspunde corect chiar dacă legătura grupului, scrierea în foaie sau livrarea transferului eșuează.
Verifică sistemul responsabil de rezultat: cunoștințele pentru fapte, jurnalele Action pentru cereri, Sheets pentru rânduri și Telegram pentru livrare.
Rulează un set repetabil de întrebări
- Deschide Testing, creează setul
Saltmarsh: knowledge checksși alege Paste messages. - Lipește
simulation-messages.txt. Păstrează separatoarele independente---între cazuri. - Deschide Evaluation criteria, lipește
evaluation-criteria.txtdin kit și salvează. - Selectează Run > Start Run, apoi citește răspunsurile individuale și scorurile.
Păstrează întrebările când schimbi o instrucțiune, pentru o comparație utilă.
Citește răspunsurile, nu doar scorul. Sunt teste locale de cunoștințe, nu de livrare Telegram.
Evaluatorul are nevoie de faptele școlii pentru a judeca exactitatea. Trebuie să știe și că transcrierea nu dovedește un rând în foaie, livrarea Telegram sau schimbarea atribuirii. Simulation text standard nu furnizează metadatele chatului Telegram; absența lor nu înseamnă că filtrul exclusiv privat este defect. Testele dependente de canal se fac în chatul privat real.
Ce au schimbat testele locale?
Designul inițial folosea un singur Agent pentru ambele intrări. Un test local a arătat că o cerere de rambursare în grup transfera conversația comună prin Human Handoff. Am separat Agenții și am dezactivat atât Handoff, cât și Actions pentru colectarea cererilor la Agentul de grup. Repetarea verificărilor de rambursare și lecție de probă în grup a produs apoi îndrumări către linkul privat fixat, păstrând conversația atribuită AI-ului. De aceea pasul 1 folosește atât configurația, cât și instrucțiunile pentru a separa cele două conversații.
Cele zece verificări locale finale de cunoștințe au primit fiecare 5/5, iar ambii Agenți găzduiți au trecut aceleași zece cazuri. Aceste rulări mici nu estimează acuratețea în producție. Grupul real a răspuns și la întrebările despre prețul cursului și echipament, apoi a refuzat să confirme închirierea costumelor de neopren. Păstrează cazurile cu informații lipsă când adaptezi kitul; răspunsurile corecte despre prețuri nu testează singure reținerea Agentului.
Lipsa informațiilor produce răspunsul „nu pot confirma”. Mesajul separat despre codul porții nu se adresează botului și nu are un răspuns vizibil în această captură.
Cererea privată reală de lecție de probă a produs un apel Sheets Action reușit cu Alex Morgan, Tuesday și beginner. Google a returnat HTTP 200 și un rând actualizat; rândul salvat conținea și linkul conversației și canalul telegram. Un test Action separat cu metadate de chat de grup nu a trimis nicio cerere HTTP. Când adaptezi condiția, verifică atât cererea privată acceptată, cât și contextul de grup refuzat.
Verifică canalul și efectele sale
Înregistrează propriile observații în fișierul gol test-matrix.csv din kit. Capturile de mai sus arată rezultatele demonstrate; tabelul include și verificări pentru propria configurație. Notează timpul scurs când testezi tăcerea și separă preluarea de către o persoană de orice revenire ulterioară la AI.
| Verificare | Mesaj sau acțiune | Rezultat așteptat |
|---|---|---|
| Mențiune în grup | @QuickchatAI_bot How much is Start Sailing? | Răspuns concis cu EUR 240; aceeași conversație în Inbox. |
| Răspuns către bot | What should I bring? | Lista echipamentului, fără altă mențiune. |
| Discuție obișnuită | Does anyone know the gate code? fără mențiune | Niciun răspuns de la botul comun. |
| Informație lipsă | Menționează botul și întreabă Do you rent wetsuits? | Nu poate confirma; nu inventează da sau nu. |
| Cerere personală în grup | Menționează botul și cere o rambursare | Direcționare în privat; grupul rămâne atribuit AI. |
| Răspuns privat | Deschide linkul complet și întreabă prețul | Agentul corect răspunde fără mențiune. |
| Cerere completă de lecție | Trimite mesajul Alex Morgan din pasul 4 | Parametrii Action corespund rândului real; nicio rezervare promisă. |
| Transfer privat | Cere rambursare, apoi răspunde după preluare | Atribuire umană, livrarea operatorului, fără răspuns AI suplimentar. |
| Politică meteo | What happens if the forecast says 30 knots? | Reprogramare gratuită și decizia instructorului; fără pretinsă prognoză în timp real. |
Dacă un test eșuează, modifică o singură setare relevantă și repetă mesajul. Corectează informația lipsă în Knowledge Base, apelul prematur în descrierea Action sau în câmpurile obligatorii, iar grupul tăcut prin confirmare și adresare. Păstrează rezultatul eșuat pentru a vedea îmbunătățirea.
Când ar trebui să creezi propriul bot cu BotFather?
Creează un bot propriu dacă ai nevoie de nume și imagine proprii, Actions Telegram Bot API sau primirea mesajelor obișnuite din grup. Botul comun este suficient pentru traseele de grup și privat descrise anterior.
Alege identitatea și comportamentul mesajelor înainte să adaugi un al doilea bot.
| Cerință | Bot comun Quickchat AI | Bot propriu |
|---|---|---|
| Token BotFather | Nu este necesar | Necesar |
| Nume și imagine proprii în Telegram | Identitate comună | Identitatea botului tău |
| Răspuns la mențiuni și replici în grup | Da | Da, când Telegram le livrează |
| Răspuns la mesaje obișnuite în grup | Botul comun tace | Configurează confidențialitatea sau rolul de administrator |
| Conversații private | Link start pentru Agent în botul comun | Firul privat al propriului bot |
| Google Sheets Action | Acceptată | Acceptată |
| Actions de moderare Telegram | Tokenul comun nu este expus | Token propriu disponibil ca System Token |
- În Telegram, deschide contul verificat BotFather și trimite
/newbot. - Alege un nume afișat, apoi un nume de utilizator disponibil terminat în
bot. BotFather returnează un token. Păstrează-l secret. - Selectează Saltmarsh Group dacă acest bot va fi adăugat într-un grup. Folosește Saltmarsh Sailing School doar pentru conversații private. În External Apps > Telegram, deschide Your own bot și selectează Connect to Telegram.
- Lipește tokenul în Bot Token și finalizează conectarea. Verifică Enable your own bot activat.
- Deschide linkul Telegram al botului, trimite
/start, apoi aceeași întrebare despre preț. - Pentru mesaje obișnuite în grup, folosește
/setprivacyîn BotFather, selectează botul și Disable, apoi elimină-l și adaugă-l din nou în grupul de test. Un bot administrator primește și el aceste mesaje. Documentația Telegram privind confidențialitatea explică livrarea.
Lipește tokenul numai în Bot Token. Câmpul este gol pentru a nu publica un secret.
Păstrează botul comun și botul propriu în grupuri separate. Folosite împreună, pot genera răspunsuri duplicate. Pentru anunțuri fixate sau moderare, urmează ghidul administrării grupurilor Telegram, inclusiv condițiile Actions limitate la administratori.
Pot ChatGPT sau Claude să configureze chatbotul Telegram?
O aplicație conectată pentru administrarea contului Quickchat AI poate crea Agenți, adăuga cunoștințe, modifica setări acceptate și rula teste. Dacă clientul permite configurarea Telegram, poate activa linkul de chat privat al botului comun. Alegerea grupului și confirmarea în panoul de control rămân responsabilitatea proprietarului. Unii clienți necesită panoul de control și pentru activarea linkului privat sau setările Human Handoff, așa că asistentul trebuie să verifice mai întâi instrumentele disponibile.
Conectează pluginul Quickchat AI pentru ChatGPT sau conectorul Claude, apoi oferă fișierele kitului cu acest prompt:
Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.
Instrumentele disponibile depind de client și de permisiunile contului. Urmează documentația configurării administrării contului pentru autentificare. Conectezi un asistent la Quickchat AI; conversația personală ChatGPT sau Claude nu devine backendul găzduit al botului Telegram.
De ce nu răspunde chatbotul Telegram?
Verifică legătura și traseul mesajului înainte să rescrii promptul. Simptomele de mai jos au cauze diferite.
| Simptom | Verificare |
|---|---|
| Grupul apare, dar tace | Confirmă grupul corect, activează-l în Connected chats și menționează numele real al botului sau răspunde mesajului lui. |
| Botul a ieșit înainte de primul răspuns | Generează un link nou Add to a Telegram group, adaugă-l din nou și selectează imediat Confirm pentru grupul în așteptare în Quickchat AI. |
| Linkul simplu deschide alt Agent | Folosește linkul privat complet, inclusiv start=. Verifică dacă linkul altui Agent a schimbat chatul comun. |
| AI s-a oprit după rambursare | Verifică atribuirea în Inbox. Conversația transferată rămâne oprită până la reatribuirea deliberată. |
| Lipsește rândul Sheets | Verifică Action activată, toate câmpurile, chatul privat și URL-ul către Leads. Inspectează apelul și conexiunea Google. |
| Botul propriu ratează mesaje obișnuite | Verifică confidențialitatea și permisiunile; elimină-l și adaugă-l din nou după schimbare. |
| Răspunsul inventează o dată sau un serviciu | Verifică informațiile salvate cu Ready și instrucțiunea pentru incertitudine. Repetă întrebarea exactă. |
| Testele nu mai răspund | Verifică creditele AI și cererea eșuată; epuizarea creditelor nu e un rezultat despre calitatea promptului. |
Înainte de a invita clienți, înlocuiește informațiile fictive, verifică separarea dintre grup și conversațiile private și asigură personal pentru coada de transferuri. Ca ultimă verificare înainte de lansare, roagă un coleg să testeze punctele publice de intrare din alt cont. Pentru un alt canal de comunitate, ghidul chatbotului Discord urmează un traseu comparabil de construire și testare. Pentru conversații cu personaje, folosește ghidul roleplay Telegram.
Verificări opționale: Compară metodele de implementare după cerințele declarate sau răspunsurile per buget de credite după bugetul furnizat. Calculatoarele nu inspectează contul, site-ul sau soldul.
Configurație Saltmarsh de copiat
Acestea sunt toate faptele și instrucțiunile folosite în ghid. Descărcarea include și rețeta Action, criteriile de evaluare și testele.
Agentul de grup: Main Prompt
Lipește în Identity > Main Prompt la Saltmarsh Group. Lasă Human Handoff și Actions personalizate dezactivate.
You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.
For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.
Agentul privat: Main Prompt
Lipește în Identity > Main Prompt la Saltmarsh Sailing School. Păstrează numele Action conform rețetei.
You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.
When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.
Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.
Cunoștințe: cursuri și cereri de lecții de probă
Lipește în câmpul Content al primului articol.
Saltmarsh Sailing School demonstration information
This fictional school is used only for a tutorial. It contains no real customer data.
Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.
Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.
Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.
A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.
Cunoștințe: politici și informații pentru membri
Lipește în câmpul Content al celui de-al doilea articol.
Saltmarsh Sailing School demonstration policies
If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.
Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.
Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.
The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.
Regula Human Handoff
Lipește în Human Handoff > Handoff Rules și configurează disponibilitatea reală.
Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.
Întrebări frecvente
Cum adaug un chatbot AI într-un grup Telegram?
În Quickchat AI, deschide External Apps, selectează Telegram și Add to a Telegram group. Alege grupul în Telegram, revino în Quickchat AI și apasă Confirm. Membrii pot pune întrebări menționând botul comun sau răspunzând la mesajele sale.
Răspunde un chatbot AI Telegram la fiecare mesaj?
Botul comun Quickchat AI răspunde în grup la mențiuni și replici la mesajele lui. Discuțiile obișnuite nu declanșează răspunsuri. Botul propriu poate primi mesaje obișnuite când modul de confidențialitate Telegram este dezactivat sau botul este administrator. Testează configurația într-un grup separat.
Am nevoie de BotFather sau de un token Telegram?
Pentru botul comun și linkul privat nu ai nevoie de BotFather sau token. Creează un bot propriu cu BotFather pentru nume și imagine personalizate sau Actions care apelează Telegram Bot API. Actions obișnuite Google Sheets funcționează cu botul comun.
Pot clienții să scrie chatbotului Telegram în privat?
Da. Activează Direct message link în Quickchat AI și distribuie linkul complet. Clientul îl deschide și apasă Start dacă i se cere. Linkul selectează Agentul în botul comun. Dezactivarea lui împiedică conexiunile noi; chaturile private existente au controale separate de activare și deconectare.
Este gratuit un chatbot AI pentru Telegram?
Crearea botului în BotFather nu adaugă un serviciu AI. Quickchat AI oferă Free pentru învățare personală, necomercială, cu credite AI limitate. Implementarea comercială necesită un plan plătit. Răspunsurile, Preview și Simulation consumă credite, iar serviciile externe pot avea costuri proprii.
Există chatboturi AI în Telegram?
Telegram acceptă boți AI și integrări terțe. Acest ghid conectează un Agent Quickchat AI care răspunde din informațiile firmei tale. BotFather creează identitatea botului; nu furnizează cunoștințe și nu configurează fluxul de asistență.
Înțelege chatbotul fotografii și fișiere?
Integrarea Telegram poate primi fotografii și analiza conținutul vizual. Alte fișiere pot ajunge ca atașamente, dar conținutul lor nu este citit automat. Testează tipurile reale folosite de clienți și inspectează Telegram și Inbox.
Pot crea un bot Telegram pentru roleplay sau un personaj?
Da. Aceeași conexiune Telegram poate deservi un Agent cu identitate de personaj și instrucțiuni potrivite. Exemplul folosește asistență comercială; un Agent roleplay are nevoie de prompt și teste proprii.