Плагинҳои расмӣ/Плагини Bitrix24
Плагини 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 кор мекунад, на дар контейнер.
Минбаъд ба куҷо
<p class="doc-plugin-logo"><img class="th-on-dark" src="/pl/bitrix24-dark.svg" alt="" width="60" height="60" /><img class="th-on-light" src="/pl/bitrix24-light.svg" alt="" width="60" height="60" /></p>
**Плагини Bitrix24 агенти шуморо ба Bitrix24 ҳамчун канали дохилии паёмнависии
фаврии кормандон пайваст мекунад.** Кормандон ба агент ҳамон тавре паём мефиристанд,
ки ба ҳамкор паём медиҳанд, ва агент дар чати Bitrix24 ҷавоб медиҳад.
> [!WARNING]
> Bitrix24 дар ин ҷо **канали дохилии паёмнависии кормандон** аст — ба монанди
> Telegram ё Slack барои кормандон. Он **омниканали муштарӣ нест**: на Open Lines,
> на навбати тикетҳо ва на эскалатсияи оператор вуҷуд дорад. Ин плагинро барои
> хатти дастгирии муштарӣ истифода набаред.
Плагин ба таври миёнаи мизбон (host-native) кор мекунад ва бо gateway тавассути
қарордод гуфтугӯ мекунад. Рафтори канал барои корбари ниҳоӣ дар саҳифаи канали
[Bitrix24](/en/v1.0/channels/bitrix24) аст; ин саҳифа худи плагинро фаро мегирад.
## Далелҳо
| Майдон | Қимат |
|---|---|
| Версия | 1.0.0 |
| Порт | 8810 |
| Runtime | host-native |
## Он чист
Пули дутарафа байни чати Bitrix24 ва AiHummer. Агент дар Bitrix24 ҳамчун
**ҳувияти ба монанди инсон** зоҳир мешавад — ҳар агент бо ҳувияти OAuth-и худаш
аутентификатсия мешавад, на бо ҳисоби умумии бот — то гуфтугӯ ба сӯҳбат бо ҳамкор
монанд бошад. Дастрасӣ аз **ACL-и дарахти шуъбаҳои** ташкилот пайравӣ мекунад,
бинобар ин доираи дастрасии агент ба сохтори Bitrix24-и шумо эҳтиром мегузорад.
## Чӣ тавр истифода мешавад
- **Воридшаванда:** як pull poller паёмҳои навро мегирад ва онҳоро ба нуқтаи
ниҳоии умумии воридшавандаи gateway мефиристад, ки дар он router агенти ҳадафро
ҳал мекунад.
- **Содиршаванда:** ҷавобҳо тавассути қадами идемпотентии **Deliver**-и
коннектор фиристода мешаванд, ки Markdown-и агентро ба **BB-code**-и Bitrix24
табдил медиҳад ва кафолат медиҳад, ки паём ду маротиба фиристода намешавад.
```text
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24
```
## Хусусиятҳои дастгиришаванда
Плагин рафтори бой ва ба монанди инсони чатро дастгирӣ мекунад:
- реаксияҳо
- таҳрир ва ҳазфи паём
- нишондиҳандаҳои чопкунӣ
- @-зикрҳо
- медиа
## Маҳдудиятҳо
> [!WARNING]
> Модели ба монанди инсон қасдан баъзе хусусиятҳои боти Bitrix24-ро дар бар
> **намегирад**:
>
> - **Клавиатураҳо / тугмаҳои интерактивӣ нестанд** ва **сатрҳо (threads) нестанд.**
> - **Медиа ва овози воридшаванда фиристода намешаванд** — воридшаванда **танҳо
> матн аст.** Ҳувияти ба монанди ҳамкор матнро қабул ва ба он ҷавоб медиҳад;
> замимаҳо ва ёддоштҳои овозӣ, ки *ба* агент фиристода мешаванд, ба turn
> интиқол дода намешаванд.
## Насб
Bitrix24-ро бо як клик аз бозор дар админ UI насб кунед. Деплойери host-native
плагинро зеркашӣ мекунад, қадами насби онро иҷро мекунад, як воҳиди systemd-и
изолятсияшударо ренд мекунад ва пеш аз омода эълон кардан, мунтазири саломатӣ
мешавад — нигаред ба [Насб ва навсозиҳо](/en/v1.0/marketplace/install-updates).
Сипас шумо ҳувияти OAuth-и ҳар агентро пайваст мекунед ва ACL-и дарахти шуъбаҳоро
харита мекунед.
## Амният ва маҳдудиятҳо
- **Танҳо паёмнависии дохилии кормандон** — омниканали муштарӣ нест.
- **Ҳувияти OAuth-и ба монанди инсон барои ҳар агент** — агентҳо ҳисоби умумии
бот нестанд.
- **ACL-и дарахти шуъбаҳо** — дастрасӣ ба сохтори ташкилоти шумо эҳтиром мегузорад.
- **Deliver-и идемпотентӣ** — Markdown ба BB-code ренд мешавад ва ҳеҷ гоҳ ду
маротиба фиристода намешавад.
- **Воридшавандаи танҳо матнӣ; на клавиатура/threads.**
- **Host-native** — зери systemd кор мекунад, на дар контейнер.
## Минбаъд ба куҷо
- Канал: [Bitrix24](/en/v1.0/channels/bitrix24)
- [Насб ва навсозиҳо](/en/v1.0/marketplace/install-updates)
- [Шарҳи бозор ва дараҷаҳо](/en/v1.0/marketplace/overview-tiers)