Smart Redirect (Aqlli yo'naltirish)

Smart Redirect — bu kiruvchi qo'ng'iroqni avtomatik ravishda qo'ng'iroqchi bilan oldindan muloqot qilgan operatorga yo'naltiruvchi modul. Tizim qo'ng'iroqchi raqamini qo'ng'iroqlar tarixi yoki CRM tizimidan tekshiradi va tegishli operatorni aniqlaydi.

Misol: Mijoz +998901234567 raqamidan qo'ng'iroq qiladi. Tizim oxirgi marta ushbu mijoz bilan suhbatlashgan operatorni (masalan, 102) aniqlab, chaqiruvni to'g'ridan-to'g'ri unga yo'naltiradi.

Modul diapazoni

Smart Redirect raqamlari 6000 dan 6199 gacha bo'lishi mumkin.

Asosiy tushunchalar

Atama	Izoh
Manbalar (sources)	Operatorni aniqlash uchun tekshiriladigan ma'lumot manbalari
Istisnolar (exceptions)	Bu raqamlar uchun Smart Redirect ishlamasligi kerak (masalan, katta kompaniyalar raqamlari)
Foydalanuvchi yo'naltirishi (allow_user_redirect)	Operator yo'naltirishga ruxsat beriladimi
Kutish vaqti (timeout)	Aniqlangan operatorda necha soniya kutiladi
Standart chiqish (output)	Operator topilmasa yoki javob bermasa yo'naltirish

Manbalar (Sources)

Smart Redirect quyidagi manbalar orqali operatorni topishi mumkin:

1. Qo'ng'iroqlar tarixi (history)

Tizimning o'z qo'ng'iroqlar tarixini tekshiradi — oxirgi marta ushbu raqam bilan suhbatlashgan operator aniqlanadi.

2. AmoCRM (amocrm)

AmoCRM integratsiyasi orqali mijozning lidi/kontakti tekshirilib, unga bog'liq mas'ul operator aniqlanadi.

Maydon	Izoh
select_if_multiple_leads_exists	Bir nechta lid mavjud bo'lganda qaysi biri tanlanadi

select_if_multiple_leads_exists qiymatlari:

• first_lead — Birinchi lid
• last_lead — Oxirgi lid
• contact — Kontaktga bog'liq
• default_user — Standart foydalanuvchi

3. Bitrix24 (bitrix)

Bitrix24 integratsiyasi orqali mijoz aniqlanib, mas'ul xodimga yo'naltiriladi.

4. Tashqi so'rov (request)

Tashqi URL ga HTTP so'rov yuboriladi va javobdagi modul raqamiga yo'naltiriladi.

Maydon	Izoh
url	So'rov yuboriluvchi URL
timeout	So'rov kutish vaqti (soniya, 1–5)

Tashqi so'rov formati

Tizim GET so'rovini yuborib, javobdan modul raqamini oladi. Javob JSON formatida {"extension": "101"} yoki oddiy matn (101) ko'rinishida bo'lishi mumkin.

Istisnolar

exceptions maydoni vergul bilan ajratilgan raqamlar ro'yxati bo'lib, bu raqamlardan kelib tushgan qo'ng'iroqlarda Smart Redirect ishlamaydi. Masalan: "99890,99891".

---

API

Ogohlantirish

Barcha endpointlar Bearer token talab qiladi. Batafsil: Auth

Ro'yxat olish

Endpoint

GET /ats/smart-redirect

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array of SmartRedirectResource	Smart redirect ro'yxati
message	string	Xabar

Example

{
  "status": "success",
  "code": 200,
  "result": [
    {
      "id": 6000,
      "title": "Asosiy smart redirect",
      "exceptions": "99890,99891",
      "sources": {
        "history": { "enabled": true },
        "amocrm": {
          "enabled": true,
          "select_if_multiple_leads_exists": "last_lead"
        },
        "bitrix": { "enabled": false },
        "request": {
          "enabled": false,
          "url": null,
          "timeout": null
        }
      },
      "allow_user_redirect": true,
      "timeout": 30,
      "output": 5400
    }
  ],
  "message": "Ok"
}

---

Yaratish

Endpoint

POST /ats/smart-redirect

Request

Field	Type	Required	Description
id	integer	Yes	Smart redirect raqami (6000–6199, unikal)
title	string	Yes	Nom (max 255 belgi)
exceptions	string|null	No	Istisnolar raqamlari (vergul bilan, max 4095 belgi)
sources.history.enabled	boolean	Yes	Tarix manbai yoqilsinmi
sources.amocrm.enabled	boolean	Yes	AmoCRM manbai yoqilsinmi
sources.amocrm.select_if_multiple_leads_exists	string|null	No*	Bir nechta lid bo'lganda tanlov (first_lead, last_lead, contact, default_user). AmoCRM yoqilgan bo'lsa majburiy
sources.bitrix.enabled	boolean	Yes	Bitrix manbai yoqilsinmi
sources.request.enabled	boolean	Yes	Tashqi so'rov manbai yoqilsinmi
sources.request.url	string|null	No*	Tashqi so'rov URL. Request yoqilgan bo'lsa majburiy
sources.request.timeout	integer|null	No*	So'rov kutish vaqti (1–5 soniya). Request yoqilgan bo'lsa majburiy
allow_user_redirect	boolean	Yes	Foydalanuvchi yo'naltirishga ruxsat
timeout	integer|null	No	Aniqlangan operatorda kutish vaqti (soniya)
output	integer|null	No	Standart chiqish moduli

Example

{
  "id": 6000,
  "title": "Asosiy smart redirect",
  "exceptions": null,
  "sources": {
    "history": { "enabled": true },
    "amocrm": {
      "enabled": true,
      "select_if_multiple_leads_exists": "last_lead"
    },
    "bitrix": { "enabled": false },
    "request": {
      "enabled": false,
      "url": null,
      "timeout": null
    }
  },
  "allow_user_redirect": true,
  "timeout": 30,
  "output": 5400
}

---

Yangilash

Endpoint

PUT /ats/smart-redirect/{id}

Request

Store bilan bir xil maydonlar.

---

O'chirish

Endpoint

DELETE /ats/smart-redirect/{id}

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array	Bo'sh array
message	string	SmartRedirect was successfully deleted.