Bitrix24 — bu ichki xodimlar uchun lahzali xabar almashish kanali — Telegram
yoki Slack xodimlar uchun bajaradigan rolning aynan oʻzi. AiHummer agenti sizning
kompaniyangizning Bitrix24 ichida hamkasb sifatida koʻrinadi, xodimlar unga xabar
yozishi va uni eslatib oʻtishi mumkin.
Kanal ichki mahsulot
Marketplacedan konnektor sifatida
yetkaziladi va host-native ishlaydi. U boshqa har qanday kanal kabi Admin UI
orqali sozlanadi.
[!WARNING]
Bu yerda Bitrix24 — qatʼiy ravishda ichki xodimlar IM kanali. Bu mijozlar
uchun omnikanal emas, Bitrix24 Open Lines emas, tiketlar navbati
emas va operatorga eskalatsiya yuzasi emas. Undan tashqi mijozlar bilan
suhbatlarni yoʻnaltirish uchun foydalanmang.
Insonga oʻxshash agent identifikatori
Har bir agent oʻzining insonga oʻxshash OAuth identifikatori bilan ulanadi,
shuning uchun u Bitrix24da umumiy integratsiya boti emas, balki alohida shaxs
sifatida koʻrinadi. Koʻrinish sizning tashkilot tuzilmangizni boʻlimlar
daraxti ACLsi orqali hisobga oladi — agent faqat oʻz identifikatoriga
ruxsat berilgan joyda koʻradi va ishtirok etadi, xuddi xodimlaringiz kabi aynan
oʻsha boʻlimlar ierarxiyasiga amal qiladi.
Portlar va ish muhiti
Konnektor kichik, qatʼiy belgilangan portlar toʻplamidan foydalanadi:
Port
Maqsadi
8810
Konnektor xizmati (sogʻliq va boshqaruv)
8080
Yetkazib berish endpointi (standart)
8791
OAuth roziligi
Xabarlar qanday harakatlanadi
Bitrix24 kiruvchi hodisalarni AiHummerga yubormaydi; konnektor ularni tortib
oladi.
Kiruvchi — tortib oluvchi poller yangi xabarlarni oʻqiydi va ularni
gateway’ning /v1/inbound/generic manziliga joylaydi.
Chiquvchi — javoblar aihummer.connector.v1Deliver shartnomasi orqali
yetkaziladi. Agentning markdowni Bitrix24 BB-codega oʻtkaziladi va yetkazib
berish idempotent, shuning uchun qayta yuborilgan joʻnatma hech qachon
takroriy xabar hosil qilmaydi.
Nimalar qoʻllab-quvvatlanadi
Kanal insonga oʻxshash xodim identifikatoriga mos keladigan oʻzaro taʼsirlarni
qamrab oladi:
Reaksiyalar, xabarni tahrirlash va oʻchirish.
Yozyapti indikatorlari.
@-eslatmalar.
Chiquvchi xabarlardagi media.
[!WARNING]
Baʼzi Telegram uslubidagi imkoniyatlar insonga oʻxshash modelda ataylab
qoʻllab-quvvatlanmaydi:
Interaktiv klaviaturalar yoki tugmalar yoʻq va threadlar yoʻq.
Kiruvchi media va ovoz yetkazilmaydi — kiruvchi faqat matn.
Bu kanalda agent oqimlarini matnga asoslangan oʻzaro taʼsir atrofida
rejalashtiring.
**Bitrix24 — bu ichki xodimlar uchun lahzali xabar almashish kanali** — Telegram
yoki Slack xodimlar uchun bajaradigan rolning aynan oʻzi. AiHummer agenti sizning
kompaniyangizning Bitrix24 ichida hamkasb sifatida koʻrinadi, xodimlar unga xabar
yozishi va uni eslatib oʻtishi mumkin.
Kanal ichki mahsulot
[Marketplace](/uz/v1.0/marketplace/overview-tiers)dan **konnektor** sifatida
yetkaziladi va host-native ishlaydi. U boshqa har qanday kanal kabi Admin UI
orqali sozlanadi.
> [!WARNING]
> Bu yerda Bitrix24 — qatʼiy ravishda **ichki xodimlar IM kanali**. Bu mijozlar
> uchun omnikanal **emas**, Bitrix24 Open Lines **emas**, tiketlar navbati
> **emas** va operatorga eskalatsiya yuzasi **emas**. Undan tashqi mijozlar bilan
> suhbatlarni yoʻnaltirish uchun foydalanmang.
## Insonga oʻxshash agent identifikatori
Har bir agent oʻzining **insonga oʻxshash OAuth identifikatori** bilan ulanadi,
shuning uchun u Bitrix24da umumiy integratsiya boti emas, balki alohida shaxs
sifatida koʻrinadi. Koʻrinish sizning tashkilot tuzilmangizni **boʻlimlar
daraxti ACL**si orqali hisobga oladi — agent faqat oʻz identifikatoriga
ruxsat berilgan joyda koʻradi va ishtirok etadi, xuddi xodimlaringiz kabi aynan
oʻsha boʻlimlar ierarxiyasiga amal qiladi.
## Portlar va ish muhiti
Konnektor kichik, qatʼiy belgilangan portlar toʻplamidan foydalanadi:
| Port | Maqsadi |
|---|---|
| 8810 | Konnektor xizmati (sogʻliq va boshqaruv) |
| 8080 | Yetkazib berish endpointi (standart) |
| 8791 | OAuth roziligi |
## Xabarlar qanday harakatlanadi
Bitrix24 kiruvchi hodisalarni AiHummerga yubormaydi; konnektor ularni **tortib
oladi**.
- **Kiruvchi** — tortib oluvchi poller yangi xabarlarni oʻqiydi va ularni
gateway’ning `/v1/inbound/generic` manziliga joylaydi.
- **Chiquvchi** — javoblar `aihummer.connector.v1` **Deliver** shartnomasi orqali
yetkaziladi. Agentning **markdowni Bitrix24 BB-codega oʻtkaziladi** va yetkazib
berish **idempotent**, shuning uchun qayta yuborilgan joʻnatma hech qachon
takroriy xabar hosil qilmaydi.
## Nimalar qoʻllab-quvvatlanadi
Kanal insonga oʻxshash xodim identifikatoriga mos keladigan oʻzaro taʼsirlarni
qamrab oladi:
- Reaksiyalar, xabarni **tahrirlash** va **oʻchirish**.
- **Yozyapti** indikatorlari.
- **@-eslatmalar**.
- Chiquvchi xabarlardagi **media**.
> [!WARNING]
> Baʼzi Telegram uslubidagi imkoniyatlar insonga oʻxshash modelda ataylab
> **qoʻllab-quvvatlanmaydi**:
>
> - **Interaktiv klaviaturalar yoki tugmalar yoʻq** va **threadlar yoʻq**.
> - **Kiruvchi media va ovoz yetkazilmaydi** — kiruvchi **faqat matn**.
>
> Bu kanalda agent oqimlarini matnga asoslangan oʻzaro taʼsir atrofida
> rejalashtiring.
## Keyingi qadam
- Konnektorlarni oʻrnatish boʻyicha: [Marketplace](/uz/v1.0/marketplace/overview-tiers).
- Interaktiv klaviaturalar va soʻrovnomalar uchun [Telegram](/uz/v1.0/channels/telegram)
yoki [MAX](/uz/v1.0/channels/max)dan foydalaning.
- Asosiy qabul qilish API’sini koʻring:
[Generic inbound](/uz/v1.0/channels/generic-inbound).
