Bitrix24 аплагин

Bitrix24 аплагин

v1.0.x · ирҿыцуп 2026-06-26

Bitrix24 аплагин шәагент Bitrix24 ахь иадикылоит аусзуҩцәа рыҩныҵҟатәи ишәышәҭратә цхыраагӡахалатә канал ҳасабла. Аусзуҩцәа агент изыҩуеит дара рколлега ишахьырыҩуа ала, агентгьы аҭакс ҟанаҵоит Bitrix24 ачаҭ аҩныҵҟа.

[!WARNING] Bitrix24 абраҟа — иара аусзуҩцәа рыҩныҵҟатәи IM-канал — Telegram ма Slack реиԥш аусзуҩцәа рзы. Уи акәым аклиентцәа рзы аомниканал: маҷ-маҷ Open Lines ыҟаӡам, тикеҭтә шҭаԥхьа ыҟаӡам, аоператор ахь аэскалациагьы ыҟаӡам. Ари аплагин аклиент рцхыраара амҩаԥгаратә хаҭыԥ аҟны мшәымхын.

Аплагин ауеит host-native ҳасабла, насгьы агейтуан иацәажәоит акантракт ала. Ахархәаҩ иканал аҟазшьа аарԥшуп аканал адаҟьаҟны Bitrix24; ари адаҟьа иаԥсоуп аплагин хаҭала.

Афактқәа

Аҵакыра	Аҵакы
Аверсиа	1.0.0
Апорт	8810
Аруантайм	host-native

Иарбану иара

Bitrix24 ачаҭ ма AiHummer рыбжьара аҩ-маҩатә ахьаԥс. Агент Bitrix24 аҟны ааԥшуеит ауаҩы иеиԥшу идентичность ҳасабла — агент зегьы иеихаҵарагоит ихатәы OAuth-идентичность, акоопча еилаҳәоу бот-аҳасабшәҟәы аҟны акәымкәа — убри аҟнытә аиҿцәажәарақәа уколлега иацәажәара еиԥшуп. Адашьара иашьҭоуп аиҿкаара адепартаментқәа рыцәаԥшә ACL, убри азы агент иҟазшьара иазԥхьагәанаҭоит шәара ишәтәоу Bitrix24 аструктура.

Ишахархәоу

Иаҩнагалоу: apull-поллер иаазкуеит аиԥшьрақәа ҿыцқәа, насгьы иддыргалоит агейтуан иаҩнагалоу адагьылагентә эндпоинт ахь, ахьыҟоу аrouter иарбоит агент.
Иаҩнацлоу: аҭакс ддыргалоит аконнектор идемпотентту Deliver ашьаҿала, уи агент имарквдаун Bitrix24 BB-code ахь иеиҭанагӡоит, насгьы аиԥшьра ҩынтә ишахаҭынхаҵамыршьоу анарра ҟанаҵоит.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Иадгылоу аҟазшьақәа

Аплагин иадгылоит абеиара змоу, ауаҩы иеиԥшу ачаҭ аҟазшьара:

ареакциақәа
аиԥшьра арҿыцра ма аныхра
адыррарбагақәа адырра (typing)
@-ахьӡырҳәара
амедиа

Аҳәаақәа

[!WARNING] Ауаҩы иеиԥшу амодель мап ацәнакуеит Bitrix24 бот ахкы аҟазшьарақәа руак-ҩба:

Иҟаӡам аинтерактивтә клавиатурақәа / апытҟәырқәа насгьы иҟаӡам атемақәа (threads).

Иаҩнагалоу амедиа ма абжьы иддырмыргалоит — иаҩнагалоу — аиҿбатәы заҵәык. Аколлега иеиԥшу идентичность иоуит, насгьы аҭакс ҟанаҵоит атекст; агент ахь иддыргало аиацҵарақәеи абжьытә цәаҳәақәеи аусура ахь иддырмыргалоит.

Адҵара

Bitrix24 ишәдыргалар ҟалоит ныҟәакрак ала амаркетплейс аҟнытә админ-UI аҟны. Host-native адеплоер аплагин ддаунлоуд ҟанаҵоит, иinstall-ашьаҿа ауеит, иеиҿкааны аизолировоу systemd-аакьа аартуеит, насгьы агәабзиара иазыԥшуеит уи иманшәалоуп ҳәа аҵаҩраанӡа — шәахәаԥш Адҵара & арҿыцрақәа. Анаҩс шәара иеидышәҵоит агент зегьы иOAuth-идентичность, насгьы иеилышәҟәоит адепартаментқәа рыцәаԥшә ACL.

Ашәарҭадареи аҳәаақәеи

Аусзуҩцәа рыҩныҵҟатәи IM заҵәык — аклиент рзы аомниканал акәым.
Агент зегьы иауаҩы иеиԥшу OAuth-идентичность — агентцәа акоопча еилаҳәоу бот-аҳасабшәҟәқәа ракәым.
Адепартаментқәа рыцәаԥшә ACL — иҟазшьара иазԥхьагәанаҭоит шәара иаԥхьаҩра аструктура.
Идемпотентту Deliver — амарквдаун BB-code ахь иеиҭагоуп, насгьы ҩынтә иршьымтәуп.
Аиҿбатәы заҵәык иаҩнагалоу; иҟам аклавиатурақәа/атемақәа.
Host-native — ауеит systemd аҵаҟа, аконтеинер аҩныҵҟа акәымкәа.