Bitrix24 плагини

v1.0.x · жаңыланды 2026-06-26

Bitrix24 плагини сиздин агентиңизди Bitrix24’ке ички кызматкерлердин заматта-билдирүү каналы катары туташтырат. Кызматкерлер агентке кесиптешине жазгандай эле жазышат, ал эми агент Bitrix24’тин чатынын ичинде жооп берет.

[!WARNING] Бул жердеги Bitrix24 — бул ички кызматкерлер IM каналы — кызматкерлер үчүн Telegram же Slack сыяктуу. Бул кардарлар үчүн омниканал ЭМЕС: бул жерде Open Lines жок, тикеттер кезеги жок жана операторго эскалация жок. Бул плагинди кардарларды колдоо линиясынын алдыңкы бети катары колдонбоңуз.

Плагин хост-нативдик иштейт жана gateway менен контракт аркылуу сүйлөшөт. Акыркы колдонуучу каналынын жүрүм-туруму канал бетинде Bitrix24 сүрөттөлгөн; бул бет плагиндин өзүн камтыйт.

Фактылар

Талаа	Маани
Версия	1.0.0
Порт	8810
Runtime	host-native

Бул эмне

Bitrix24 чаты менен AiHummer ортосундагы эки тараптуу көпүрө. Агент Bitrix24’те адамга окшош идентик катары көрүнөт — ар бир агент жалпы бот аккаунту менен эмес, өзүнүн OAuth идентиги менен аутентификацияланат — ошондуктан баарлашуулар кесиптеши менен сүйлөшүп жаткандай сезилет. Жетки уюмдун бөлүм-дарагы боюнча 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 бот мүмкүнчүлүктөрүн камтыбайт:

Интерактивдүү клавиатуралар / баскычтар жок жана тармактар (threads) жок.

Кируучу медиа жана үн жөнөтүлбөйт — кируучу текст гана. Кесиптеш стилиндеги идентик текстти кабыл алат жана ага жооп берет; агентке жиберилген тиркемелер жана үн жазуулары turn’га узатылбайт.

Орнотуу

Bitrix24’ти admin UI’дагы маркетплейстен бир чыкылдатуу менен орнотуңуз. Хост-нативдик деплойер плагинди жүктөп алат, анын орнотуу кадамын аткарат, sandbox’толгон systemd бирдигин рендерлейт жана даяр деп белгилөөдөн мурда ден соолугун күтөт — Орнотуу жана жаңылоолор бөлүмүн караңыз. Андан кийин ар бир агенттин OAuth идентигин туташтырып, бөлүм-дарагы боюнча ACL’ди дайындайсыз.

Коопсуздук жана чектөөлөр

Ички кызматкерлер IM гана — кардарлар үчүн омниканал эмес.
Ар бир агентке адамга окшош жеке OAuth идентиги — агенттер жалпы бот аккаунттары эмес.
Бөлүм-дарагы боюнча ACL — жетки сиздин уюм түзүмүңүздү урматтайт.
Идемпотенттик Deliver — Markdown BB-code’го рендерленет жана эч качан эки жолу жөнөтүлбөйт.
Текст гана кируучу; клавиатуралар/тармактар жок.
Хост-нативдик — контейнерде эмес, systemd астында иштейт.