Skip to Content
WebhookÇağrı Ses Kaydı

Çağrı Ses Kaydı

GET/api/app/public-calls/{id}/record
Çağrının ses kaydını dosya olarak döner. Yalnızca token sahibinin tenant'ına ait çağrıların kaydı indirilebilir.

Bu endpoint’in tam adresini ayrıca oluşturmanız gerekmez. Adres hazır olarak iki yerde döner:

Path Parametreleri

AlanTipZorunluAçıklama
idstring (UUID)EvetÇağrının kimliği. Webhook payload'ındaki veya Çağrı Kayıtları yanıtındaki callId değeridir.

Kimlik Doğrulama

Bu endpoint, Public API’nin diğer endpoint’leriyle aynı Bearer token’ı ister. Token almak için Kimlik Doğrulama sayfasına bakın.

recordUrl bağlantısı tarayıcıda açıldığında 401 döner, çünkü tarayıcı isteğe token eklemez. Kaydı Authorization header’ı ile istemeniz gerekir.

Örnek cURL

curl --request GET 'https://public-api.thinkvoice.ai/api/app/public-calls/019e925a-5f79-7778-b0be-a45a146cf828/record' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--output kayit.wav

Responses

200Başarılı. Gövde ses dosyasının kendisidir.
Content-Type: audio/wav <binary>

WAV formatındaki kayıtlar oynatılabilir PCM WAV formatına çevrilerek audio/wav olarak döner. Sağlayıcıdan WAV dışında bir formatta gelen kayıtlar dönüştürülmeden, sağlayıcının Content-Type değeriyle döner.

400id geçerli bir UUID değil
{ "error": { "code": null, "message": "Doğrulama hatası.", "details": "<hata mesajı>", "validationErrors": [ { "message": "<hata mesajı>", "members": ["id"] } ] } }
401Token geçersiz veya eksik
{ "error": "invalid_token" }
403Kayıt alınamadı veya işlenemedi
{ "error": { "code": null, "message": "Kayıt dosyası alınamadı: <neden>", "details": null, "validationErrors": null } }
404Çağrı bulunamadı
{ "error": { "code": null, "message": "<hata mesajı>", "details": null, "validationErrors": null } }
429Rate limit aşıldı. Limit 60 saniyede 40 istektir.
Retry-After: 60

Hata Durumları

DurumHTTPAçıklama
id geçersiz400id geçerli bir UUID formatında değil.
Token yok veya geçersiz401Bağlantı tarayıcıda açıldığında da bu hata döner.
Kayıt alınamadı403Kayıt sağlayıcıdan alınamadı. message alanı Kayıt dosyası alınamadı: ile başlar ve nedeni içerir.
Ses dosyası işlenemedi403Kayıt alındı ama işlenemedi. message alanı Ses dosyası işlenemedi: ile başlar ve nedeni içerir.
Çağrı bulunamadı404id ile eşleşen bir çağrı yok ya da çağrı başka bir tenant’a ait. Başka tenant’ın çağrısı için kayıt dönmez.
Rate limit aşıldı429Retry-After header’ı bekleme süresini saniye olarak bildirir.

403 yanıtlarındaki message metni kaydın alındığı sağlayıcıya göre değişebilir.

Kayıt indirme istekleri de rate limit’e dahildir.

Son güncelleme: