ThinkVoice Public API

ThinkVoice Public API'sine hoş geldiniz.

ThinkVoice Public API, dış sistemlerin ThinkVoice üzerindeki çağrı kayıtlarını sorgulamasını ve sesli asistan çağrılarını yönetmesini 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ı Arama — Analiz edilmiş çağrı kayıtlarını sorgular
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

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ü	7 gün (604800 saniye)
Rate Limit	60 istek / 60 saniye
Veri Kaynağı	Elasticsearch (tenant bazlı indeksler)

Güvenlik

Yalnızca yetkili kullanıcılar erişebilir
Opsiyonel IP kısıtı uygulanabilir
Hassas veriler ([MASKED]) olarak döner — telefon, e-posta, TCKN maskelenir
Telefon numarası bilgisi hiçbir zaman düz metin olarak dönmez

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
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

Pratik Öneriler

İlk testleri cURL ile yap
Önce token al, sonra aynı token ile endpoint'leri sırayla test et
Derin sayfalama gerekiyorsa skip + take ≤ 10.000 sınırını dikkate al (/public-calls/get-calls için)
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

Hızlı Başlangıç