Chatbot AI pentru Telegram: grupuri și mesaje private fără cod

Piotr Grudzień
Publicat Actualizat 18 min de lectură
Un grup și un chat privat Telegram conectate la informațiile școlii, cereri de lecții și un operator în Inbox

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ă.

Schema Agentului Saltmarsh care folosește cunoștințe și instrucțiuni pentru grupul Telegram, solicitările private și Inbox 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știPunct de verificare
1. Cunoștințe și instrucțiuniAgentul știe prețul cursului și nu inventează informații lipsă.
2. Conectarea grupuluiRăspunde la mențiuni și tace în conversațiile obișnuite.
3. Chat privatLinkul complet deschide conversația cu Agentul corect.
4. Cereri opționale pentru lecțiiDatele obligatorii devin un rând pe care personalul îl poate procesa.
5. Human HandoffUn om preia conversația, iar AI se oprește.
6. TestareVerifici 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Schema care separă informațiile școlii din Knowledge Base de instrucțiunile de răspuns și direcționare din Main Prompt Prețurile și politicile sunt fapte din surse. Concizia, incertitudinea și direcționarea sunt instrucțiuni.

Creează Agentul și adaugă informațiile

  1. Într-un cont nou, alege Set up manually. Într-un cont existent, selectează întâi Add new AI Agent, apoi configurarea manuală.
  2. În Identity, introdu Saltmarsh Group în Name your AI Agent. Lipește group-main-prompt.txt din kit în Describe what you want your agent to do.
  3. Continuă configurarea fără aplicații externe. Finalizează alegerea planului, folosind Skip for now dacă începi cu un cont pentru învățare.
  4. Deschide Knowledge Base > Add Article. Introdu Courses and trial enquiries în Create custom article, selectează Create article, lipește saltmarsh-courses.txt în Content, apoi Save.
  5. Repetă pentru Weather, parking and personal enquiries cu saltmarsh-policies.txt. Așteaptă ca ambele articole să afișeze Ready.
  6. Deschide Actions & MCPs la Saltmarsh Group. Lasă Human Handoff dezactivat și nu adăuga Action pentru cereri de lecții.
  7. Selectează Add new AI Agent și repetă configurarea pentru Saltmarsh Sailing School, cu main-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.

Knowledge Base în aplicația Quickchat locală, cu cele două articole Saltmarsh Două surse scurte arată clar ce știe Agentul. Verifică Ready înaintea testului de cunoștințe.

InformațiiFaptele exacte din exemplu
CursuriStart Sailing: două zile, EUR 240. Day Skipper theory: cinci seri, EUR 310. Lecție privată: 90 de minute, EUR 95.
DateSezon din aprilie până în octombrie; date publicate cu o lună înainte. Nu există disponibilitate în timp real sau următoarea dată.
EchipamentJachetă impermeabilă, încălțăminte care nu lasă urme și haine de schimb. Școala oferă veste de flotabilitate.
VremePeste 25 de noduri sau furtuni: reprogramare la prima dată disponibilă, fără cost suplimentar. Instructorul decide în dimineața respectivă.
ParcareGratuită 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

  1. 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.
  2. Deschide AI Preview și întreabă How much is Start Sailing?. Verifică două zile și EUR 240.
  3. Întreabă Do you rent wetsuits?. Verifică dacă răspunsul recunoaște lipsa informației.

Editorul Main Prompt din aplicația Quickchat locală cu instrucțiunile Saltmarsh Promptul Agentului privat definește colectarea și transferul. Agentul de grup are prompt separat și ambele Actions dezactivate.

Pagina Actions a Saltmarsh Group în aplicația locală, cu Human Handoff oprit și fără Actions personalizate 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.

Schema invitării botului, confirmării grupului corect și răspunsurilor la mențiuni sau replici Apartenența la Telegram și confirmarea în Quickchat AI sunt pași separați.

  1. Selectează Saltmarsh Group în selectorul de Agenți. Deschide External Apps, selectează Telegram și găsește Quickchat AI bot.
  2. Selectează Add to a Telegram group. În Telegram, alege Saltmarsh Members și aprobă adăugarea botului.
  3. Revino în Quickchat AI. În Waiting for your confirmation, verifică numele grupului și Added by.
  4. Selectează Confirm pentru grupul corect. Acesta ar trebui să apară în Connected chats, cu activarea pornită.
  5. Î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.
  6. 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.

Selectorul Add to Group din Telegram afișează Saltmarsh Members Alege Saltmarsh Members în Telegram, apoi revino în Quickchat AI pentru a confirma conexiunea.

Aplicația Quickchat locală cu Saltmarsh Members în așteptarea confirmării 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.

O mențiune în grupul Telegram întreabă prețul Start Sailing, iar botul răspunde cu două zile și EUR 240 Grupul confirmat a primit răspunsul așteptat despre curs. Menționează botul folosind numele său real de utilizator.

Un răspuns la mesajul botului în Telegram întreabă ce trebuie adus, urmat de lista de echipament a școlii 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.

Schema întrebărilor generale în grup și a cererilor personale de lecții sau rambursare în privat Grupul este o conversație comună. Mută datele personale și transferurile către personal în mesaje private.

  1. Selectează Agentul privat Saltmarsh Sailing School. În External Apps > Telegram, activează Direct message link. Lasă conexiunile la grupuri necompletate.
  2. Copiază linkul generat. Păstrează parametrul start=; un simplu link către botul comun nu identifică Agentul.
  3. Deschide-l în Telegram și apasă Start dacă este cerut.
  4. Întreabă How much is Start Sailing? fără menționarea botului. Verifică răspunsul școlii și găsește conversația în Inbox.
  5. Fixează linkul în mesajul de bun venit al grupului, înainte ca oamenii să publice date personale.

Controlul Direct message link în aplicația Quickchat locală Folosește linkul generat pentru propriul Agent. Configurația locală nu este dovadă de livrare într-un cont Telegram real.

Quickchat AI livrează mesajul de bun venit Saltmarsh Sailing School în Telegram 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ă detalii Telegram arată Saltmarsh Members cu un mesaj fixat și invitația la întrebări private 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.

Schema unei solicitări private care colectează trei câmpuri înainte de adăugarea rândului pentru birou 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

  1. 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.
  2. Deschide foaia creată Quickchat Leads. Păstrează fila Leads, deoarece URL-ul Action o vizează.
  3. Înlocuiește antetul în această ordine: Name, Preferred weekday, Sailing experience, Conversation link, Channel.
  4. Î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

FormatNameDescriptionRequired
TextnameNumele oferit de persoană pentru această cerere. Solicită-l dacă lipsește.Da
Textpreferred_weekdayZiua preferată din săptămână, de exemplu marți. Este o preferință, nu o dată confirmată.Da
Textsailing_experienceExperienț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.

AntetValoare
AuthorizationBearer {{google_sheets_access_token}}
Content-Typeapplication/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ă.

Condiție din Quickchat local care limitează Action la un chat privat Telegram Cheia simplă este telegram_chat_type. Condiția se verifică înaintea trimiterii cererii.

Editorul Action în Quickchat local cu câmpurile cererii de lecție 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.

Cererea privată de lecție de probă trimisă de Alex Morgan în Telegram și răspunsul care confirmă o solicitare, nu o rezervare 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ă secțiuni decupate din rândul Leads în Google Sheets arată Alex Morgan, Tuesday, beginner și telegram, cu linkul conversației ascuns 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.

Diagramă conceptuală cu răspunsuri AI obișnuite, un transfer care oprește AI și un angajat care închide cazul Verificarea este schimbarea atribuirii. Un om finalizează cazul; revenirea la AI se testează separat.

  1. Selectează Saltmarsh Sailing School, apoi Actions & MCPs > Human Handoff și activează-l. Lasă Action oprită pe Saltmarsh Group.
  2. În Handoff Rules, selectează +. Introdu Private enquiries în Rule Name, lipește handoff-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.
  3. 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.
  4. 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.
  5. Din chatul privat Telegram, trimite I want a refund for last week. Can I speak to a person?.
  6. Î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.
  7. 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.

Configurația Human Handoff pentru cererile private Saltmarsh în Quickchat local State este activ pentru regula personalizată. Declanșatoarele predefinite sunt oprite, rămânând o singură regulă de verificat.

O cerere privată de rambursare în Telegram și răspunsul botului că o persoană va prelua conversația 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ă.

Ciclul de test de la mesajul exact la evaluarea răspunsului și dovezile din Action și Inbox 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

  1. Deschide Testing, creează setul Saltmarsh: knowledge checks și alege Paste messages.
  2. Lipește simulation-messages.txt. Păstrează separatoarele independente --- între cazuri.
  3. Deschide Evaluation criteria, lipește evaluation-criteria.txt din kit și salvează.
  4. Selectează Run > Start Run, apoi citește răspunsurile individuale și scorurile.

Setul de mesaje Saltmarsh în Testing din Quickchat local Păstrează întrebările când schimbi o instrucțiune, pentru o comparație utilă.

Teste locale Saltmarsh finalizate, cu scoruri individuale 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.

Răspuns Telegram care refuză să confirme închirierea costumelor de neopren, urmat de un mesaj despre codul porții fără mențiune și fără răspuns vizibil al botului 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.

VerificareMesaj sau acțiuneRezultat 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 botWhat should I bring?Lista echipamentului, fără altă mențiune.
Discuție obișnuităDoes anyone know the gate code? fără mențiuneNiciun 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 grupMenționează botul și cere o rambursareDirecționare în privat; grupul rămâne atribuit AI.
Răspuns privatDeschide linkul complet și întreabă prețulAgentul corect răspunde fără mențiune.
Cerere completă de lecțieTrimite mesajul Alex Morgan din pasul 4Parametrii Action corespund rândului real; nicio rezervare promisă.
Transfer privatCere rambursare, apoi răspunde după preluareAtribuire umană, livrarea operatorului, fără răspuns AI suplimentar.
Politică meteoWhat 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.

Comparație între botul comun și botul propriu creat cu BotFather Alege identitatea și comportamentul mesajelor înainte să adaugi un al doilea bot.

CerințăBot comun Quickchat AIBot propriu
Token BotFatherNu este necesarNecesar
Nume și imagine proprii în TelegramIdentitate comunăIdentitatea botului tău
Răspuns la mențiuni și replici în grupDaDa, când Telegram le livrează
Răspuns la mesaje obișnuite în grupBotul comun taceConfigurează confidențialitatea sau rolul de administrator
Conversații privateLink start pentru Agent în botul comunFirul privat al propriului bot
Google Sheets ActionAcceptatăAcceptată
Actions de moderare TelegramTokenul comun nu este expusToken propriu disponibil ca System Token
  1. În Telegram, deschide contul verificat BotFather și trimite /newbot.
  2. Alege un nume afișat, apoi un nume de utilizator disponibil terminat în bot. BotFather returnează un token. Păstrează-l secret.
  3. 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.
  4. Lipește tokenul în Bot Token și finalizează conectarea. Verifică Enable your own bot activat.
  5. Deschide linkul Telegram al botului, trimite /start, apoi aceeași întrebare despre preț.
  6. 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.

Formularul botului propriu în Quickchat local, cu Bot Token gol 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.

SimptomVerificare
Grupul apare, dar taceConfirmă 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ăspunsGenerează 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 AgentFolosește linkul privat complet, inclusiv start=. Verifică dacă linkul altui Agent a schimbat chatul comun.
AI s-a oprit după rambursareVerifică atribuirea în Inbox. Conversația transferată rămâne oprită până la reatribuirea deliberată.
Lipsește rândul SheetsVerifică Action activată, toate câmpurile, chatul privat și URL-ul către Leads. Inspectează apelul și conexiunea Google.
Botul propriu ratează mesaje obișnuiteVerifică confidențialitatea și permisiunile; elimină-l și adaugă-l din nou după schimbare.
Răspunsul inventează o dată sau un serviciuVerifică informațiile salvate cu Ready și instrucțiunea pentru incertitudine. Repetă întrebarea exactă.
Testele nu mai răspundVerifică 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.

Quickchat AI Quickchat AI Ask Quickchat AI a question