Bitrix24 plagin

v1.1.x · yangilandi 2026-10-14

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.

Quyidagi media va umumiy OAuth ishlashi imzolangan Core 1.4.15 va katalogda alohida e’lon qilinib yangilangan, imzolangan 1.1.1 konnektorini talab qiladi. O‘rnatilgan 1.1.0 bu imkoniyatlar mavjudligini tasdiqlamaydi.

Faktlar

Maydon	Qiymat
Versiya	1.1.1
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.

Alohida portal foydalanuvchilarini BITRIX24_AGENT_USER_IDS, portalni BITRIX24_PORTAL orqali belgilang. Bo‘lim bo‘yicha yo‘naltirish xodimlar kirishini cheklaydi; agent hisobi vazifani boshlagan odam o‘rnini bosmaydi. Mavjud ixtiyoriy avtomatik tayyorlash BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD ishlatadi.

Ko‘rsatilgan versiyalarda BITRIX24_VAULT_CONNECTIONS egasiga tegishli mavjud, amaldagi, avtonom OAuth ulanishini tanlaydi. Qo‘llanadigan nativ saqlagich/ulanish boshqaruvidan foydalaning; shu hisob ma’lumoti ID-sini vosita bog‘lashlarida tanlang. Haqiqiy egasi ishlayotgan konnektorni uning ish maydonida alohida connection-token kaliti bilan /v1/admin/connections/channel orqali ro‘yxatdan o‘tkazadi. Agent foydalanuvchi ID-si bo‘yicha endpoint va apiKey qiymatlarini maxfiy BITRIX24_VAULT_CONNECTIONS sozlamasiga kiriting; agent profili yoki so‘rovlariga qo‘ymang. Tokenlarni faqat saqlagich yangilaydi; vositalar tashabbuskor va ulashishni tekshiradi. Qarang: OAuth2.

Qanday ishlatiladi

Kiruvchi: so‘rovchi xabarlarni o‘qiydi. Media baytlar sifatida yuklanib, /v1/inbound/media orqali ro‘yxatga olinadi; agent faqat URL yoki fayl ma’lumoti emas, media_id oladi.
Chiquvchi: Deliver Markdown-ni BB-code-ga aylantirib, haqiqiy baytlarni im.v2.File.upload orqali yuklaydi. Media tasdig‘i haqiqiy FILE_ID va xabar ID-larini talab qiladi; matn yoki havola fayl kvitansiyasi emas.

Yangilashda doimiy yetkazish jurnalini saqlang. Tasdiqlangan amalning takrori oldingi kvitansiyani qaytaradi. Qisman yoki noma’lum ta’sir avtomatik qayta yuborilmaydi; qayta urinishdan oldin tekshiring.

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

Qo‘llab-quvvatlangan funktsiyalar

Reaksiyalar va @-eslatmalar.
Hisob va platforma im.dialog.writing hamda REPLY_ID qo‘llasa, yozish ko‘rsatkichi va javoblar.
Yuqoridagi versiya talablari bilan kiruvchi rasmlar, audio, ovoz va fayllar.
Xabarni tahrirlash/o‘chirish faqat alohida bot shaxsiyatli eski integratsiyalarda; oddiy OAuth foydalanuvchilari uchun e’lon qilinmaydi.

Chegaralar

[!WARNING] Interaktiv klaviaturalar, tugmalar va mavzu tarmoqlari qo‘llanmaydi.

Yaratilgan yoki tayyorlangan fayl tasdiqlangan yetkazish emas. Qisman, muvaffaqiyatsiz va noma’lum natijalar ko‘rinib turishi kerak.

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.
Mezbon-irqiy — tizimdasturi ostida ishlaydi, konteynerda emas.