Skip to Content
Giriş

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:

  1. Kullanıcı adı ve şifre ile Bearer token almak
  2. 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

ÖzellikDetay
Base URLhttps://public-api.thinkvoice.ai
Auth YöntemiBearer Token
Token ÖmrüAccess token 2 saat (7200 saniye), refresh token 7 gün
Rate LimitGenel: 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 customerPhoneNumber alanı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:

#BilgiAçıklama
1Ortamproduction
2Kullanıcı bilgisiAPI’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 adresleriIP kısıtı açılacaksa sabit IP veya CIDR formatında
4Çağrı tipi filtreleriVarsayılan dışında tipler kullanılacaksa tam adları
5Tarih/saat standardıUTC mi yoksa lokal saat mi kullanılacak
6Beklenen trafik hacmiYü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_token ile 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.000 sınırını dikkate al (/public-calls/get-calls için)
  • Webhook ile gelen callId değerini /public-calls/call ile sorgulayarak çağrının güncel halini alabilirsin
  • voice-agent/start-call ile 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: