Telegram
Telegram-ը AiHummer-ի արտադրական մակարդակի, առաջարկվող առաջին ալիքն է։ Դա ամենաարագ ճանապարհն է աշխատող գործակալին իրական մարդկանց առջև բերելու համար. ստեղծեք բոտ @BotFather-ով, տվեք կոնեկտորին token-ը, և մուտքային հաղորդագրությունները սկսում են հոսել gateway-ին։
Telegram կոնեկտորը տեղադրվում է ապրանքի ներսում գործող Marketplace-ից և կարգավորվում Admin UI-ում։ Այն աշխատում է host-native և խոսում gateway-ի հետ inbound API-ով, այնպես որ այն մասշտաբավորվում և վերագործարկվում է turn engine-ից անկախ։
Ինչու սկսել Telegram-ով
Telegram-ն ունի ամենաքիչ դիմադրությունը AiHummer-ի ցանկացած ալիքից. ոչ օպերատոր, ոչ OAuth համաձայնության էկրան, ոչ հավելվածի վերանայում։ Բոտի token-ը բավարար է հաղորդագրություններ ուղարկելու և ստանալու համար, և նույն կոնեկտորը ընդգրկում է ինչպես ներքին անձնակազմի զրույցները, այնպես էլ հաճախորդներին ուղղված բոտերը։ Քանի որ այն արտադրական մակարդակի է և լիովին փորձարկված, դա ալիքն է, որ մենք առաջարկում ենք առաջինը միացնել AiHummer-ը գնահատելիս։
Polling կամ webhook
Կոնեկտորն աջակցում է ընդունման երկու ռեժիմները, այնպես որ այն աշխատում է անկախ նրանից՝ ձեր gateway-ը հասանելի է հանրային ինտերնետից, թե ոչ։
- Long polling — կոնեկտորը քաշում է թարմացումները Telegram-ից։ Մուտքային պորտ կամ TLS չի պահանջվում, ինչը այն դարձնում է իդեալական լոկալ մշակման և մասնավոր ցանցերի համար։
- Webhook — Telegram-ը մղում է թարմացումները հանրային HTTPS URL-ին։ Ավելի ցածր ուշացում և ավելի հարմար արտադրության համար reverse proxy-ի հետևում, որը դադարեցնում է TLS-ը։
Կոնեկտորը լսում է 8800 պորտում նորմալ տեղակայման ժամանակ, կամ 8091-ում
լոկալ գործարկման համար։ Յուրաքանչյուր մուտքային հաղորդագրություն տեղադրվում է gateway-ի URL-ում, որը կարգավորված է
AIHUMMER_INBOUND_URL-ում՝ նույնականացված ընդհանուր inbound secret-ով։
Հարուստ հաղորդագրություններ, ռեակցիաներ և հարցումներ
Բացի պարզ տեքստից, Telegram ալիքը ցուցադրում է Rich Messages — ձևաչափված պատասխաններ, որոնք գործակալի կառուցվածքային ելքը արտապատկերում են Telegram-ի native հաղորդագրության ֆունկցիաների վրա։ Այն նաև աջակցում է ռեակցիաներ և հարցումներ, այնպես որ գործակալը կարող է ռեակցիա անել օգտատիրոջ հաղորդագրությանը կամ արագ հարցում տեղադրել զրույցում որպես turn-ի մաս։
[!TIP] Telegram-ը AiHummer-ին նույնականացված ալիքն է որպես
telegram։ Օգտագործեք այդ ալիքի id-ն, երբ կապում եք գործակալ կամ զտում զրույցները ըստ աղբյուրի։
Բոտ-բոտ loop guard-ով
Գործակալները կարող են խոսել այլ բոտերի հետ։ Դա անվտանգ դարձնելու համար կոնեկտորը մատակարարում է loop guard. այն հայտնաբերում և ընդհատում է անկառավարելի բոտ-բոտ փոխանակումները, նախքան դրանք կվերածվեն անվերջ ping-pong-ի։ Սա թույլ է տալիս ձեզ կազմել բազմաբոտ workflow-ներ առանց դասական feedback-loop-ի ձախողման ռեժիմի։
Secret-ների միջնորդություն OIDC-ով
Բոտի token-ը և կոնեկտորի այլ secret-ները երբեք կոշտ կոդավորված չեն ծառայության մեջ։ Փոխարենը կոնեկտորը դրանք ստանում է runtime-ում Secrets Service-ից OIDC-ով — այն նույնականացվում է, ապա ստանում անհրաժեշտ հավատարմագրերը։ Secret-ները մնում են գաղտնագրված vault-ում և config ֆայլերից ու process արգումենտներից դուրս։
[!NOTE] Մուտքային հաղորդագրությունները տեղադրվում են
AIHUMMER_INBOUND_URL-ում և պաշտպանված են ընդհանուր HMAC inbound secret-ով (AIHUMMER_INBOUND_SECRET)։ Gateway-ը պետք է ունենա կարգավորված լռելյայն workspace՝ դրանք ուղարկելու համար։
Ուր հաջորդիվ
- Համեմատեք ալիքները MAX, Bitrix24 և SIP հեռախոսակապ ուղեցույցներում։
- Ոչ զրույցային աղբյուրների համար տեսեք Generic inbound։
- Կառուցո՞ւմ եք API-ի դեմ։ Տեսեք chat/completions։