CallHub24 API — v1

Bu API orqali, o'z tizimingizga qo'ng'iroqlar ma'lumotini, audio yozuvlarni, statistikani avtomatik olishingiz va tashqi tizimingizdan (masalan, 1C) SMS yuborishingiz mumkin.

📘 Bu sahifa — qisqa umumiy ko'rinish. Har bir endpoint uchun to'liq parametrlar, barcha xato holatlari, va JavaScript/Python/cURL'da tayyor kod namunalari uchun:
To'liq API hujjati (API_DOCUMENTATION.md)

Autentifikatsiya

Har bir so'rovda, Admin panel → Sozlamalar → API bo'limida yaratgan kalitingizni quyidagicha yuboring:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

Qo'ng'iroqlar ro'yxati

GET https://app.callhub24.uz/api/v1/calls

Ixtiyoriy filtrlar (URL parametr sifatida):

Parametr	Tavsif
`date_from`	Boshlanish sanasi (ISO format)
`date_to`	Tugash sanasi
`employee_id`	Faqat shu xodimning qo'ng'iroqlari
`call_type`	`incoming` / `outgoing` / `missed`

Audio yozuvni yuklab olish

GET https://app.callhub24.uz/api/v1/calls/{id}/audio

Xodimlar ro'yxati

GET https://app.callhub24.uz/api/v1/employees

Statistika

GET https://app.callhub24.uz/api/v1/stats?date_from=...&date_to=...

SMS yuborish

Tashqi tizimingizdan (masalan, 1C), qarzdor yoki boshqa mijozlarga, avtomatik SMS yuborish uchun.

POST https://app.callhub24.uz/api/v1/sms/send
Content-Type: application/json

{
  "phone": "+998901234567",
  "message": "Hurmatli mijoz, qarzingiz muddati o'tdi..."
}

SMS DARHOL emas — navbatga qo'yiladi, va Admin panel → Sozlamalar → API bo'limida siz belgilagan xodim (yoki, "aylanma tartib" tanlangan bo'lsa, navbatdagi faol xodim) qurilmasi, navbatni tekshirib, o'z SIM kartasidan yuboradi.

Maydon	Tavsif
`phone`	Qabul qiluvchi telefon raqami
`message`	SMS matni

Cheklovlar

Daqiqasiga maksimal 60 ta so'rov
SMS yuborish: bitta telefon raqamiga, oxirgi SMS'dan keyin 60 soniya o'tmaguncha, YANGI SMS navbatga qo'yilmaydi (429 DUPLICATE_PHONE)
Haqiqiy yetkazish tezligi, xodim(lar) SIM kartasining spam-himoyasiga bog'liq — har bir xodim, kamida 45 soniyada bittadan SMS yubora oladi. Katta hajmda ("aylanma tartib" rejimida), bu yuklama FAOL xodimlar orasida taqsimlanadi

Yordam

Savollar bo'lsa: Telegram orqali yozing