Bitrix24 — ішкі қызметкер лезде-хабар алмасу арнасы — Telegram немесе Slack
қызметкерлер үшін ойнайтын дәл сол рөл. AiHummer агенті сіздің компанияңыздың
Bitrix24-інде қызметкерлер хабарлама жаза алатын және атап өте алатын әріптес ретінде көрінеді.
Арна өнім-ішілік Маркетплейстен
коннектор ретінде жеткізіледі және хост-туған жұмыс істейді. Ол кез келген басқа арна сияқты
Admin UI-дан конфигурацияланады.
[!WARNING]
Мұндағы Bitrix24 — қатаң түрде ішкі қызметкер IM арнасы. Ол клиенттік
омниарна емес, Bitrix24 Open Lines емес, тикет кезегі емес және
оператор-эскалация беті де емес. Оны сыртқы клиент әңгімелерін
бағыттауға қолданбаңыз.
Адам-тәрізді агент сәйкестігі
Әрбір агент өзінің адам-тәрізді OAuth сәйкестігімен жалғанады, сондықтан ол
Bitrix24-те жалпы интеграция боты емес, жеке адам ретінде көрінеді. Көрінушілік
сіздің ұйым құрылымыңызды бөлім-ағаш ACL арқылы құрметтейді — агент тек
өз сәйкестігіне рұқсат етілген жерде ғана көреді және қатысады, сіздің қызметкерлеріңіз
ұстанатын дәл сол бөлім иерархиясын ұстанады.
Порттар және орындалу ортасы
Коннектор тиянақты порттардың шағын жинағын пайдаланады:
Порт
Мақсаты
8810
Коннектор қызметі (денсаулық және басқару)
8080
Жеткізу соңғы нүктесі (әдепкі)
8791
OAuth келісімі
Хабарламалар қалай ағады
Bitrix24 кіріс оқиғаларды AiHummer-ге итермейді; коннектор оларды тартады.
Кіріс — тарту-сұраушы жаңа хабарламаларды оқиды және оларды шлюзге
/v1/inbound/generic мекенжайында жариялайды.
Шығыс — жауаптар aihummer.connector.v1Deliver келісімі арқылы
жеткізіледі. Агент markdown-ы Bitrix24 BB-кодына түрлендіріледі, ал
жеткізу идемпотентті, сондықтан қайталанған жіберу ешқашан қайталанған
хабарлама тудырмайды.
Не қолдау табады
Арна адам-тәрізді қызметкер сәйкестігіне сай келетін өзара әрекеттесулерді қамтиды:
Реакциялар, хабарламаны өңдеу және жою.
Теру көрсеткіштері.
@-атаулар.
Шығыс хабарламалардағы медиа.
[!WARNING]
Кейбір Telegram-тәрізді мүмкіндіктер адам-тәрізді модельде әдейі
қолдау таппайды:
Интерактивті пернетақталар немесе түймелер жоқ және тармақтар жоқ.
Кіріс медиа мен дауыс бағытталмайды — кіріс тек-мәтін.
Бұл арнада агент ағындарын мәтін-негізді өзара әрекеттесу төңірегінде жоспарлаңыз.
Интерактивті пернетақталар мен сауалнамалар үшін Telegram
немесе MAX қолданыңыз.
Негізгі қабылдау API-ін мынадан қараңыз:
Жалпы кіріс.
**Bitrix24 — ішкі қызметкер лезде-хабар алмасу арнасы** — Telegram немесе Slack
қызметкерлер үшін ойнайтын дәл сол рөл. AiHummer агенті сіздің компанияңыздың
Bitrix24-інде қызметкерлер хабарлама жаза алатын және атап өте алатын әріптес ретінде көрінеді.
Арна **өнім-ішілік [Маркетплейстен](/kk/v1.0/marketplace/overview-tiers)
коннектор ретінде** жеткізіледі және хост-туған жұмыс істейді. Ол кез келген басқа арна сияқты
Admin UI-дан конфигурацияланады.
> [!WARNING]
> Мұндағы Bitrix24 — қатаң түрде **ішкі қызметкер IM арнасы**. Ол клиенттік
> омниарна **емес**, Bitrix24 Open Lines **емес**, тикет кезегі **емес** және
> оператор-эскалация беті де **емес**. Оны сыртқы клиент әңгімелерін
> бағыттауға қолданбаңыз.
## Адам-тәрізді агент сәйкестігі
Әрбір агент өзінің **адам-тәрізді OAuth сәйкестігімен** жалғанады, сондықтан ол
Bitrix24-те жалпы интеграция боты емес, жеке адам ретінде көрінеді. Көрінушілік
сіздің ұйым құрылымыңызды **бөлім-ағаш ACL** арқылы құрметтейді — агент тек
өз сәйкестігіне рұқсат етілген жерде ғана көреді және қатысады, сіздің қызметкерлеріңіз
ұстанатын дәл сол бөлім иерархиясын ұстанады.
## Порттар және орындалу ортасы
Коннектор тиянақты порттардың шағын жинағын пайдаланады:
| Порт | Мақсаты |
|---|---|
| 8810 | Коннектор қызметі (денсаулық және басқару) |
| 8080 | Жеткізу соңғы нүктесі (әдепкі) |
| 8791 | OAuth келісімі |
## Хабарламалар қалай ағады
Bitrix24 кіріс оқиғаларды AiHummer-ге итермейді; коннектор оларды **тартады**.
- **Кіріс** — тарту-сұраушы жаңа хабарламаларды оқиды және оларды шлюзге
`/v1/inbound/generic` мекенжайында жариялайды.
- **Шығыс** — жауаптар `aihummer.connector.v1` **Deliver** келісімі арқылы
жеткізіледі. Агент **markdown-ы Bitrix24 BB-кодына түрлендіріледі**, ал
жеткізу **идемпотентті**, сондықтан қайталанған жіберу ешқашан қайталанған
хабарлама тудырмайды.
## Не қолдау табады
Арна адам-тәрізді қызметкер сәйкестігіне сай келетін өзара әрекеттесулерді қамтиды:
- Реакциялар, хабарламаны **өңдеу** және **жою**.
- **Теру** көрсеткіштері.
- **@-атаулар**.
- Шығыс хабарламалардағы **медиа**.
> [!WARNING]
> Кейбір Telegram-тәрізді мүмкіндіктер адам-тәрізді модельде әдейі
> **қолдау таппайды**:
>
> - **Интерактивті пернетақталар немесе түймелер жоқ** және **тармақтар жоқ**.
> - **Кіріс медиа мен дауыс бағытталмайды** — кіріс **тек-мәтін**.
>
> Бұл арнада агент ағындарын мәтін-негізді өзара әрекеттесу төңірегінде жоспарлаңыз.
## Әрі қарай қайда
- Коннекторларды орнату туралы: [Маркетплейс](/kk/v1.0/marketplace/overview-tiers).
- Интерактивті пернетақталар мен сауалнамалар үшін [Telegram](/kk/v1.0/channels/telegram)
немесе [MAX](/kk/v1.0/channels/max) қолданыңыз.
- Негізгі қабылдау API-ін мынадан қараңыз:
[Жалпы кіріс](/kk/v1.0/channels/generic-inbound).
