Bitrix24 плагини

v1.2.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] Интерактивдүү баскычтоптор, баскычтар жана талкуу бутактары колдоого алынбайт.

Түзүлгөн же даярдалган файл ырасталган жеткирүү эмес. Жарым-жартылай, ийгиликсиз жана белгисиз жыйынтыктар көрүнүп турушу керек.

Орнотуу

Админдик UI аркылуу маркетплейстен Bitrix24тү бир чыкылдатуу менен орнотуңуз. Хосттун жергиликтүү орнотуучусу плагинди жүктөйт, анын орнотуу кадамын иштетет, sandbox менен корголгон systemd бөлүмүн көрсөтүп, ден-соолукту текшерип, андан соң аны даяр деп белгилейт — караңыз Орнотуу жана жаңыртуулар. Андан кийин ар бир агенттин OAuth атың байланыштырып, бөлүм дарагынын ACLин карталаштырасыз.

Коопсуздук жана чектөөлөр

Ички кызматкерлерге гана IM — кардарга арналган омниканал эмес.
Ар бир агентке ылайык адамга окшош OAuth идентификациясы — агенттер жалпы бот аккаунттары эмес.
Бөлүм дарагынын ACL — reach сиздин уюм структураңызды урматтайт.
Ийгиликтүү төрөлгөн — системддин астында иштейт, контейнерде эмес.