Ç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
| Endpoint | Ne işe yarar |
|---|---|
POST /api/v1/webhooks/calls | Bir çağrının bilgilerini gönderir. Çağrı Gönder |
POST /api/v1/webhooks/calls/{callId}/audio | Daha önce gönderilen çağrının ses kaydını dosya olarak yükler. Ses Kaydı Yükle |
POST /api/v1/webhooks/hipcall/calls | Hipcall 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ğer | Açıklama |
|---|---|
API key | Entegrasyonunuzu (santral/sağlayıcı) tanımlar. |
API secret | Verinin 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"
}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ı
| HTTP | Açıklama |
|---|---|
400 | İstek gövdesi hatalı (zorunlu alan eksik, tarih formatı yanlış vb.). message alanında nedeni yazar. |
401 | X-Api-Key / X-Api-Secret eksik, hatalı veya devre dışı. |
404 | Ses kaydı yüklenmek istenen çağrı bulunamadı. |
415 | Ses kaydı dosya tipi desteklenmiyor. |
429 | Rate limit aşıldı. |
500 | Beklenmeyen hata. Bir süre sonra tekrar deneyin; sürerse ekibimize bildirin. |