Bitrix24 плагині

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

Bitrix24 плагині агентіңізді Bitrix24-ке ішкі қызметкерлік лезде хабарласу (IM) арнасы ретінде қосады. Қызметкерлер агентке әріптесіне жазғандай жазады, ал агент Bitrix24 чаты ішінде жауап береді.

[!WARNING] Bitrix24 мұнда — ішкі қызметкерлік IM арнасы — қызметкерлерге арналған Telegram немесе Slack секілді. Бұл тұтынушылық омниарна емес: Open Lines жоқ, тикет кезегі жоқ және операторға эскалация жоқ. Бұл плагинді тұтынушыларды қолдау желісінің алдында қолданбаңыз.

Плагин хост-нативті жұмыс істейді және шлюзбен келісімі бойынша сөйлеседі. Соңғы пайдаланушы арнасының тәртібі Bitrix24 арна бетінде; бұл бетте плагиннің өзі қарастырылады.

Фактілер

Өріс	Мән
Нұсқа	1.0.0
Порт	8810
Орындалу ортасы	хост-нативті

Бұл не

Bitrix24 чаты мен AiHummer арасындағы екіжақты көпір. Агент Bitrix24-те адамтектес сәйкестік ретінде көрінеді — әрбір агент жалпы бот тіркелгісінің орнына өзінің OAuth сәйкестігімен аутентификацияланады — сондықтан әңгімелер әріптеспен сөйлескендей сезіледі. Қол жеткізу ұйымның бөлімдер ағашы ACL-ін ұстанады, сондықтан агенттің таралымы сіздің Bitrix24 құрылымыңызды құрметтейді.

Қалай қолданылады

Кіріс: pull-поллер жаңа хабарламаларды алып, оларды шлюздің жалпы кіріс соңғы нүктесіне жібереді, онда роутер мақсатты агентті анықтайды.
Шығыс: жауаптар коннектордың идемпотентті Deliver қадамы арқылы жіберіледі, ол агенттің Markdown-ын Bitrix24 BB-code-қа түрлендіреді және хабарламаның екі рет жіберілмеуіне кепілдік береді.

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

Қолдау көрсетілетін мүмкіндіктер

Плагин бай, адамтектес чат тәртібін қолдайды:

реакциялар
хабарламаны өңдеу және жою
теру индикаторлары
@-аталымдар
медиа

Шектеулер

[!WARNING] Адамтектес модель кейбір Bitrix24 бот мүмкіндіктерін әдейі қамтымайды:

Интерактивті пернетақталар / түймелер жоқ және тармақтар (threads) жоқ.

Кіріс медиа мен дауыс жіберілмейді — кіріс тек мәтіндік. Әріптес стиліндегі сәйкестік мәтінді қабылдап, жауап береді; агентке жіберілген тіркемелер мен дауыстық жазбалар хабарласуға (turn) берілмейді.

Орнату

Bitrix24-ті әкімшілік UI-дегі marketplace-тен бір рет басумен орнатыңыз. Хост-нативті деплойер плагинді жүктеп алады, оның орнату қадамын орындайды, оқшауланған systemd бірлігін рендерлейді және оны дайын деп белгілемес бұрын денсаулықты күтеді — қараңыз Орнату және жаңартулар. Содан кейін әрбір агенттің OAuth сәйкестігін қосып, бөлімдер ағашы ACL-ін салыстырасыз.

Қауіпсіздік және шектеулер

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