O'z tizimingizga ulash
Odoo ishlatmasangiz — qo'ng'iroqlar sizning serveringizga hodisa sifatida yuboriladi yoki API orqali o'qiladi.
Hodisalar
Qo'ng'iroq holati o'zgarganda serveringizga HTTP so'rov keladi.
| Hodisa | Qachon | Qayta urinish |
|---|---|---|
| call.started | Qo'ng'iroq boshlandi | yo'q |
| call.answered | Ko'tarildi | yo'q |
| call.ended | Tugadi | yo'q |
| call.finished | Yakuniy ma'lumot bilan saqlandi | bor |
| recording.ready | Audio yozuv tayyor | bor |
«Qayta urinish» bor hodisalar javob kelmasa takrorlanadi. Serveringiz 2xx qaytarsa yetkazilgan hisoblanadi.
Payload
Asosiy maydonlar quyida. `recording.ready` da qo'shimcha `recording.url` bo'ladi — audio faylga muddatli havola.
{
"event": "call.finished",
"event_time": "2026-08-06T09:14:52+00:00",
"call": {
"uid": "a3f1c8e2-...",
"direction": "outgoing",
"number": "+998901234567",
"user_email": "sardor@example.com",
"start_time": "2026-08-06T09:14:02+00:00",
"duration": 43,
"status": "answered"
}
}Imzo
Har so'rov HMAC-SHA256 bilan imzolanadi. Serveringiz imzoni tekshirib, so'rov bizdan kelganiga ishonch hosil qiladi.
digest = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
valid = hmac.compare_digest(f"sha256={digest}", signature)| X-LC-Signature | sha256=<hex> — tananing imzosi |
| X-LC-Event | Hodisa nomi |
| X-LC-Event-Id | Takrorni tashlash uchun yagona ID |
API
Obunalarni kod orqali boshqarish va xodimlar ro'yxatini olish uchun. Kalit kabinet sozlamalaridan olinadi.
| Metod | Manzil | Nima qiladi |
|---|---|---|
| GET | /api/v1/webhooks | Obunalar ro'yxati |
| POST | /api/v1/webhooks | Obuna yaratish |
| DELETE | /api/v1/webhooks/{id} | Obunani o'chirish |
| GET | /api/v1/operators | Xodimlar ro'yxati (email va ism) |
curl -X POST https://api.calltracer.uz/api/v1/webhooks \
-H "X-API-Key: <sizning_api_kalitingiz>" \
-H "Content-Type: application/json" \
-d '{"event":"*","url":"https://sizning-serveringiz.uz/hook","secret":"<secret>"}'To'liq hujjat
Bu yerda integratsiya boshlash uchun yetarli minimum berilgan. To'liq maydonlar ro'yxati, xato kodlari va namunalar ro'yxatdan o'tgach kabinetda ochiladi.
API shakli MoiZvonki formatiga yaqin — o'sha xizmatdan ko'chayotgan bo'lsangiz integratsiyani noldan yozish shart emas.
Qo'ng'iroqlaringizni bugun nazoratga oling
Bir necha daqiqada o'rnating.