Bitrix24 plagini

v1.0.x · yangilandi 2026-06-26

Bitrix24 plagini agentingizni Bitrix24’ga ichki xodimlar tezkor xabar almashish kanali sifatida ulaydi. Xodimlar agentga xuddi hamkasbiga yozgandek xabar yozadilar va agent Bitrix24 chatining ichida javob beradi.

[!WARNING] Bu yerda Bitrix24 — bu ichki xodimlar IM kanali — xuddi xodimlar uchun Telegram yoki Slack kabi. Bu mijozlar omnikanali emas: bu yerda Open Lines, tiket navbati yoki operatorga eskalatsiya yoʻq. Ushbu plagindan mijozlarni qoʻllab-quvvatlash liniyasini boshqarish uchun foydalanmang.

Plagin host-native rejimida ishlaydi va gateway bilan kontrakti orqali muloqot qiladi. Oxirgi foydalanuvchi kanali xatti-harakati Bitrix24 kanali sahifasida tasvirlangan; bu sahifa plaginning oʻzini qamrab oladi.

Faktlar

Maydon	Qiymat
Versiya	1.0.0
Port	8810
Runtime	host-native

Bu nima

Bitrix24 chati va AiHummer oʻrtasidagi ikki tomonlama koʻprik. Agent Bitrix24’da odamga oʻxshash identifikator sifatida koʻrinadi — har bir agent umumiy bot hisobi oʻrniga oʻzining OAuth identifikatori bilan autentifikatsiyadan oʻtadi — shu sababli suhbatlar hamkasb bilan gaplashayotgandek his qilinadi. Kirish tashkilotning boʻlim daraxti boʻyicha ACL’iga amal qiladi, shu bois agentning qamrovi sizning Bitrix24 tuzilmangizni hisobga oladi.

U qanday ishlatiladi

Kiruvchi: pull-poller yangi xabarlarni oladi va ularni gateway’ning umumiy kiruvchi endpoint’iga uzatadi, u yerda router maqsadli agentni aniqlaydi.
Chiquvchi: javoblar konnektorning idempotent Deliver bosqichi orqali yuboriladi, u agentning Markdown’ini Bitrix24 BB-kod’iga aylantiradi va xabar ikki marta yuborilmasligini kafolatlaydi.

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

Qoʻllab-quvvatlanadigan imkoniyatlar

Plagin boy, odamga oʻxshash chat xatti-harakatini qoʻllab-quvvatlaydi:

reaksiyalar
xabarni tahrirlash va oʻchirish
yozish indikatorlari
@-eslatmalar
media

Cheklovlar

[!WARNING] Odamga oʻxshash model ataylab Bitrix24’ning ayrim bot imkoniyatlarini oʻz ichiga olmaydi:

Interaktiv klaviaturalar / tugmalar yoʻq va threadlar yoʻq.

Kiruvchi media va ovoz uzatilmaydi — kiruvchi xabarlar faqat matn. Hamkasb uslubidagi identifikator matnni qabul qiladi va unga javob beradi; agentga yuborilgan biriktirmalar va ovozli xabarlar turn ichiga uzatilmaydi.

Oʻrnatish

Bitrix24’ni admin UI’dagi marketpleysdan bir bosishda oʻrnating. Host-native deployer plaginni yuklab oladi, uning oʻrnatish bosqichini bajaradi, qum qutisidagi (sandboxed) systemd birligini render qiladi va tayyor deb belgilashdan oldin uning sogʻligʻini kutadi — qarang Oʻrnatish va yangilanishlar. Soʻngra siz har bir agentning OAuth identifikatorini ulaysiz va boʻlim daraxti boʻyicha ACL’ni moslashtirasiz.

Xavfsizlik va cheklovlar

Faqat ichki xodimlar IM — mijozlar omnikanali emas.
Har bir agent uchun odamga oʻxshash OAuth identifikatori — agentlar umumiy bot hisoblari emas.
Boʻlim daraxti boʻyicha ACL — qamrov tashkilot tuzilmangizni hisobga oladi.
Idempotent Deliver — Markdown BB-kodga render qilinadi va hech qachon ikki marta yuborilmaydi.
Faqat matnli kiruvchi xabarlar; klaviaturalar/threadlar yoʻq.
Host-native — konteynerda emas, systemd ostida ishlaydi.