Telegram

**Telegram este primul canal recomandat, de calitate de producție, al AiHummer.** Este cea mai rapidă modalitate de a pune un agent funcțional în fața oamenilor reali: creați un bot cu [@BotFather](https://t.me/BotFather), dați conectorului token-ul, iar mesajele de intrare încep să curgă către gateway. Conectorul Telegram este instalat din [Marketplace](/ro/v1.0/marketplace/overview-tiers)-ul integrat în produs și configurat în interfața de administrare. Rulează nativ pe gazdă și comunică cu gateway-ul prin API-ul de intrare, deci se scalează și repornește independent de motorul de tururi. ## De ce să începeți cu Telegram Telegram are cea mai mică fricțiune dintre toate canalele AiHummer: fără operator, fără ecran de consimțământ OAuth, fără revizuire de aplicație. 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 exersat, este canalul pe care vă recomandăm să-l cablați primul când evaluați AiHummer. ## Polling sau webhook Conectorul acceptă ambele moduri de ingestie, deci funcționează indiferent dacă gateway-ul dumneavoastră este accesibil din internetul public sau nu. - **Long polling** — conectorul trage actualizările de la Telegram. Nu este necesar niciun port de intrare sau TLS, ceea ce îl face ideal pentru dezvoltarea locală și rețelele private. - **Webhook** — Telegram împinge actualizările către un URL HTTPS public. Latență mai mică și mai potrivit pentru producție în spatele unui reverse proxy care termină TLS. Conectorul ascultă pe **portul 8800** într-o implementare normală sau pe **8091** pentru o rulare locală. Fiecare mesaj de intrare este postat către URL-ul de gateway configurat în `AIHUMMER_INBOUND_URL`, autentificat cu secretul de intrare partajat. ## Mesaje bogate, reacții și sondaje Dincolo de text simplu, canalul Telegram redă **Rich Messages** — răspunsuri formatate care mapează rezultatul structurat al unui agent pe funcționalitățile native de mesaj ale Telegram. Acceptă, de asemenea, **reacții** ș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 tur. > [!TIP] > Telegram este canalul identificat în AiHummer ca `telegram`. Folosiți acel id > de canal când legați un agent sau filtrați conversațiile după sursă. ## Bot-la-bot cu o protecție anti-buclă Agenții pot vorbi cu alți boți. Pentru a face acest lucru sigur, conectorul livrează o **protecție anti-buclă**: detectează și întrerupe schimburile bot-la-bot scăpate de sub control înainte ca acestea să se transforme într-un ping-pong infinit. Acest lucru vă permite să compuneți fluxuri de lucru multi-bot fără clasicul mod de eșec al buclei de feedback. ## Brokerarea secretelor prin OIDC Token-ul botului și alte secrete ale conectorului nu sunt niciodată codificate direct în serviciu. În schimb, conectorul le preia la runtime de la un **Secrets Service prin OIDC** — se autentifică, apoi recuperează credențialele de care are nevoie. Secretele rămân în seiful criptat și în afara fișierelor de configurare și a argumentelor de proces. > [!NOTE] > Mesajele de intrare sunt postate către `AIHUMMER_INBOUND_URL` și securizate de > secretul de intrare HMAC partajat (`AIHUMMER_INBOUND_SECRET`). Gateway-ul > trebuie să aibă un spațiu de lucru implicit configurat pentru a le expedia. ## Unde mergem mai departe - Comparați canalele în ghidurile [MAX](/ro/v1.0/channels/max), [Bitrix24](/ro/v1.0/channels/bitrix24) și [Telefonie SIP](/ro/v1.0/channels/sip). - Pentru surse non-chat, vedeți [Intrare generică](/ro/v1.0/channels/generic-inbound). - Construiți pe baza API-ului? Vedeți [chat/completions](/ro/v1.0/api/chat-completions).