AiHummer
Հայերեն
Մուտք
v1.0.x
{ }Swagger

Bitrix24 փլագին

v1.0.x · թարմացվել է 2026-06-26

Bitrix24 փլագինը միացնում է ձեր ագենտը Bitrix24-ին որպես ներքին աշխատակիցների ակնթարթային հաղորդագրությունների ալիք։ Անձնակազմը հաղորդագրություն է ուղարկում ագենտին այնպես, ինչպես կուղարկեր գործընկերոջը, և ագենտը պատասխանում է Bitrix24-ի չաթի ներսում։

[!WARNING] Bitrix24-ն այստեղ ներքին աշխատակիցների IM ալիք է — ինչպես Telegram-ը կամ Slack-ը անձնակազմի համար։ Դա չէ հաճախորդների բազմաալիք համակարգ. չկան Open Lines, չկա տոմսերի հերթ և չկա օպերատորի էսկալացիա։ Մի՛ օգտագործեք այս փլագինը հաճախորդների աջակցության գիծ վարելու համար։

Փլագինն աշխատում է host-native ռեժիմով և շփվում է gateway-ի հետ կոնտրակտի միջոցով։ Վերջնական օգտատիրոջ ալիքի վարքագիծը նկարագրված է ալիքի էջում՝ Bitrix24; այս էջն ընդգրկում է հենց փլագինը։

Փաստեր

Դաշտ Արժեք
Տարբերակ 1.0.0
Պորտ 8810
Runtime host-native

Ինչ է դա

Երկկողմանի կամուրջ Bitrix24 չաթի և AiHummer-ի միջև։ Ագենտը հայտնվում է որպես մարդանման ինքնություն Bitrix24-ում — յուրաքանչյուր ագենտ նույնականանում է իր սեփական OAuth ինքնությամբ, այլ ոչ թե ընդհանուր bot-հաշվով — այնպես, որ զրույցները նման են գործընկերոջ հետ խոսելուն։ Մուտքը հետևում է կազմակերպության բաժինների ծառի ACL-ին, ուստի ագենտի հասանելիությունը հարգում է ձեր Bitrix24 կառուցվածքը։

Ինչպես է այն օգտագործվում

  • Մուտքային: pull-հարցումիչը վերցնում է նոր հաղորդագրությունները և փոխանցում դրանք gateway-ի ընդհանուր մուտքային վերջնակետին, որտեղ ռոութերը որոշում է թիրախային ագենտը։
  • Ելքային: պատասխանները ուղարկվում են կոնեկտորի իդեմպոտենտ Deliver քայլի միջոցով, որը փոխակերպում է ագենտի Markdown-ը Bitrix24 BB-code-ի և երաշխավորում, որ հաղորդագրությունը երկու անգամ չի ուղարկվում։
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Աջակցվող հնարավորություններ

Փլագինն աջակցում է հարուստ, մարդանման չաթի վարքագիծ.

  • ռեակցիաներ
  • հաղորդագրության խմբագրում և ջնջում
  • տպելու ինդիկատորներ
  • @-հիշատակումներ
  • մեդիա

Սահմանափակումներ

[!WARNING] Մարդանման մոդելը միտումնավոր չի ներառում Bitrix24 bot-ի որոշ հնարավորություններ.

  • Չկան ինտերակտիվ ստեղնաշարեր / կոճակներ և չկան թելեր (threads):
  • Մուտքային մեդիան և ձայնը չեն փոխանցվում — մուտքայինը միայն տեքստ է: Գործընկերոջ ոճի ինքնությունը ստանում և պատասխանում է տեքստին; ագենտին ուղարկված հավելվածներն ու ձայնային գրառումները չեն փոխանցվում turn-ի մեջ։

Տեղադրում

Տեղադրեք Bitrix24-ն մեկ սեղմումով admin UI-ի marketplace-ից։ host-native deployer-ը ներբեռնում է փլագինը, գործարկում է իր տեղադրման քայլը, ստեղծում sandbox-ված systemd unit և սպասում առողջության ստուգմանը՝ նախքան այն պատրաստ նշելը — տես Տեղադրում և թարմացումներ։ Այնուհետև դուք միացնում եք յուրաքանչյուր ագենտի OAuth ինքնությունը և քարտեզագրում բաժինների ծառի ACL-ը։

Անվտանգություն և սահմանափակումներ

  • Միայն ներքին աշխատակիցների IM — ոչ հաճախորդների բազմաալիք համակարգ։
  • Ագենտ-ըստ-ագենտի մարդանման OAuth ինքնություն — ագենտները ընդհանուր bot-հաշիվներ չեն։
  • Բաժինների ծառի ACL — հասանելիությունը հարգում է ձեր կազմակերպության կառուցվածքը։
  • Իդեմպոտենտ Deliver — Markdown-ը փոխակերպվում է BB-code-ի և երբեք երկու անգամ չի ուղարկվում։
  • Միայն տեքստային մուտքային; չկան ստեղնաշարեր/թելեր։
  • Host-native — աշխատում է systemd-ի ներքո, ոչ կոնտեյներում։

Ուր հաջորդը