Թելեգրամ

**Telegram-ը արտադրողական, առաջարկվող առաջին ալիքն է AiHummer-ի համար:** Սա ամենաարագ միջոցն է իրական մարդկանց ցույց տալ աշխատող գործակալի աշխատանքը՝ ստեղծելով մի բոտ [@BotFather](https://t.me/BotFather), փոխանցեք կոնեկտորին տոկենը, և մուտքագրած հաղորդագրությունները կսկսեն հասնել անցակետին. Telegram կոնեկտորը տեղադրվում է արտադրանքից [Շուկա](/hy/v1.0/marketplace/overview-tiers) և կազմաձևված է վարչական ինտերֆեյսում։ Այն աշխատում է հոստում բնօրինակ կերպով և կապվում է դարպասի հետ մուտքային API-ի միջոցով, դրա համար այն մասշտաբավորվում և վերակենդանանում է պտույտի շարժիչից անկախ։ ## Միացրեք Telegram-ը 6 քայլով Այստեղ ամբողջ ճանապարհը զրոյից մինչև բոտ, որը ձեզ պատասխանում է Telegram-ում: Ամեն ինչ, ինչ անհրաժեշտ է ձեզ, դա Telegram-հաշիվն է և մուտքը ձեր AiHummer ադմինիստրատորի վեբ-պանելին: 1. **Ստեղծեք բոտը BotFather-ի միջոցով։** Բացեք Telegram-ում [@BotFather](https://t.me/BotFather), ուղարկել `/newbot`, և սահմանել բոտի անունը և Օգտագործողի անունը. *Ի՞նչ կտեսնեք:* BotFather-ը վերադարձնում է **տոկեն** հաճել `123456789:AA…` — այս բոտի մուտքի բանալին է, պատճենիր այն։ 2. **Անվանեք Telegram կոնեկտորը։** Բացեք ադմինիստրատորի ինտերֆեյսում [Պլագիններ/Մարկետպլեյս](/hy/v1.0/webui/marketplace), գտեք Telegram-ի միացումը կատալոգ և սեղմեք «Տեղադրել»: Սպասեք մինչև քարտը դառնա «ցանցում» (տեղադրում ցուցադրվում է առաջընթացի ցուցանիշը)։ 3. **Տեղադրեք նշանը։** Բացեք [Ալիքներ](/hy/v1.0/webui/channels) էկրանը → **Կարգավորել տեղադրված ալիքները** արգելափակել, բացեք Telegram քարտը և տեղադրեք **բոտի տոկեն** մաղամասի դաշտում ձևանմուշից: Պահպանել. 4. **Ստեղծել գործակալ** (եթե այն դեռ չունեք) — նայեք [Գործակալներ](/hy/v1.0/webui/agents): բավական է անունը և համակարգային հարցումը: 5. **Կապեք գործակալիին ալիքին։** Համար [ԱԿՆԱՆՆԵՐ](/hy/v1.0/webui/channels) էկրան, մեջ **«Միակցումներ»** բլոկ, ընտրել **դեպի լռության գործակալ** տելեգրամի համար — կարգավորումը «նոր հաղորդագրությունները Telegram-ում վարում է գործակալ Y»: Ընտրությունը պահվում է անմիջապես: 6. **Ուղարկեք հաղորդագրություն բոտին։** Բացեք ձեր բոտին Telegram-ում և ուղարկեք նրան հաղորդագրություն։ *Ինչ հանդիպելու եք՝ * գործակալն արձագանքում է զրույցում, և հայտնվում է համապատասխան զրույցը կառավարման ինտերֆեյսում «Սեսիաներ» էկրանին։ > [!NOTE] > Նպատակային առումով գործակալը պատասխանում է **Միայն հայտնի օգտատերերը** (գրանցված մարդիկ՝ > AiHummer). Եթե բոտը լռում է ձեր հաղորդագրության վրա — ավելացրեք ինքներդ ձեզ որպես > Օգտատեր օրինակ, կամ անջատեք «Պատասխանել միայն հայտնի օգտատերերին» > [ԱԿՆԱՆՆԵՐ](/hy/v1.0/webui/channels) էկրան։ ## Ինչու սկսել Telegram-ով Telegram-ում ամենացածր դիմադրությունն է բոլոր AiHummer ալիքների մեջ. չկա կապի օպերատոր, չկա OAuth համաձայնության էկրան, չկա հավելվածի ստուգում. բավական է միայն բոտի նշանը՝ հաղորդագրություններ ուղարկելու և ստանալու համար, և նույն կոննեկտորը ընդգրկում է ինչպես աշխատակիցների ներքին չատերը, այնպես էլ բոտեր հաճախորդների հետ փոխկապակցվելու համար։ Մեջբերումով սա արդյունաբերական լուծում է և ամբողջությամբ փորձարկված է, սա այն ալիքն է, որը մենք խորհուրդ ենք տալիս միացնել առաջինը AiHummer-ի գնահատման ժամանակ։ ## Հարցում կամ վեբհուք Կոննեկտորը աջակցում է երկու նորմերով բեռնմանը, այնպես որ այն գործում է անկախ նրանից, արդյոք ձեր անցակետը հասանելի է հանրային ինտերնետից, թե ոչ։ - **Երկար հարցումով** —կոննեկտորը ստանում է թարմացումներ Telegram-ից։ Մուտքային պորտ չկա կամ անհրաժեշտ է TLS, ինչը այն դարձնում է իդեալական տեղական զարգացման և անձնական օգտագործման համար ցանցեր։ - **Վեբհուք** — Տելեգրամը ուղարկում է թարմացումներ հանրային HTTPS URL հասցեով: Ավելի ցածր ուշացում և կիլը առավել հարմար է աշխատանքի համար հետնային պրոքսի հետ, որը ավարտում է TLS գործընթացը։ Կոնեկտորը լսում է **պորտ 8800** սովորական տեղաբաշխման դեպքում, կամ **8091** տեղական գործարկման համար: Յուրաքանչյուր մուտքային հաղորդագրություն ուղարկվում է կացարանի URL հասցեին, որը կարգավորված է `AIHUMMER_INBOUND_URL`, վավերացված է օգտագործելով ընդհանուր մուտքի գաղտնաբառը: ## Հարուստ հաղորդագրություններ, հաղորդագրությունների արձագանքներ և հարցումներ Բացի սովորական տեքստից, Telegram ալիքը ցուցադրում է **Հարստացված հաղորդագրություններ** — ֆորմատավորված պատասխաններ, որոնք համեմատում են գործակալի կառուցվածքային ելքը Telegram-ի բնիկ հաղորդագրությունների ֆունկցիաների հետ։ Այն նաև աջակցում է **արձագանքներ հաղորդագրություններին** և **հարցումներ**, որպեսզի գործակալը կարողանա արձագանքել օգտվողի հաղորդագրությանը կամ արագ հարցում տեղադրել զրույցում մեկ քայլի ընթացքում. > [!TIP] > Telegram — դա ալիք է, որը AiHummer-ը նույնականացրել է որպես `telegram`. Օգտագործեք այս ալիքը > համարող, երբ դուք կապում եք գործակալին կամ զրուցակցությունները ֆիլտրում ըստ աղբյուրի: ## Ռոբոտը ռոբոտի հետ՝ ցիկլավորումից պաշտպանությամբ Աջակցողները կարող են շփվել այլ բոտերի հետ։ Սա անվտանգ դարձնելու համար, կոնեկտորը համարվում է ապահովիչով **շրջանառության պաշտպան**: նա հայտնաբերում և ընդհատում է մարտավարական բոտերի միջև արտահոսքերը, նախքան դրանք վերածվեն անվերջ պինգ-պոնգի: Սա թույլ է տալիս ստեղծել բազմաբոտ վարպետական աշխատանքային հոսքեր՝ առանց դասական ձախողման ռեժիմի, որը առաջանում է փակ արձագանքման ցիկլի պատճառով: ## Գաղտնի միջնորդություն OIDC-ի միջոցով Բոտի տոկենը և կոնեկտորի այլ գաղտնիքը երբեք չեն գրանցվում սերվիսի կոդում։ Դրա փոխարեն կոնեկտորը դրանք ստանում է կատարման ընթացքում **Գաղտնիքների ծառայություն OIDC-ի միջոցով** — նա ինքնությունն է հաստատում, ապա ստանում անհրաժեշտ օգտատիրոջ տվյալները: Գաղտնիքները մնում են կոդավորված պահեստում և չեն հայտնվում կազմաձևման ֆայլերում և գործընթացների արգումենտներում: > [!NOTE] > Մուտքային հաղորդագրությունները հրապարակվում են `AIHUMMER_INBOUND_URL` և ամրագրված > համատեղ ներթափանցող գաղտնի HMAC (`AIHUMMER_INBOUND_SECRET`). Գեյթվեյը պետք է ունենա > Սովորական աշխատանքային տարածքը կազմավորված է նրանց ուղարկելու համար։ ## Եթե սա չի աշխատել - **Telegram կցորդիչը բացակայում է «Անվանումներ» էկրանին** — սկզբում տեղադրեք սա Հը [Պլագիններ/Մարկետպլեյս](/hy/v1.0/webui/marketplace) էկրան; մինչ տեղադրում ալիքը չի ցուցադրվում: Community պլանում հասանելի է միայն Telegram-ը; մնացածները պահանջում են թարմացում (HTTP 402)։ - **Բոտը չի արձագանքում** — ստուգում՝ (1) տոքենը ճիշտ է տեղադրված և Telegram քարտը գտնվում է «առցանց» կարգավիճակում; (2) ալիքը կապավորված է գործակալի հետ «Կապերում»; (3) ուղարկողը գրանցված է համակարգում (վերջնականում գործակալը պատասխանում է միայն հայտնի օգտվողներ). - **պատասխանները նայում են ձևական** — հավանաբար, փորձարկման մոդելը դեռ ակտիվ է; միացրեք մատակարարի վրա [Մոդելներ](/hy/v1.0/webui/models) էջ. - **"Չհավաստագրված" / զանգվածը մերժվել է** — տոկենը սխալ է կամ հետ է վերցրած; ստեղծեք նոր հետ [@BotFather](https://t.me/BotFather) (`/token`) և նորից տեղադրեք դա։ - **Վեբհուկը չի գալիս** — վեբհուք ռեժիմում դարպասը պետք է հասանելի լինի հանրային HTTPS URL; մասնավոր ցանցում օգտագործեք երկար հարցում, որը չի պահանջում ներթուրված կապեր պորտ կամ TLS. ## Որտեղից հետո - Համեմատեք ալիքները մեջ [ՄԱՔՍ](/hy/v1.0/channels/max), [Բիտրիքս24](/hy/v1.0/channels/bitrix24) և [SIP-հեռախոսակապ](/hy/v1.0/channels/sip) ղեկավարություններ - Կցումներ և մուտքի կարգավորումներ — [ԱԿՆԱՆՆԵՐ](/hy/v1.0/webui/channels). - Չաթի հետ կապված չլինող աղբյուրների համար տես՝ [Ընդհանուր մուտք](/hy/v1.0/channels/generic-inbound). - Աշխատում եք API-ի դեմ՞ Դիտեք [չաթ/ավարտում](/hy/v1.0/api/chat-completions).