ThinkVoice Public API
ThinkVoice Public API’sine hoş geldiniz.
ThinkVoice Public API, dış sistemlerin ThinkVoice üzerindeki çağrı kayıtlarını sorgulamasını, çağrı ses kayıtlarını indirmesini, sesli asistan çağrılarını yönetmesini ve yazılı kanal konuşmalarını ThinkVoice’a göndermesini güvenli şekilde sağlar.
Genel Yapı
API kullanım akışı 2 temel adımdan oluşur:
- Kullanıcı adı ve şifre ile Bearer token almak
- Alınan token ile ilgili endpoint’i çağırmak
Mevcut endpoint’ler:
- Çağrı Kayıtları — Analiz edilmiş çağrı kayıtlarını sorgular
- Çağrı Detayı — Tek bir çağrının tüm bilgilerini getirir
- Çağrı Ses Kaydı — Bir çağrının ses kaydını indirir
- Sesli Asistan Çağrısı Başlat — Voice agent üzerinden yeni bir çağrı başlatır
- Çağrı Kayıtları — Sesli asistan çağrı geçmişini listeler
- Çağrı Gönderme — Santralinizdeki çağrıyı ses kaydıyla birlikte analiz için ThinkVoice’a iletir
- Yazılı Kanallar — Canlı destek gibi yazılı kanallardaki konuşmayı mesajlarıyla birlikte analiz için ThinkVoice’a iletir
ThinkVoice de sizin sisteminize bilgi verebilir: çağrı analizi bittiğinde tanımladığınız adrese otomatik bildirim gönderir. Ayrıntılar için Webhook bölümüne bakın.
Tenant seçimi header ile yapılmaz. Kullanıcı hangi firmaya bağlıysa yalnızca o tenant’ın verileri görünür.
Temel Özellikler
| Özellik | Detay |
|---|---|
| Base URL | https://public-api.thinkvoice.ai |
| Auth Yöntemi | Bearer Token |
| Token Ömrü | Access token 2 saat (7200 saniye), refresh token 7 gün |
| Rate Limit | Genel: 40 istek / 60 saniye · Token alma: 5 istek / 60 saniye · Çağrı Gönderme ve Yazılı Kanallar: 600 istek / 60 saniye |
| Veri Kaynağı | Elasticsearch (tenant bazlı indeksler) |
Güvenlik
- Yalnızca Public API yetkisi tanımlanmış kullanıcılar token alabilir
- Opsiyonel IP kısıtı uygulanabilir
- Çağrı başlığı ve özetindeki hassas veriler
[MASKED]olarak döner — telefon, e-posta, TCKN maskelenir - Müşteri telefon numarası yalnızca
customerPhoneNumberalanında döner; metin alanlarında düz yazı olarak yer almaz
Entegrasyon Başlamadan Önce
Entegrasyona başlamadan önce aşağıdaki bilgileri ekibimizle paylaşman gerekir:
| # | Bilgi | Açıklama |
|---|---|---|
| 1 | Ortam | production |
| 2 | Kullanıcı bilgisi | API’yi kullanacak kullanıcının e-posta ve şifresi (kullanıcıya Public API yetkisi tarafımızdan tanımlanır) |
| 3 | Çıkış IP adresleri | IP kısıtı açılacaksa sabit IP veya CIDR formatında |
| 4 | Çağrı tipi filtreleri | Varsayılan dışında tipler kullanılacaksa tam adları |
| 5 | Tarih/saat standardı | UTC mi yoksa lokal saat mi kullanılacak |
| 6 | Beklenen trafik hacmi | Yüksek hacimde rate limit gözden geçirilebilir |
| 7 | Çağrı gönderme (santral entegrasyonu) | Santralinizden çağrı göndereceksek size X-Api-Key ve X-Api-Secret değerleri iletilir |
Pratik Öneriler
- İlk testleri cURL ile yap
- Önce token al, sonra aynı token ile endpoint’leri sırayla test et
- Token 2 saat geçerlidir;
refresh_tokenile yenileyip her istekte yeniden giriş yapmaktan kaçın (token alma ucu dakikada 5 istekle sınırlıdır) - Derin sayfalama gerekiyorsa
skip + take ≤ 10.000sınırını dikkate al (/public-calls/get-callsiçin) - Webhook ile gelen
callIddeğerini/public-calls/callile sorgulayarak çağrının güncel halini alabilirsin voice-agent/start-callile başlattığın çağrılarıvoice-agent/call-logüzerinden takip edebilirsin- Dönüt özet metinlerini ham veri olarak kabul etme — hassas alanlar maskelenir
Son güncelleme: