Voicemail (Ovozli xabar)

Voicemail — bu foydalanuvchi javob bermagan yoki ish vaqtidan tashqarida bo'lganda mijozdan ovozli xabar qoldirishiga imkon beruvchi modul. Yozilgan ovozli xabarlar tizimda saqlanadi va keyinchalik tinglash mumkin.

Misol: Mijoz kechqurun qo'ng'iroq qiladi, operator javob berish imkoniyatiga ega bo'lmaydi — mijoz "Xabar qoldiring" degan audio eshitadi va xabarini yozib qoldiradi.

Modul diapazoni

Voicemail raqamlari 5800 dan 5999 gacha bo'lishi mumkin.

Asosiy tushunchalar

Atama	Izoh
Kirish audiosi (started_audio)	Yozishdan oldin eshitiladigan audio: "Xabar qoldiring"
Chiqish audiosi (finished_audio)	Yozish tugagach eshitiladigan audio: "Xabaringiz saqlandi"
Maksimal davomiylik (max_duration)	Xabarning maksimal uzunligi (soniya). 0 — cheklovsiz
Sukut kechikishi (max_silence)	Necha soniya sukutdan keyin yozish tugaydi. 0 — avtomatik to'xtamaslik
Signal tovushi (beep)	Yozish boshlanishidan oldin "beep" tovush chalinadimi

---

API

Ogohlantirish

Barcha endpointlar Bearer token talab qiladi. Batafsil: Auth

Ro'yxat olish

Endpoint

GET /ats/voicemail

Response

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

Example

{
  "status": "success",
  "code": 200,
  "result": [
    {
      "id": 5800,
      "title": "Asosiy voicemail",
      "started_audio": "https://api.cc999.utel.uz/storage/voicemail/abc_start.mp3",
      "started_audio_filename": "start.mp3",
      "finished_audio": null,
      "finished_audio_filename": null,
      "max_duration": 60,
      "max_silence": 5,
      "beep": true
    }
  ],
  "message": "Ok"
}

---

Yaratish

Endpoint

POST /ats/voicemail

Muhim

Ushbu endpoint multipart/form-data formatida yuborilishi kerak (audio fayllar uchun).

Request

Field	Type	Required	Description
id	integer	Yes	Voicemail raqami (5800–5999, unikal)
title	string|null	No	Voicemail nomi (max 255 belgi)
started_audio	file|null	No	Kirish audio fayli (mp3, wav, ogg; max 20 MB)
finished_audio	file|null	No	Chiqish audio fayli (mp3, wav, ogg; max 20 MB)
max_duration	integer	Yes	Maksimal davomiylik (soniya, min: 0)
max_silence	integer	Yes	Sukut kechikishi (soniya, min: 0)
beep	boolean	Yes	Beep tovushi

---

Yangilash

Endpoint

PUT /ats/voicemail/{id}

Request

Field	Type	Required	Description
title	string|null	No	Voicemail nomi
max_duration	integer	Yes	Maksimal davomiylik (soniya, min: 0)
max_silence	integer	Yes	Sukut kechikishi (soniya, min: 0)
beep	boolean	Yes	Beep tovushi

Developer notes:

Audio fayllarni alohida endpointi orqali yangilash tavsiya etiladi: POST /ats/voicemail/{id}/audios

---

Audio fayllarni yangilash

Endpoint

POST /ats/voicemail/{id}/audios

Muhim

Ushbu endpoint multipart/form-data formatida yuborilishi kerak.

Request

Field	Type	Required	Description
started_audio	file|null	No	Kirish audio fayli (mp3, wav, ogg; max 20 MB)
finished_audio	file|null	No	Chiqish audio fayli (mp3, wav, ogg; max 20 MB)

TIP

Faqat yangilamoqchi bo'lgan audio faylni yuborish kifoya. Ikkalasini yoki bittasini alohida yangilash mumkin.

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	VoicemailResource	Yangilangan voicemail

---

O'chirish

Endpoint

DELETE /ats/voicemail/{id}

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array	Bo'sh array
message	string	Voicemail {id} deleted