Bitrix24 plagin

v1.1.x · yangilandi 2026-07-05

Bitrix24 plagin sizning agentingizni ichki xodimning tezkor xabar almashish kanali sifatida Bitrix24 ga ulaydi. Xodimlar agentga xuddi hamkasbiga habar yuborgandek habar yuborishadi, va agent Bitrix24 ichidagi chatda javob beradi.

[!WARNING] Bitrix24 bu yerda bir ichki xodim IM kanali — Telegram yoki Slack kabi xodimlar uchun. Bu emas mijoz omnichannel: ochiq liniyalar yo‘q, yo‘q chipta navbati va operatorning eskalatsiyasi yo‘q. Bu plagin orqali oldinga chiqmaslik kerak mijozlarni qo‘llab-quvvatlash liniyasi.

Plagin host-native rejimida ishlaydi va gateway bilan bog’lanadi aihummer.connector.v1 shartnoma. Foydalanuvchi kanalining xulq-atvori kanal sahifasida Bitrix24; bu sahifa plaginning o‘zini qamrab oladi.

Faktlar

Maydon	Qiymat
Versiya	1.0.0
Port	8810
Ishlash vaqti	xost-milliy

Bu nima

Bitrix24 chat va AiHummer o’rtasida ikki tomonlama ko’prik. Agent sifatida ko’rinadi insonga o‘xshash shaxsiyat Bitrix24 da — har bir agent umumiy bot hisobidan emas, balki o’z OAuth identifikatori bilan autentifikatsiyalanadi — shuning uchun suhbatlar hamkasb bilan gaplashgandek tuyuladi. Kirish tashkilotning qoidalariga muvofiq bo’ladi bo‘lim-daraxti ACL, shuning uchun agentning imkoniyati sizning Bitrix24 tuzilishingizni hurmat qiladi.

OAuth identifikatsiyalardan tashqari, boshqa ta’minlash yo‘llari ham qo‘llab-quvvatlanadi: portal administrator kirishi orqali agent hisoblarini avtomatik yaratish (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) va oldindan yaratilgan Bitrix24 foydalanuvchilariga belgilangan identifikatorlar orqali bog‘lash (BITRIX24_AGENT_USER_IDS).

Qanday ishlatiladi

Kiritish: pull poller yangi xabarlarni oladi va ularni ga yuboradi eshikning umumiy kirish nuqtasi, u yerda marşrutizator maqsad agentni aniqlaydi.
Chiqish: javoblar konnektorning idempotent orqali yuboriladi Yetkazib ber qadam, bu agentning Markdown-ni Bitrix24 ga aylantiradi BB-kod va xabar ikki marta yuborilmaganligini kafolatlaydi.

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

Qo‘llab-quvvatlangan funktsiyalar

Plagin boy, insonga o‘xshash chat xatti-harakatlarini qo‘llab-quvvatlaydi:

reaktsiyalar
xabarni tahrirlash va o’chirish
yozish indikatorlari
@-tilishlar
omma vositasi

Chegaralar

[!WARNING] Insonga o‘xshash model qasddan shunday qiladi emas ba’zi Bitrix24 botlarini qo’shish xususiyatlar:

Interaktiv klaviaturalar / tugmalar yo‘q va ip yo‘q.

Kelib tushayotgan media va ovoz yo’naltirilmaydi — kiruvchi faqat matn. A hamkasb-uslubidagi shaxsiyat matnlarni qabul qiladi va ularga javob beradi; ilovalar va ovoz agentga jo‘natilgan eslatmalar aylanma ichiga uzatilmaydi.

O’rnatish

Admin UI orqali marketplace-dan Bitrix24 ni bir marta bosish bilan o’rnating. Hostga xos deployer plaginni yuklab oladi, uning o’rnatish qadamini bajaradi, sandboxlangan systemd birlikni yaratadi va tayyor deb belgilashdan oldin sog’liqni tekshiradi — qarang O’rnatish va yangilanishlar. Siz keyin har bir agentning OAuth shaxsiyatini ulaysiz va bo‘lim-daraxti ACL’sini xaritalaysiz.

Xavfsizlik va chegaralar

Faqat ichki xodimlarning tezkor xabarlari — mijoz omnichannel emas.
Har bir agent uchun insonga o‘xshash OAuth identifikatori — agentlar umumiy bot hisoblari emas.
Bo‘lim-daraxt ACL — hurmat sizning tashkilot tuzilishingizni hisobga oladi.
Idempotent Yetkazish — Markdown BB-kodga aylantiriladi va hech qachon ikki marta yuborilmaydi.
Faqat matnli kirish; klaviaturalar/iplar yo‘q.
Mezbon-irqiy — tizimdasturi ostida ishlaydi, konteynerda emas.