Telegram — AiHummer Documentație

Telegram este canalul recomandat de producție de primă clasă al AiHummer. Este cea mai rapidă metodă de a pune un agent funcțional în fața oamenilor reali: creează un bot cu @BotFather, oferă conectorului token-ul, și mesajele primite încep să curgă către gateway.

Conectorul Telegram este instalat din produsul propriu-zis Piață și configurat în interfața de administrare. Rulează nativ pe gazdă și comunică cu gateway-ul prin API-ul de intrare, astfel încât se poate scala și reporni independent de motorul de întoarcere.

Conectează Telegram în 6 pași

Iată traseul complet de la zero până la un bot care îți răspunde în Telegram. Tot ce ai nevoie este un cont Telegram și acces la interfața ta web de administrare AiHummer.

Creează un bot cu BotFather. Deschide în Telegram @BotFather, trimite /newbot, și setează numele botului și nume de utilizator. Ceea ce vei vedea: BotFather returnează un jeton ca 123456789:AA… — aceasta este cheia de acces a botului, copiaz-o.
Instalează conectorul Telegram. În interfața de administrare deschide Module/Marketplace, găsește conectorul Telegram în catalogul și faceți clic pe „Instalare”. Așteptați ca cardul să devină „online” (o instalare) bara de progres este afișată).
Lipiți tokenul. Du-te la Canale ecran → Configurează canalele instalate blocați, deschideți cardul Telegram și lipiți token de bot în câmp de la formularul conectorului. Salvează.
Creează un agent (dacă nu ai unul încă) — vezi Agenți: un nume și un prompt de sistem sunt suficiente.
Leagă agentul de canal. Pe Canale ecran, în Legături bloc, alege un agent implicit pentru Telegram — regulă „noile conversații de Telegram sunt gestionate de agentul Y”. Alegerea se salvează instantaneu.
Trimite un mesaj botului. Deschide-ți botul în Telegram și trimite-i un mesaj. Ce vei vedea: agentul răspunde în chat, iar conversația corespunzătoare apare pe ecranul „Sesiuni” din interfața de administrare.

[!NOTE] Implicit, agentul răspunde doar utilizatori cunoscuți (persoane înregistrate în AiHummer). Dacă botul rămâne tăcut la mesajul tău — fie adaugă-te pe tine însuți ca un utilizatorul instanței, sau dezactivați „Răspunde doar utilizatorilor cunoscuți” pe Canale ecran.

De ce să începi cu Telegram

Telegram are cea mai mică dificultate dintre orice canal AiHummer: fără operator, fără ecran de consimțământ OAuth, fără revizuire a aplicației. Un token de bot este suficient pentru a trimite și primi mesaje, iar același conector acoperă atât chat-urile interne ale personalului, cât și boții orientați către clienți. Deoarece este de calitate de producție și complet testat, acesta este canalul pe care vă recomandăm să îl conectați primul atunci când evaluați AiHummer.

Interogare sau webhook

Conectorul acceptă ambele moduri de ingerare, așa că funcționează indiferent dacă gateway-ul tău este accesibil de pe internetul public sau nu.

Încercare lungă — conectorul preia actualizări de la Telegram. Fără port de intrare sau TLS este necesar, ceea ce îl face ideal pentru dezvoltarea locală și privată rețele.
Webhook — Telegram trimite actualizări către un URL public HTTPS. Latență mai redusă și mai bine potrivit pentru producție în spatele unui proxy invers care încheie TLS-ul.

Conectorul ascultă pe port 8800 într-o implementare normală, sau 8091 pentru o rulare locală. Fiecare mesaj primit este trimis către URL-ul gateway-ului configurat în AIHUMMER_INBOUND_URL, autentificat cu secretul comun de intrare.

Mesaje bogate, reacții la mesaje și sondaje

Dincolo de textul simplu, canalul Telegram redă Mesaje bogate — răspunsuri formatate care mapează ieșirea structurată a unui agent pe funcțiile native de mesaje ale Telegram. De asemenea, suportă reacții la mesaje și sondaje, astfel încât un agent să poată reacționa la mesajul unui utilizator sau să introducă un sondaj rapid într-un chat ca parte a unui schimb de replici.

[!TIP] Telegram este canalul identificat pentru AiHummer ca telegram. Folosește acel canal id atunci când atașați un agent sau filtrați conversațiile după sursă.

Bot-la-bot cu un dispozitiv de protecție împotriva buclelor

Agenții pot vorbi cu alți roboți. Pentru a face acest lucru sigur, conectorul include un gard de buclă: detectează și oprește schimburile scăpate de sub control între boți înainte să se transforme într-un ping-pong infinit. Acest lucru îți permite să creezi fluxuri de lucru cu mai mulți boți fără modul clasic de eșec cauzat de bucla de feedback.

Intermediere secretă peste OIDC

Tokenul botului și alte secrete ale conectorului nu sunt niciodată codate direct în serviciu. În schimb, conectorul le obține la rulare dintr-un Serviciu de Secrete peste OIDC — se autentifică, apoi preia acreditările de care are nevoie. Secretul rămâne în seiful criptat și în afara fișierelor de configurare și a argumentelor procesului.

[!NOTE] Mesajele primite sunt postate la AIHUMMER_INBOUND_URL și asigurat de secret HMAC inbound partajat (AIHUMMER_INBOUND_SECRET). Poarta trebuie să aibă o spațiul de lucru implicit configurat să le distribuie.

Dacă nu a funcționat

Conectorul Telegram nu se află pe ecranul „Canale” — instalează-l mai întâi pe Module/Marketplace ecran; până este instalat canalul nu este afișat. Pe planul Community este disponibil doar Telegram; restul au nevoie de un upgrade (HTTP 402).
Botul nu răspunde — verifică: (1) dacă tokenul este lipit corect și Cardul Telegram este „online”; (2) canalul este legat de un agent în „Legături”; (3) expeditorul este înregistrat în sistem (implicit agentul răspunde doar utilizatori cunoscuți).
Răspunsurile par șablonate — modelul simulat este probabil încă activ; conectează un furnizor pe Modele pagină.
“Neautorizat” / token respins — tokenul este greșit sau revocat; generează un nou cu @BotFather (/token) și lipește-l din nou.
Webhook-ul nu sosește — în modul webhook, gateway-ul trebuie să fie accesibil la un URL HTTPS public; într-o rețea privată folosiți long polling, care nu necesită trafic de intrare port sau TLS.

Unde următor?

Compară canalele în MAX, Bitrix24 și Telefonie SIP ghiduri.
Legături și configurarea accesului — Canale.
Pentru surse non-chat, vezi Intrare generică.
Construind împotriva API-ului? Vezi chat/completări.