Bitrix24 плагині

v1.1.x · жаңартылды 2026-10-14

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

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

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

Төмендегі медиа және ортақ OAuth әрекеті қол қойылған Core 1.4.15 пен каталогта бөлек жарияланып жаңартылған, қол қойылған 1.1.1 коннекторын талап етеді. Орнатылған 1.1.0 бұл мүмкіндіктердің қолжетімділігін растамайды.

Дәлілдер

Дала	Мән
Нұсқа	1.1.1
Порт	8810
Жүру уақыты	қожайындық-туған

Бұл дегеніміз не

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

Арнайы портал пайдаланушыларын BITRIX24_AGENT_USER_IDS, порталды BITRIX24_PORTAL арқылы көрсетіңіз. Бөлім бойынша бағыттау қызметкерлердің рұқсатын шектейді; агент аккаунты тапсырманы бастаған адамды алмастырмайды. Қолданыстағы қосымша автоматты баптау BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD қолданады.

Аталған нұсқаларда BITRIX24_VAULT_CONNECTIONS иесіне тиесілі қолданыстағы, жарамды, автономды OAuth қосылымын таңдайды. Қолдау көрсетілетін нативті қойма/қосылым басқаруын пайдаланыңыз; сол тіркелгі дерегінің ID-ін құрал байланыстарында таңдаңыз. Нақты иесі жұмыс істеп тұрған коннекторды оның жұмыс кеңістігінде бөлек connection-token кілтімен /v1/admin/connections/channel арқылы тіркейді. Агент пайдаланушысының ID-і бойынша endpoint пен apiKey мәндерін құпия BITRIX24_VAULT_CONNECTIONS параметріне енгізіңіз; агент профиліне не сұрауына қоймаңыз. Токендерді тек қойма жаңартады; құралдар бастамашы мен ортақ пайдалану тексерулерін сақтайды. OAuth2 қараңыз.

Оны қалай қолдануға болады

Кіріс: сұраушы хабарларды оқиды. Медиа байттармен жүктеліп, /v1/inbound/media арқылы тіркеледі; агент тек URL не файл сипаттамасын емес, media_id алады.
Шығыс: Deliver Markdown-ды BB-code-қа түрлендіріп, нақты байттарды im.v2.File.upload арқылы жүктейді. Медиа растауы нақты FILE_ID және хабар ID-лерін талап етеді; мәтін не сілтеме файл түбіртегі емес.

Жаңарту кезінде тұрақты жеткізу журналын сақтаңыз. Расталған әрекеттің қайталануы бұрынғы түбіртекті қайтарады. Ішінара не белгісіз әсер автоматты түрде қайта жіберілмейді; қайталау алдында тексеріңіз.

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

Қолданылатын мүмкіндіктер

Реакциялар және @-атап өтулер.
Аккаунт пен платформа im.dialog.writing және REPLY_ID қолдаса, теру көрсеткіші мен жауаптар.
Жоғарыдағы нұсқа талаптарымен кіріс суреттер, аудио, дауыс және файлдар.
Хабарды өңдеу/жою тек бөлек бот тұлғасы бар ескі интеграцияларда; кәдімгі OAuth пайдаланушылары үшін жарияланбайды.

Шектеулер

[!WARNING] Интерактивті пернетақталар, түймелер мен тармақтар қолдау таппайды.

Жасалған не дайындалған файл расталған жеткізу емес. Ішінара, сәтсіз және белгісіз нәтижелер көрініп тұруы керек.

Орнату

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

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

Ішкі қызметкерге арналған IM ғана — тұтынушының көпарналы емес.
Әр агентке арналған адамға ұқсас OAuth сәйкестігі — агенттер жалпы бот есептік жазбалары емес.
Бөлім-ағаш ACL — сіздің ұйым құрылымыңызды құрметтейді.
Қонақ-жергілікті — контейнерде емес, systemd астында жұмыс істейді.