Skip to Content
Çağrı GöndermeGenel Bakış

Çağrı Gönderme

Santral veya çağrı merkezi sisteminizdeki çağrıları analiz edilmek üzere ThinkVoice’a iletebilirsiniz. Bu bölümdeki endpoint’ler sizin sisteminizden ThinkVoice’a doğru çalışır; analiz tamamlandığında ThinkVoice’un size bildirim göndermesi için Webhook bölümüne bakın.

Endpoint’ler

EndpointNe işe yarar
POST /api/v1/webhooks/callsBir çağrının bilgilerini gönderir. Çağrı Gönder
POST /api/v1/webhooks/calls/{callId}/audioDaha önce gönderilen çağrının ses kaydını dosya olarak yükler. Ses Kaydı Yükle
POST /api/v1/webhooks/hipcall/callsHipcall santralinin call_hangup bildirimini kabul eder. Hipcall Entegrasyonu

Kimlik Doğrulama

Bu endpoint’ler Bearer token kullanmaz. Entegrasyon sırasında ekibimiz size iki değer iletir:

DeğerAçıklama
API keyEntegrasyonunuzu (santral/sağlayıcı) tanımlar.
API secretVerinin hangi firmaya (tenant) yazılacağını belirler.

Her istekte bu değerleri header olarak gönderin:

X-Api-Key: <API_KEY> X-Api-Secret: <API_SECRET>

Değerler GUID formatındadır. Eksik, hatalı veya devre dışı bırakılmış bir değer gönderilirse istek 401 ile reddedilir. Bu değerleri yalnızca sunucu tarafında saklayın.

Hipcall gibi özel header tanımlanamayan santraller için değerler header yerine URL’deki query string ile iletilir. Ayrıntılar için Hipcall Entegrasyonu sayfasına bakın.

Yanıt Formatı

Başarılı ve başarısız tüm yanıtlar aynı basit yapıdadır:

{ "success": true, "message": "019e925a-5f79-7778-b0be-a45a146cf828 successfully processed" }
AlanTipBoş Olabilir mi?Açıklama
successboolHayırİşlemin başarılı olup olmadığı.
messagestringHayırİşlem sonucunun açıklaması. Başarılı çağrı gönderiminde ThinkVoice'un oluşturduğu çağrı kimliğiyle başlar.

Rate Limit

Bu endpoint’ler için limit 60 saniyede 600 istektir. Aşıldığında 429 döner ve Retry-After header’ı bekleme süresini saniye olarak bildirir. Toplu aktarım yapacaksanız istekleri bu sınırın altında kalacak şekilde yayın.

Ortak Hata Kodları

HTTPAçıklama
400İstek gövdesi hatalı (zorunlu alan eksik, tarih formatı yanlış vb.). message alanında nedeni yazar.
401X-Api-Key / X-Api-Secret eksik, hatalı veya devre dışı.
404Ses kaydı yüklenmek istenen çağrı bulunamadı.
415Ses kaydı dosya tipi desteklenmiyor.
429Rate limit aşıldı.
500Beklenmeyen hata. Bir süre sonra tekrar deneyin; sürerse ekibimize bildirin.
Son güncelleme: