Hızlı Başlangıç

Entegrasyon Akışı

Base URL'yi belirle

Production ortamı için:

https://public-api.thinkvoice.ai

Test, preprod veya on-prem ortamlar için base URL ekip tarafından ayrıca paylaşılır.

Token al

POST/api/public/auth/token

Kullanıcı adı ve şifre ile Bearer token alır.

curl --request POST 'https://public-api.thinkvoice.ai/api/public/auth/token' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "username": "[email protected]",
    "password": "Sifreniz"
  }'

Yanıttaki access_token değerini kaydet.

Tüm korumalı isteklerde token kullan

Aşağıdaki üç endpoint dahil tüm korumalı isteklerde şu header'ı kullan:

Authorization: Bearer <access_token>

Çağrı kayıtlarını sorgula

POST/api/app/public-calls/get-calls

Tenant'a ait analiz edilmiş çağrı kayıtlarını sorgular.

Tarih aralığı, çağrı tipi ve sayfalama parametrelerini ihtiyaca göre ayarla. Detaylar için Çağrı Arama sayfasına bak.

Sesli asistan çağrısı başlat

POST/api/app/voice-agent/start-call

Sesli asistan çağrısı başlatır. Token sahibinin tenant'ına ait bir voice agent oturumu açar ve aramayı başlatır.

assistantId, phoneNumberId ve customerNumber alanlarını doldurarak çağrı başlat. Detaylar için Sesli Asistan sayfasına bak.

Çağrı kayıtlarını listele

POST/api/app/voice-agent/call-log

Sesli asistan çağrı kayıtlarını sorgular.

Tarih aralığı, telefon numarası, call_id, durum ve limit ile filtrele. Detaylar için Çağrı Kayıtları sayfasına bak.

Hataları yönet

İstemci tarafında 401, 403 ve 429 durumlarını yakala ve yönet. Detaylar için Hata Kodları sayfasına bak.

Ortam Bilgisi

Ortam	Base URL
Production	`https://public-api.thinkvoice.ai`

Pratik Öneriler

İlk testleri cURL ile yap
Önce token al, sonra aynı token ile endpointleri 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

Giriş Token Alma & Yenileme