Bitrix24 — гэта ўнутраны канал імгненных паведамленняў для супрацоўнікаў — такую ж ролю, якую Telegram або Slack адыгрывае для супрацоўнікаў. Агент AiHummer з’яўляецца ў Bitrix24 вашай кампаніі як калега, з якім супрацоўнікі могуць перапісацца і згадваць у паведамленнях.
Канал адпраўляе ў якасці раз’ём унутры прадукту Рынак і працуе на роднай сістэме хаста. Ён наладжваецца праз Admin UI, як і любы іншы канал.
[!NOTE]
Канал Bitrix24 патрабуе актыўнасці Стартап, Бізнэс ці
Прадпрыемства ліцэнзія. Па плана супольнасці ўстаноўка раз’ема вяртае
HTTP 402 «трэба абнаўленне» (код plan_limit) — гл.
Ліцэнзаванне.
[!WARNING]
Bitrix24 тут выключна унутраны канал імгненных паведамленняў для супрацоўнікаўГэта не
кліент шматканальны не Адкрытыя лініі Bitrix24 не чарга за білетамі, і
не паверхня эскалацыі аператара. Не выкарыстоўвайце яе для маршрутызацыі знешніх
размовы з кліентамі.
Асоба агента, падобная да чалавека
Кожны агент злучаецца са сваім уласным асаблівая аутэнтыфікацыя OAuth пад чалавекаподобнага, таму ў Bitrix24 ён паказваецца як асобная асоба, а не як звычайны інтэграцыйны бот. Віднасць адпавядае структуры вашай арганізацыі праз ACL дрэва аддзела — агент бачыць і ўдзельнічае толькі там, дзе дазволена яго ідэнтычнасць, пры гэтым следуючы той жа іерархіі аддзела, што і вашы супрацоўнікі.
Акрамя ідэнтыфікатараў OAuth, канектар таксама падтрымлівае іншыя шляхі прадастаўлення доступу: аўтаматычнае стварэнне акаўнтаў агента праз уліковы запіс адміністратара партала (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) і прывязанасць да папярэдне створаныя карыстальнікі Bitrix24 па фіксаваных ідэнтыфікатарах (BITRIX24_AGENT_USER_IDS).
Парты і час выканання
Злучальнік слухае на адным порце:
Порт
Мэта
8810
Сэрвіс злучальнікаў (ахова здароўя, кропка дастаўкі і згода OAuth)
Як працякаюць паведамленні
Bitrix24 не перадае ўваходныя падзеі ў AiHummer; злучальнік цягне іх.
Унутраны — рэцэптар пацягвае новыя паведамленні і адпраўляе іх на шлюз па
/v1/inbound/generic.
Выязны — адказы дастаўляюцца праз aihummer.connector.v1Даставіць кантракт. Агенцтво markdown пераўтвараецца ў BB-код Bitrix24, і
дастаўка ёсць ідэмпатэнтны, таму паўторная адпраўка ніколі не стварае дубліката
пасланне.
Што падтрымліваецца
Канал ахоплівае ўзаемадзеянні, якія адпавядаюць чалавечай ідэнтычнасці супрацоўніка:
Рэакцыі, паведамленне рэдагаваць і выдаліць.
Друкаванне індыкатары
@-згадванні.
СМІ у зыходных паведамленнях
[!WARNING]
Некаторыя функцыі ў стылі Telegram зроблены наўмысна не падтрымліваецца ў
мадэль, якая падобная на чалавека:
Няма інтэрактыўных клавіятур або кнопак і няма тэм.
Уваходны тэкст, медыя і голас перанакіроўваюцца — выявы, аўдыё, голас і файлы.
Плануйце патокі агентаў вакол узаемадзеяння на аснове тэксту на гэтым канале.
**Bitrix24 — гэта ўнутраны канал імгненных паведамленняў для супрацоўнікаў** — такую ж ролю, якую Telegram або Slack адыгрывае для супрацоўнікаў. Агент AiHummer з'яўляецца ў Bitrix24 вашай кампаніі як калега, з якім супрацоўнікі могуць перапісацца і згадваць у паведамленнях.
Канал адпраўляе ў якасці **раз'ём унутры прадукту [Рынак](/be/v1.0/marketplace/overview-tiers)** і працуе на роднай сістэме хаста. Ён наладжваецца праз Admin UI, як і любы іншы канал.
> [!NOTE]
> Канал Bitrix24 патрабуе актыўнасці **Стартап**, **Бізнэс** ці
> **Прадпрыемства** ліцэнзія. Па плана супольнасці ўстаноўка раз'ема вяртае
> **HTTP 402 «трэба абнаўленне»** (код `plan_limit`) — гл.
> [Ліцэнзаванне](/be/v1.0/commercial/licensing).
> [!WARNING]
> Bitrix24 тут выключна **унутраны канал імгненных паведамленняў для супрацоўнікаў**Гэта **не**
> кліент шматканальны **не** Адкрытыя лініі Bitrix24 **не** чарга за білетамі, і
> **не** паверхня эскалацыі аператара. Не выкарыстоўвайце яе для маршрутызацыі знешніх
> размовы з кліентамі.
## Асоба агента, падобная да чалавека
Кожны агент злучаецца са сваім уласным **асаблівая аутэнтыфікацыя OAuth пад чалавекаподобнага**, таму ў Bitrix24 ён паказваецца як асобная асоба, а не як звычайны інтэграцыйны бот. Віднасць адпавядае структуры вашай арганізацыі праз **ACL дрэва аддзела** — агент бачыць і ўдзельнічае толькі там, дзе дазволена яго ідэнтычнасць, пры гэтым следуючы той жа іерархіі аддзела, што і вашы супрацоўнікі.
Акрамя ідэнтыфікатараў OAuth, канектар таксама падтрымлівае іншыя шляхі прадастаўлення доступу: **аўтаматычнае стварэнне акаўнтаў агента праз уліковы запіс адміністратара партала** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) і прывязанасць да **папярэдне створаныя карыстальнікі Bitrix24 па фіксаваных ідэнтыфікатарах** (`BITRIX24_AGENT_USER_IDS`).
## Парты і час выканання
Злучальнік слухае на адным порце:
| Порт | Мэта |
|---|---|
| 8810 | Сэрвіс злучальнікаў (ахова здароўя, кропка дастаўкі і згода OAuth) |
## Як працякаюць паведамленні
Bitrix24 не перадае ўваходныя падзеі ў AiHummer; злучальнік **цягне** іх.
- **Унутраны** — рэцэптар пацягвае новыя паведамленні і адпраўляе іх на шлюз па
`/v1/inbound/generic`.
- **Выязны** — адказы дастаўляюцца праз `aihummer.connector.v1`
**Даставіць** кантракт. Агенцтво **markdown пераўтвараецца ў BB-код Bitrix24**, і
дастаўка ёсць **ідэмпатэнтны**, таму паўторная адпраўка ніколі не стварае дубліката
пасланне.
## Што падтрымліваецца
Канал ахоплівае ўзаемадзеянні, якія адпавядаюць чалавечай ідэнтычнасці супрацоўніка:
- Рэакцыі, паведамленне **рэдагаваць** і **выдаліць**.
- **Друкаванне** індыкатары
- **@-згадванні**.
- **СМІ** у зыходных паведамленнях
> [!WARNING]
> Некаторыя функцыі ў стылі Telegram зроблены наўмысна **не** падтрымліваецца ў
> мадэль, якая падобная на чалавека:
>
> - **Няма інтэрактыўных клавіятур або кнопак** і **няма тэм**.
> - **Уваходны тэкст, медыя і голас перанакіроўваюцца** — выявы, аўдыё, голас і файлы.
>
> Плануйце патокі агентаў вакол узаемадзеяння на аснове тэксту на гэтым канале.
## Куды далей
- Аб усталяванні раздымаў: [Рынак](/be/v1.0/marketplace/overview-tiers).
- Для інтэрактыўных клавіятур і апытанняў выкарыстоўвайце [Тэлеграм](/be/v1.0/channels/telegram)
ці [МАКС](/be/v1.0/channels/max).
- Глядзіце базавы API для захопу дадзеных у
[Агульны ўваходны](/be/v1.0/channels/generic-inbound).
