Bitrix24 integratsiyasi
Bitrix24 integratsiyasi orqali Utel tizimi va Bitrix24 CRM o'rtasida qo'ng'iroqlar avtomatik sinxronlashtiriladi. Kiruvchi va chiquvchi qo'ng'iroqlar Bitrix24 da avtomatik qayd etiladi, mijozlar aniqlanadi va telefon qilish Bitrix24 interfeysidan amalga oshirilishi mumkin.
Imkoniyatlar
- Kiruvchi/chiquvchi qo'ng'iroqlar Bitrix24 da avtomatik qayd etiladi
- Bitrix24 dan to'g'ridan-to'g'ri qo'ng'iroq amalga oshirish (Originate)
- Qo'ng'iroq yozuvini Bitrix24 ga yuklash
- Foydalanuvchilarni Bitrix24 xodimlari bilan bog'lash (bind)
- Smart Redirect uchun Bitrix24 orqali mas'ul operator aniqlash
Ulanish
Bitrix24 integratsiyasi OAuth 2.0 orqali amalga oshiriladi.
API
Ogohlantirish
Barcha endpointlar Bearer token talab qiladi. Batafsil: Auth
Integratsiya holati
Endpoint
GET /integration/bitrix/info
Bitrix24 integratsiyasining joriy holati va ulangan domain haqida ma'lumot qaytaradi.
Response
| Field | Type | Description |
|---|---|---|
status | string | success yoki error |
code | int | HTTP status kodi |
result.enabled | boolean | Integratsiya yoqilganmi |
result.domain | string | null | Bitrix24 domain manzili |
Example
{
"status": "success",
"code": 200,
"result": {
"enabled": true,
"domain": "https://mycompany.bitrix24.uz"
},
"message": "Ok"
}OAuth uchun URL olish
Endpoint
POST /integration/bitrix/oauth/credentials
Bitrix24 bilan OAuth ulanish uchun avtorizatsiya URL ini qaytaradi. Foydalanuvchi ushbu URL ga o'tib, ilovaga ruxsat beradi.
Request
| Field | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Bitrix24 portal domain (masalan: https://mycompany.bitrix24.uz) |
Example
{
"domain": "https://mycompany.bitrix24.uz"
}Response
| Field | Type | Description |
|---|---|---|
result.auth_url | string | Foydalanuvchi o'tishi kerak bo'lgan OAuth URL |
OAuth — ulanish
Endpoint
POST /integration/bitrix/oauth
Bitrix24 tomonidan qaytarilgan code orqali OAuth jarayonini yakunlaydi va tokenni saqlaydi.
Request
| Field | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Bitrix24 portal domain |
code | string | Yes | Bitrix24 tomonidan berilgan OAuth kodi |
Example
{
"domain": "https://mycompany.bitrix24.uz",
"code": "abcdef123456"
}Ulanishni uzish
Endpoint
DELETE /integration/bitrix/disconnect
Bitrix24 bilan ulanishni uzib, barcha tokenlarni o'chiradi.
Response
| Field | Type | Description |
|---|---|---|
message | string | Successfully disconnected from Bitrix24 |
Sozlamalarni olish
Endpoint
GET /integration/bitrix/settings
Bitrix24 integratsiya sozlamalarini qaytaradi (pipeline va foydalanuvchi ulanishlar).
Sozlamalarni saqlash
Endpoint
POST /integration/bitrix/settings
Bitrix24 integratsiya sozlamalarini yangilaydi.
Bitrix24 foydalanuvchilarini olish
Endpoint
GET /integration/bitrix/bitrix-users
Bitrix24 portalidagi aktiv xodimlar ro'yxatini qaytaradi. Utel foydalanuvchilari bilan bog'lash uchun ishlatiladi.
Response
| Field | Type | Description |
|---|---|---|
result | array | Bitrix24 xodimlari ro'yxati |
result[*].id | int | Bitrix24 foydalanuvchi ID |
result[*].name | string | Xodim to'liq ismi |
result[*].email | string | Email manzili |
Qo'ng'iroq boshlash (Originate)
Endpoint
POST /integration/bitrix/originate
Bitrix24 interfeysidan to'g'ridan-to'g'ri qo'ng'iroq boshlash uchun. Bitrix24 tomonidan chaqiriladi.
WARNING
Ushbu endpoint auth:sanctum middleware dan ozod qilingan — Bitrix24 so'rovlarini qabul qiladi.
Request
| Field | Type | Required | Description |
|---|---|---|---|
sip_phone | string | Yes | SIP telefon raqami (operator moduli) |
phone_number | string | Yes | Terilishi kerak bo'lgan tashqi telefon raqam |