Bitrix24 ички кызматкерлердин дароо билдирүүлөрү каналы болуп саналат — кызматкерлер үчүн Telegram же Slack ойногондой эле роль ойнойт. AiHummer агенти сиздин компаниянын Bitrix24 ичинде кызматкер катары пайда болуп, кызматкерлер аны билдирип жана чакыра алышат.
Канал катары жүктөрдү жөнөтөт продукция ичиндеги туташтыргыч Базар жана хостто жергиликтүү деңгээлде иштейт. Бул башка каналдар сыяктуу Админ UI аркылуу конфигурацияланат.
[!NOTE]
Bitrix24 каналы активдүү болууга муктаж Баштоочу, Бизнес же
Ишкана лицензия. Коомдук планда, коннекторду орнотуу кайтып берет
HTTP 402 «жок кылуу талап кылынат» (код plan_limit) — кара
Лицензиялоо.
[!WARNING]
Bitrix24 бул жерде так аны ишкананын ички кызматкерлеринин IM каналы. Бул эмес
кардардын ар кандай каналдары эмес Bitrix24 Ачык Линиялар эмес билет кезеги, жана
эмес операторду көтөрүү беттик. Муну тышкы багыттоо үчүн колдонбоңуз
кардарды менен сүйлөшүүлөр.
Адам сыяктуу агенттин инсандыгы
Ар бир агент өзүнүн менен байланышат адамга окшош OAuth жеке менчик, андыктан ал Bitrix24’тө жалпы интеграция ботунан айырмаланып, өзгөчө адам катары көрүнөт. Көрүнүү сиздин уюм структураңызга ылайык болот бөлүм дарагынын ACL — агент өзүнүн жеке өздүгүн уруксат берген жерден гана көрөт жана катышат, сиздин кызматкерлериңиз сыяктуу эле бөлүм иерархиясын кармап.
OAuth аныктарынан тыш, туташтыруучу ошондой эле башка камсыздоо жолдорун колдойт: портал администратору кирүүсү аркылуу авто-мобилдик камсыздоо агенттик аккаунттар (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) жана байлоо түздөн-түз белгиленген идентификаторлор менен алдын ала түзүлгөн Bitrix24 колдонуучулары (BITRIX24_AGENT_USER_IDS).
Порттор жана убакытта иштетүү
Туташтыргыч бир портуна угат:
Порт
Максат
8810
Өчүргүч кызматы (ден соолук, Deliver учу и Oauth макулдугу)
Кабарлар кандай агат
Bitrix24 AiHummerге кирүүчү окуяларды итербейт; туташтыруу тартат аларды.
Ичке — суруу соруучу жаңы билдирүүлөрдү окуп, аларды шлюзго жайгаштырөт
/v1/inbound/generic.
Чыгуу — жооптор аркылуу жеткирилет aihummer.connector.v1жеткирүү келишим. Агент markdown Bitrix24 BB-кодуна айландырылат, жана
жеткирүү идемпотент, ошондуктан кайталанган жиберүү эч качан көчүрмөнү пайда кылбайт
хат.
Эмне колдоого алынат
Бул канал адамга окшош кызматкердин идентификациясына туура келген өз ара аракеттерди камтыйт:
Реакциялар, билдирүү редакциялоо жана өндүрүш.
Тиркөө көрсәткүчтөр.
@-байланыштар.
Медиа чыгуу билдирүүлөрүндө.
[!WARNING]
Кээ бир Телеграмм стилиндеги функциялар атайын эмес колдоого алынган
адамга окшош модель:
Интерактивдүү клавиатуралар жана баскычтар жок жана жиптер жок.
Кирген тексттер, медиа жана үн жиберилет — сүрөттөр, үн, добуш жана файлдар.
Бул каналдагы текстке негизделген өз ара аракеттенүү боюнча агент агымдарын пландаштырыңыз.
Интерактив клавиатуралар жана сурамжылоолор үчүн колдонуу Телеграм
же МАКС.
Төмөндө негизги киргизүү APIсын караңыз
Жалпы кирүү.
**Bitrix24 ички кызматкерлердин дароо билдирүүлөрү каналы болуп саналат** — кызматкерлер үчүн Telegram же Slack ойногондой эле роль ойнойт. AiHummer агенти сиздин компаниянын Bitrix24 ичинде кызматкер катары пайда болуп, кызматкерлер аны билдирип жана чакыра алышат.
Канал катары жүктөрдү жөнөтөт **продукция ичиндеги туташтыргыч [Базар](/ky/v1.0/marketplace/overview-tiers)** жана хостто жергиликтүү деңгээлде иштейт. Бул башка каналдар сыяктуу Админ UI аркылуу конфигурацияланат.
> [!NOTE]
> Bitrix24 каналы активдүү болууга муктаж **Баштоочу**, **Бизнес** же
> **Ишкана** лицензия. Коомдук планда, коннекторду орнотуу кайтып берет
> **HTTP 402 «жок кылуу талап кылынат»** (код `plan_limit`) — кара
> [Лицензиялоо](/ky/v1.0/commercial/licensing).
> [!WARNING]
> Bitrix24 бул жерде так аны **ишкананын ички кызматкерлеринин IM каналы**. Бул **эмес**
> кардардын ар кандай каналдары **эмес** Bitrix24 Ачык Линиялар **эмес** билет кезеги, жана
> **эмес** операторду көтөрүү беттик. Муну тышкы багыттоо үчүн колдонбоңуз
> кардарды менен сүйлөшүүлөр.
## Адам сыяктуу агенттин инсандыгы
Ар бир агент өзүнүн менен байланышат **адамга окшош OAuth жеке менчик**, андыктан ал Bitrix24'тө жалпы интеграция ботунан айырмаланып, өзгөчө адам катары көрүнөт. Көрүнүү сиздин уюм структураңызга ылайык болот **бөлүм дарагынын ACL** — агент өзүнүн жеке өздүгүн уруксат берген жерден гана көрөт жана катышат, сиздин кызматкерлериңиз сыяктуу эле бөлүм иерархиясын кармап.
OAuth аныктарынан тыш, туташтыруучу ошондой эле башка камсыздоо жолдорун колдойт: **портал администратору кирүүсү аркылуу авто-мобилдик камсыздоо агенттик аккаунттар** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) жана байлоо **түздөн-түз белгиленген идентификаторлор менен алдын ала түзүлгөн Bitrix24 колдонуучулары** (`BITRIX24_AGENT_USER_IDS`).
## Порттор жана убакытта иштетүү
Туташтыргыч бир портуна угат:
| Порт | Максат |
|---|---|
| 8810 | Өчүргүч кызматы (ден соолук, Deliver учу и Oauth макулдугу) |
## Кабарлар кандай агат
Bitrix24 AiHummerге кирүүчү окуяларды итербейт; туташтыруу **тартат** аларды.
- **Ичке** — суруу соруучу жаңы билдирүүлөрдү окуп, аларды шлюзго жайгаштырөт
`/v1/inbound/generic`.
- **Чыгуу** — жооптор аркылуу жеткирилет `aihummer.connector.v1`
**жеткирүү** келишим. Агент **markdown Bitrix24 BB-кодуна айландырылат**, жана
жеткирүү **идемпотент**, ошондуктан кайталанган жиберүү эч качан көчүрмөнү пайда кылбайт
хат.
## Эмне колдоого алынат
Бул канал адамга окшош кызматкердин идентификациясына туура келген өз ара аракеттерди камтыйт:
- Реакциялар, билдирүү **редакциялоо** жана **өндүрүш**.
- **Тиркөө** көрсәткүчтөр.
- **@-байланыштар**.
- **Медиа** чыгуу билдирүүлөрүндө.
> [!WARNING]
> Кээ бир Телеграмм стилиндеги функциялар атайын **эмес** колдоого алынган
> адамга окшош модель:
>
> - **Интерактивдүү клавиатуралар жана баскычтар жок** жана **жиптер жок**.
> - **Кирген тексттер, медиа жана үн жиберилет** — сүрөттөр, үн, добуш жана файлдар.
>
> Бул каналдагы текстке негизделген өз ара аракеттенүү боюнча агент агымдарын пландаштырыңыз.
## Келерки кайда
- Тиркемелерди орнотуу учурунда: [Базар](/ky/v1.0/marketplace/overview-tiers).
- Интерактив клавиатуралар жана сурамжылоолор үчүн колдонуу [Телеграм](/ky/v1.0/channels/telegram)
же [МАКС](/ky/v1.0/channels/max).
- Төмөндө негизги киргизүү APIсын караңыз
[Жалпы кирүү](/ky/v1.0/channels/generic-inbound).
