AiHummer
Тоҷикӣ
Даромадан
v1.0.x
{ }Swagger

Плагини Bitrix24

v1.0.x · навсозӣ шуд 2026-06-26

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

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

Плагин ба таври миёнаи мизбон (host-native) кор мекунад ва бо gateway тавассути қарордод гуфтугӯ мекунад. Рафтори канал барои корбари ниҳоӣ дар саҳифаи канали Bitrix24 аст; ин саҳифа худи плагинро фаро мегирад.

Далелҳо

Майдон Қимат
Версия 1.0.0
Порт 8810
Runtime host-native

Он чист

Пули дутарафа байни чати Bitrix24 ва AiHummer. Агент дар Bitrix24 ҳамчун ҳувияти ба монанди инсон зоҳир мешавад — ҳар агент бо ҳувияти OAuth-и худаш аутентификатсия мешавад, на бо ҳисоби умумии бот — то гуфтугӯ ба сӯҳбат бо ҳамкор монанд бошад. Дастрасӣ аз ACL-и дарахти шуъбаҳои ташкилот пайравӣ мекунад, бинобар ин доираи дастрасии агент ба сохтори Bitrix24-и шумо эҳтиром мегузорад.

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

  • Воридшаванда: як pull poller паёмҳои навро мегирад ва онҳоро ба нуқтаи ниҳоии умумии воридшавандаи gateway мефиристад, ки дар он router агенти ҳадафро ҳал мекунад.
  • Содиршаванда: ҷавобҳо тавассути қадами идемпотентии Deliver-и коннектор фиристода мешаванд, ки Markdown-и агентро ба BB-code-и Bitrix24 табдил медиҳад ва кафолат медиҳад, ки паём ду маротиба фиристода намешавад.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Хусусиятҳои дастгиришаванда

Плагин рафтори бой ва ба монанди инсони чатро дастгирӣ мекунад:

  • реаксияҳо
  • таҳрир ва ҳазфи паём
  • нишондиҳандаҳои чопкунӣ
  • @-зикрҳо
  • медиа

Маҳдудиятҳо

[!WARNING] Модели ба монанди инсон қасдан баъзе хусусиятҳои боти Bitrix24-ро дар бар намегирад:

  • Клавиатураҳо / тугмаҳои интерактивӣ нестанд ва сатрҳо (threads) нестанд.
  • Медиа ва овози воридшаванда фиристода намешаванд — воридшаванда танҳо матн аст. Ҳувияти ба монанди ҳамкор матнро қабул ва ба он ҷавоб медиҳад; замимаҳо ва ёддоштҳои овозӣ, ки ба агент фиристода мешаванд, ба turn интиқол дода намешаванд.

Насб

Bitrix24-ро бо як клик аз бозор дар админ UI насб кунед. Деплойери host-native плагинро зеркашӣ мекунад, қадами насби онро иҷро мекунад, як воҳиди systemd-и изолятсияшударо ренд мекунад ва пеш аз омода эълон кардан, мунтазири саломатӣ мешавад — нигаред ба Насб ва навсозиҳо. Сипас шумо ҳувияти OAuth-и ҳар агентро пайваст мекунед ва ACL-и дарахти шуъбаҳоро харита мекунед.

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

  • Танҳо паёмнависии дохилии кормандон — омниканали муштарӣ нест.
  • Ҳувияти OAuth-и ба монанди инсон барои ҳар агент — агентҳо ҳисоби умумии бот нестанд.
  • ACL-и дарахти шуъбаҳо — дастрасӣ ба сохтори ташкилоти шумо эҳтиром мегузорад.
  • Deliver-и идемпотентӣ — Markdown ба BB-code ренд мешавад ва ҳеҷ гоҳ ду маротиба фиристода намешавад.
  • Воридшавандаи танҳо матнӣ; на клавиатура/threads.
  • Host-native — зери systemd кор мекунад, на дар контейнер.

Минбаъд ба куҷо