Bitrix24 — гэта ўнутраны карпаратыўны канал імгненных паведамленняў — тую ж
ролю для супрацоўнікаў выконваюць Telegram ці Slack. Агент AiHummer з’яўляецца
ўнутры Bitrix24 вашай кампаніі як калега, якому супрацоўнікі могуць пісаць і якога
могуць згадваць.
Канал пастаўляецца як канектар з убудаванага
Маркетплейса і працуе host-native. Ён
наладжваецца з Admin UI, як і любы іншы канал.
[!WARNING]
Bitrix24 тут — гэта выключна ўнутраны карпаратыўны IM-канал. Гэта не
кліенцкая омніканальнасць, не Bitrix24 Open Lines, не чарга тыкетаў і
не паверхня для эскалацыі на аператара. Не выкарыстоўвайце яго для
маршрутызацыі знешніх кліенцкіх размоў.
Чалавекападобная ідэнтычнасць агента
Кожны агент падключаецца з уласнай чалавекападобнай OAuth-ідэнтычнасцю, таму ў
Bitrix24 ён паказваецца як асобная асоба, а не як абагульнены інтэграцыйны бот.
Бачнасць паважае структуру вашай арганізацыі праз ACL па дрэве аддзелаў — агент
бачыць і ўдзельнічае толькі там, дзе яго ідэнтычнасці дазволена, прытрымліваючыся
той самай іерархіі аддзелаў, што і вашы супрацоўнікі.
Парты і рантайм
Канектар выкарыстоўвае невялікі набор фіксаваных партоў:
Port
Прызначэнне
8810
Сэрвіс канектара (стан і кіраванне)
8080
Эндпойнт дастаўкі (па змаўчанні)
8791
OAuth-згода
Як рухаюцца паведамленні
Bitrix24 не пушыць уваходныя падзеі ў AiHummer; канектар выцягвае іх.
Уваходныя — pull-апытвальнік чытае новыя паведамленні і адпраўляе іх у шлюз
на /v1/inbound/generic.
Зыходныя — адказы дастаўляюцца праз кантракт Deliveraihummer.connector.v1. Markdown агента пераўтвараецца ў BB-код Bitrix24, а
дастаўка ідэмпатэнтная, таму паўторная адпраўка ніколі не стварае
дубліката паведамлення.
Што падтрымліваецца
Канал ахоплівае ўзаемадзеянні, якія адпавядаюць чалавекападобнай ідэнтычнасці
супрацоўніка:
Рэакцыі, рэдагаванне і выдаленне паведамленняў.
Індыкатары набору тэксту.
@-згадкі.
Медыя ў зыходных паведамленнях.
[!WARNING]
Некаторыя функцыі ў стылі Telegram наўмысна не падтрымліваюцца ў
чалавекападобнай мадэлі:
Няма інтэрактыўных клавіятур ці кнопак і няма трэдаў.
Уваходныя медыя і галасавыя паведамленні не перасылаюцца — уваходны паток
толькі тэкставы.
Плануйце патокі агента вакол тэкставага ўзаемадзеяння на гэтым канале.
**Bitrix24 — гэта ўнутраны карпаратыўны канал імгненных паведамленняў** — тую ж
ролю для супрацоўнікаў выконваюць Telegram ці Slack. Агент AiHummer з'яўляецца
ўнутры Bitrix24 вашай кампаніі як калега, якому супрацоўнікі могуць пісаць і якога
могуць згадваць.
Канал пастаўляецца як **канектар з убудаванага
[Маркетплейса](/be/v1.0/marketplace/overview-tiers)** і працуе host-native. Ён
наладжваецца з Admin UI, як і любы іншы канал.
> [!WARNING]
> Bitrix24 тут — гэта выключна **ўнутраны карпаратыўны IM-канал**. Гэта **не**
> кліенцкая омніканальнасць, **не** Bitrix24 Open Lines, **не** чарга тыкетаў і
> **не** паверхня для эскалацыі на аператара. Не выкарыстоўвайце яго для
> маршрутызацыі знешніх кліенцкіх размоў.
## Чалавекападобная ідэнтычнасць агента
Кожны агент падключаецца з уласнай **чалавекападобнай OAuth-ідэнтычнасцю**, таму ў
Bitrix24 ён паказваецца як асобная асоба, а не як абагульнены інтэграцыйны бот.
Бачнасць паважае структуру вашай арганізацыі праз **ACL па дрэве аддзелаў** — агент
бачыць і ўдзельнічае толькі там, дзе яго ідэнтычнасці дазволена, прытрымліваючыся
той самай іерархіі аддзелаў, што і вашы супрацоўнікі.
## Парты і рантайм
Канектар выкарыстоўвае невялікі набор фіксаваных партоў:
| Port | Прызначэнне |
|---|---|
| 8810 | Сэрвіс канектара (стан і кіраванне) |
| 8080 | Эндпойнт дастаўкі (па змаўчанні) |
| 8791 | OAuth-згода |
## Як рухаюцца паведамленні
Bitrix24 не пушыць уваходныя падзеі ў AiHummer; канектар **выцягвае** іх.
- **Уваходныя** — pull-апытвальнік чытае новыя паведамленні і адпраўляе іх у шлюз
на `/v1/inbound/generic`.
- **Зыходныя** — адказы дастаўляюцца праз кантракт **Deliver**
`aihummer.connector.v1`. **Markdown агента пераўтвараецца ў BB-код Bitrix24**, а
дастаўка **ідэмпатэнтная**, таму паўторная адпраўка ніколі не стварае
дубліката паведамлення.
## Што падтрымліваецца
Канал ахоплівае ўзаемадзеянні, якія адпавядаюць чалавекападобнай ідэнтычнасці
супрацоўніка:
- Рэакцыі, **рэдагаванне** і **выдаленне** паведамленняў.
- Індыкатары **набору тэксту**.
- **@-згадкі**.
- **Медыя** ў зыходных паведамленнях.
> [!WARNING]
> Некаторыя функцыі ў стылі Telegram наўмысна **не** падтрымліваюцца ў
> чалавекападобнай мадэлі:
>
> - **Няма інтэрактыўных клавіятур ці кнопак** і **няма трэдаў**.
> - **Уваходныя медыя і галасавыя паведамленні не перасылаюцца** — уваходны паток
> **толькі тэкставы**.
>
> Плануйце патокі агента вакол тэкставага ўзаемадзеяння на гэтым канале.
## Куды далей
- Пра ўсталяванне канектараў: [Маркетплейс](/be/v1.0/marketplace/overview-tiers).
- Для інтэрактыўных клавіятур і апытанняў выкарыстоўвайце
[Telegram](/be/v1.0/channels/telegram) ці [MAX](/be/v1.0/channels/max).
- Глядзіце базавы API прыёму ў
[Generic inbound](/be/v1.0/channels/generic-inbound).
