Иловаи Bitrix24

Плагини Bitrix24 агенти шуморо ба Bitrix24 ҳамчун канали паёмнависии фаврии корманди дохилӣ мепайвандад. Ходимон ба агент ҳамон тавре паёми худ ба ҳамкорон мерасонданд, паём мефиристанд ва агент дар чати Bitrix24 ҷавоб медиҳад.

[!WARNING] Bitrix24 ин аст канали дохилии кормандон — монанди Telegram ё Slack барои кормандон. Ин аст не мусоҳибаи бисёрканалӣ бо мизоҷ: хатҳои кушод вуҷуд надорад, нест навбатбандии чипта ва баландсозии оператор вуҷуд надорад. Барои пешбурди он плагинро истифода набаред хатти дастгирии муштариён

Плагин ба таври маҳаллии мизбонӣ кор мекунад ва тавассути гузаргоҳ бо он муошират мекунад aihummer.connector.v1 шартнома. Равияи канали истеъмолкунандаи ниҳоӣ дар саҳифаи канал аст Битрикс24Ин саҳифа худи плагинро фаро мегирад.

Медиа ва 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-и маълумоти ҳисобро дар пайванди абзорҳо интихоб кунед. Соҳиби воқеӣ пайвасткунандаи коркунандаро дар фазои кории он тавассути /v1/admin/connections/channel бо калиди ҷудогонаи connection-token сабт мекунад. endpoint ва apiKey-ро аз рӯйи ID-и корбари агент дар танзими махфии BITRIX24_VAULT_CONNECTIONS гузоред; онҳоро дар профил ё дархостҳои агент нагузоред. Токенҳоро танҳо махзан нав мекунад; абзорҳо санҷиши ташаббускор ва дастрасии муштаракро нигоҳ медоранд. Нигаред: OAuth2.

Чӣ тавр истифода мешавад

Воридот: пурсиш паёмҳоро мехонад. Медиа ҳамчун байтҳо боргирӣ ва тавассути /v1/inbound/media сабт мешавад; агент media_id мегирад, на танҳо URL ё маълумоти файл.
Содирот: 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-и дарахти шӯъбаро нақш мегиред.

Амният ва маҳдудиятҳо

Фариқати дохилии кормандон танҳо — на муштарии омниканалӣ.
Шахсияти OAuth монанди инсон барои ҳар як агенти — агентҳо ҳисобҳои умумии бот нестанд.
Рӯйхати иҷозатҳои шохаи шуъба — reach ба сохтори ташкилоти шумо эҳтиром мегузорад.
Мизбон-миқдор — дар зерсистемаи systemd кор мекунад, на дар контейнер.