Плагинҳои расмӣ/Иловаи Bitrix24
Иловаи Bitrix24
v1.0.x · навсозӣ шуд 2026-07-05


Плагини Bitrix24 агенти шуморо ба Bitrix24 ҳамчун канали паёмнависии фаврии корманди дохилӣ мепайвандад. Ходимон ба агент ҳамон тавре паёми худ ба ҳамкорон мерасонданд, паём мефиристанд ва агент дар чати Bitrix24 ҷавоб медиҳад.
[!WARNING]
Bitrix24 ин аст канали дохилии кормандон — монанди Telegram ё Slack
барои кормандон. Ин аст не мусоҳибаи бисёрканалӣ бо мизоҷ: хатҳои кушод вуҷуд надорад, нест
навбатбандии чипта ва баландсозии оператор вуҷуд надорад. Барои пешбурди он плагинро истифода набаред
хатти дастгирии муштариён
Плагин ба таври маҳаллии мизбонӣ кор мекунад ва тавассути гузаргоҳ бо он муошират мекунад aihummer.connector.v1 шартнома. Равияи канали истеъмолкунандаи ниҳоӣ дар саҳифаи канал аст Битрикс24Ин саҳифа худи плагинро фаро мегирад.
Ҳақиқатҳо
| Замин |
Арзиш |
| Нусха |
1.0.0 |
| Бандар |
8810 |
| Вақти иҷро |
мизбон-меҳмон |
Ин чӣ аст
Пули дутарафа байни чат Bitrix24 ва AiHummer. Агенти он ҳамчун шиносномаи монанди инсон дар Bitrix24 — ҳар агент бо шахсияти OAuth-и худ эътиборнокӣ мекунад на бо ҳисоби ботии умумӣ — бинобар ин сӯҳбатҳо монанди гуфтугӯ бо ҳамкор ба назар мерасанд. Дострасӣ тибқи созмони ташкилот аст сохтмони-шохаии шуъба ACLба ин тариқ, расонидани агент ба сохтори Bitrix24-и шумо эҳтиром мегузорад.
Ба ҷуз Идентификатсияи OAuth, роҳҳои дигар барои фароҳам овардан дастгирӣ мешаванд: эҷоди худкор ҳисобҳои агент тавассути воридшавии администратори портали (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) ва пайвастшавӣ ба корбарони пешакии Bitrix24 бо ID-ҳои муқаррарӣ (BITRIX24_AGENT_USER_IDS).
Чӣ тавр истифода мешавад
- Воридшаванда: як ченкунандаи кашидан паёмҳои навро мегирад ва ба
Шабакаи умумии воридшавандаи gateway, ки дар он роутер агенти мақсадро ҳал мекунад.
- Сафари баромад Ҷавобҳо тавассути идемпотенти пайвасткунандаро фиристода мешаванд Таҳвил додан
қадам, ки Markdown-и агентро ба Bitrix24 табдил медиҳад Код BB ва
кафолат медиҳад, ки паём ду бор ирсол намешавад.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24
Вижагиҳои дастгиришаванда
Илова фаъолияти муноқишавии фароғатӣ ва монанди инсонро дастгирӣ мекунад:
- реаксияҳо
- пайомро таҳрир ва нест кардан
- нишондиҳандаҳои навиштан
- @-зикрҳо
- Воситаҳои ахбори омма
Маҳдудиятҳо
[!WARNING]
Намунаи монанди инсон ба таври огоҳона амал мекунад не ба барномаҳои Bitrix24 ботро дохил кунед
хусусиятҳо:
- Ҳеҷ клавиатура ё тугмаи интерактивӣ вуҷуд надорад ва ҳеҷ хат нест.
- Васоити ахбори воридшаванда ва овоз ирсол намешаванд — воридшаванда аст Танҳо матн. А
Шахсияти намуди ҳамкор матнро қабул мекунад ва посух медиҳад; замимаҳо ва овоз
Ёддоштҳо, ки ба агент фиристода шудаанд, ба навбати нав интиқол дода намешаванд.
Насб
Bitrix24-ро бо як клик аз бозори барномаҳо дар интерфейси маъмурӣ насб кунед. Деплойери дохилии хост плагинро зеркашӣ мекунад, қадами насби онро иҷро мекунад, як воҳиди systemd-и изолятсияшуда эҷод мекунад ва то омода ҳисоб кардани он барои саломатӣ мунтазир мешавад — нигаред Насб ва навсозӣСипас шумо ҳар як шиносномаи OAuth-и агентро пайваст карда, ACL-и дарахти шӯъбаро нақш мегиред.
Амният ва маҳдудиятҳо
- Фариқати дохилии кормандон танҳо — на муштарии омниканалӣ.
- Шахсияти OAuth монанди инсон барои ҳар як агенти — агентҳо ҳисобҳои умумии бот нестанд.
- Рӯйхати иҷозатҳои шохаи шуъба — reach ба сохтори ташкилоти шумо эҳтиром мегузорад.
- Идентентии таҳвил — Markdown ба BB-код табдил дода мешавад ва ҳеҷ гоҳ ду бор фиристода намешавад.
- Фақат матн ворид мешавад; клавиатураҳо/сӯҳбатҳо нестанд.
- Мизбон-миқдор — дар зерсистемаи 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
> барои кормандон. Ин аст **не** мусоҳибаи бисёрканалӣ бо мизоҷ: хатҳои кушод вуҷуд надорад, нест
> навбатбандии чипта ва баландсозии оператор вуҷуд надорад. Барои пешбурди он плагинро истифода набаред
> хатти дастгирии муштариён
Плагин ба таври маҳаллии мизбонӣ кор мекунад ва тавассути гузаргоҳ бо он муошират мекунад `aihummer.connector.v1` шартнома. Равияи канали истеъмолкунандаи ниҳоӣ дар саҳифаи канал аст [Битрикс24](/tg/v1.0/channels/bitrix24)Ин саҳифа худи плагинро фаро мегирад.
## Ҳақиқатҳо
| Замин | Арзиш |
|---|---|
| Нусха | 1.0.0 |
| Бандар | 8810 |
| Вақти иҷро | мизбон-меҳмон |
## Ин чӣ аст
Пули дутарафа байни чат Bitrix24 ва AiHummer. Агенти он ҳамчун **шиносномаи монанди инсон** дар Bitrix24 — ҳар агент бо шахсияти OAuth-и худ эътиборнокӣ мекунад на бо ҳисоби ботии умумӣ — бинобар ин сӯҳбатҳо монанди гуфтугӯ бо ҳамкор ба назар мерасанд. Дострасӣ тибқи созмони ташкилот аст **сохтмони-шохаии шуъба ACL**ба ин тариқ, расонидани агент ба сохтори Bitrix24-и шумо эҳтиром мегузорад.
Ба ҷуз Идентификатсияи OAuth, роҳҳои дигар барои фароҳам овардан дастгирӣ мешаванд: эҷоди худкор ҳисобҳои агент тавассути воридшавии администратори портали (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) ва пайвастшавӣ ба корбарони пешакии Bitrix24 бо ID-ҳои муқаррарӣ (`BITRIX24_AGENT_USER_IDS`).
## Чӣ тавр истифода мешавад
- **Воридшаванда:** як ченкунандаи кашидан паёмҳои навро мегирад ва ба
Шабакаи умумии воридшавандаи gateway, ки дар он роутер агенти мақсадро ҳал мекунад.
- **Сафари баромад** Ҷавобҳо тавассути идемпотенти пайвасткунандаро фиристода мешаванд **Таҳвил додан**
қадам, ки Markdown-и агентро ба Bitrix24 табдил медиҳад **Код BB** ва
кафолат медиҳад, ки паём ду бор ирсол намешавад.
```text
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24
```
## Вижагиҳои дастгиришаванда
Илова фаъолияти муноқишавии фароғатӣ ва монанди инсонро дастгирӣ мекунад:
- реаксияҳо
- пайомро таҳрир ва нест кардан
- нишондиҳандаҳои навиштан
- @-зикрҳо
- Воситаҳои ахбори омма
## Маҳдудиятҳо
> [!WARNING]
> Намунаи монанди инсон ба таври огоҳона амал мекунад **не** ба барномаҳои Bitrix24 ботро дохил кунед
> хусусиятҳо:
>
> - **Ҳеҷ клавиатура ё тугмаи интерактивӣ вуҷуд надорад** ва **ҳеҷ хат нест.**
> - **Васоити ахбори воридшаванда ва овоз ирсол намешаванд** — воридшаванда аст **Танҳо матн.** А
> Шахсияти намуди ҳамкор матнро қабул мекунад ва посух медиҳад; замимаҳо ва овоз
> Ёддоштҳо, ки ба агент фиристода шудаанд, ба навбати нав интиқол дода намешаванд.
## Насб
Bitrix24-ро бо як клик аз бозори барномаҳо дар интерфейси маъмурӣ насб кунед. Деплойери дохилии хост плагинро зеркашӣ мекунад, қадами насби онро иҷро мекунад, як воҳиди systemd-и изолятсияшуда эҷод мекунад ва то омода ҳисоб кардани он барои саломатӣ мунтазир мешавад — нигаред [Насб ва навсозӣ](/tg/v1.0/marketplace/install-updates)Сипас шумо ҳар як шиносномаи OAuth-и агентро пайваст карда, ACL-и дарахти шӯъбаро нақш мегиред.
## Амният ва маҳдудиятҳо
- **Фариқати дохилии кормандон танҳо** — на муштарии омниканалӣ.
- **Шахсияти OAuth монанди инсон барои ҳар як агенти** — агентҳо ҳисобҳои умумии бот нестанд.
- **Рӯйхати иҷозатҳои шохаи шуъба** — reach ба сохтори ташкилоти шумо эҳтиром мегузорад.
- **Идентентии таҳвил** — Markdown ба BB-код табдил дода мешавад ва ҳеҷ гоҳ ду бор фиристода намешавад.
- **Фақат матн ворид мешавад; клавиатураҳо/сӯҳбатҳо нестанд.**
- **Мизбон-миқдор** — дар зерсистемаи systemd кор мекунад, на дар контейнер.
## Баъд ба куҷо
- Стансия [Битрикс24](/tg/v1.0/channels/bitrix24)
- [Насб ва навсозӣ](/tg/v1.0/marketplace/install-updates)
- [Назари умумӣ ба бозор ва сатҳҳо](/tg/v1.0/marketplace/overview-tiers)