Çağrı Arama

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

Tenant'a ait analiz edilmiş çağrı kayıtlarını sorgular. Yalnızca token sahibinin tenant'ına ait veriler döner.

Request Body

{
  "startTime": "2026-04-01T00:00:00",
  "endTime": "2026-04-10T23:59:59",
  "skip": 0,
  "take": 20,
  "sortColumn": "start_time_dt",
  "isAscending": false,
  "issueTypeNames": ["Şikayet", "Teknik Sorun"],
  "hasNewRequest": true,
  "direction": 1,
  "results": [1],
  "includeAnalysis": false
}

Parametreler

Alan	Tip	Zorunlu	Açıklama
`startTime`	datetime	Evet	Başlangıç tarihi (dahil). ISO 8601 formatında gönderilmeli.
`endTime`	datetime	Evet	Bitiş tarihi (dahil). ISO 8601 formatında gönderilmeli.
`skip`	int	Hayır	Atlanan kayıt sayısı. Sayfalama için kullanılır. Varsayılan: 0. Negatif değer gönderilirse hata döner.
`take`	int	Hayır	Dönen kayıt sayısı. Boş veya 0 ise varsayılan 20 kullanılır. İzin verilen üst sınır includeAnalysis değerine bağlıdır: false ise 500, true ise 100. Bu sınır aşılırsa istek 400 doğrulama hatası ile reddedilir (sessizce düşürülmez).
`sortColumn`	string	Hayır	Sıralama alanı. Gönderilmezse başlangıç tarihine göre azalan sıralanır.
`isAscending`	bool	Hayır	true artan, false azalan sıralama. Varsayılan: false.
`issueTypeNames`	array	Hayır	Çağrı tipi filtresi. Gönderildiğinde yalnızca belirtilen çağrı tiplerine ait kayıtlar döner. Boş bırakılırsa çağrı tipi filtresi uygulanmaz ve tüm çağrı tipleri listelenir. Tanımsız değer gönderilirse hata döner.
`hasNewRequest`	bool	Hayır	Yeni talep içeren çağrıları filtreler. true gönderilirse yalnızca newRequestInfo alanı dolu olan kayıtlar döner, false gönderilirse yalnızca dolu olmayanlar döner. Gönderilmezse (null) filtre uygulanmaz.
`direction`	int	Hayır	Çağrı yönü filtresi. 0 = Gelen, 1 = Giden. Gönderilmezse her iki yön de listelenir.
`results`	array	Hayır	Çağrı sonucu filtresi (IN). Değerler: 1 = Cevaplandı, 2 = Meşgule Atıldı, 3 = Meşgul, 4 = Belirsiz, 5 = Kaçırıldı. Alan hiç gönderilmezse varsayılan olarak yalnızca Cevaplandı (1) sonuçlar döner. Açıkça null gönderilirse sonuç filtresi uygulanmaz.
`includeAnalysis`	bool	Hayır	true ise her kayıtta genişletilmiş analiz alanları (analysis) doldurulur ve maksimum take 100 ile sınırlanır. false (varsayılan) ise analysis boş döner ve maksimum take 500'e kadar çıkabilir.

⚠️

skip + take toplamı 10.000'i geçemez. Aşılırsa sistem sayfa boyutunu otomatik düşürür.

issueTypeNames değerleri sistemdeki çağrı tipi kataloğundaki Value veya Description alanlarıyla eşleşir. Tanımsız bir değer gönderilirse hata döner.

results alanı ile varsayılan davranış farklıdır: alan isteğe hiç eklenmezse yalnızca Cevaplandı durumundaki çağrılar döner. Tüm sonuçları görmek için "results": null göndermek gerekir.

Doğrulama Hataları

Aşağıdaki durumlarda 400 Bad Request ve ABP standart doğrulama hatası formatı döner:

İstek gövdesi boşsa (request null)
startTime, endTime'dan büyükse
skip negatifse
take, uygulanan üst sınırı (includeAnalysis: false → 500, true → 100) aşıyorsa

400Doğrulama hatası

{
  "error": {
    "code": null,
    "message": "Doğrulama hatası.",
    "details": null,
    "validationErrors": [
      {
        "message": "Başlangıç tarihi, bitiş tarihinden büyük olamaz.",
        "members": ["startTime", "endTime"]
      }
    ]
  }
}

Tarih ve Saat Davranışı

⚠️

Dönen callDate değeri kullanıcının zaman dilimi ayarına göre dönüştürülmüş olabilir. Entegrasyon ekibi tarihleri gönderirken tek bir standart belirlemelidir.

Öneri	Açıklama
ISO 8601	Tüm tarihleri `2026-04-01T00:00:00` formatında gönder
Timezone standardı	Ekip içinde UTC mi yoksa `Europe/Istanbul` mu kullanılacağını netleştir

Örnek cURL

curl --request POST 'https://public-api.thinkvoice.ai/api/app/public-calls/get-calls' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'   --header 'Content-Type: application/json'   --data-raw '{
    "startTime": "2026-04-01T00:00:00",
    "endTime": "2026-04-10T23:59:59",
    "skip": 0,
    "take": 20,
    "isAscending": false,
    "issueTypeNames": ["Şikayet", "Teknik Sorun"],
    "hasNewRequest": true,
    "direction": 1,
    "results": [1],
    "includeAnalysis": false
  }'

Responses

200Başarılı

{
  "items": [
    {
      "callId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "customerId": "11111111-2222-3333-4444-555555555555",
      "callDate": "2026-04-10T14:35:12",
      "queueName": "Musteri Hizmetleri",
      "topic": "Odeme",
      "subTopic": "Iade > Gecikme",
      "resolutionStatus": "Cozuldu",
      "title": "Iade sureciyle ilgili sikayet",
      "summary": "Musteri, [MASKED] numarasi icin iade surecinin geciktigini belirtti.",
      "callIssueType": "Şikayet",
      "newRequestInfo": "Müşteri, iade sürecinin durumunu uygulama üzerinden takip edebilmek için yeni bir özellik talep etti.",
      "direction": 1,
      "directionName": "Giden",
      "resultId": 1,
      "resultName": "Cevaplandı",
      "hangupDirectionId": 1,
      "hangupDirectionName": "Müşteri",
      "endTime": "2026-04-10T14:41:47",
      "answerTime": "2026-04-10T14:35:20",
      "callDurationSeconds": 387.5,
      "queueWaitSeconds": 12,
      "personnelId": "22222222-3333-4444-5555-666666666666",
      "personnelName": "Ayşe Yılmaz",
      "agentId": "agent-42",
      "agentName": "İade Botu",
      "analysis": [],
      "metadata": null
    }
  ],
  "totalResultCount": 153,
  "totalPageCount": 8,
  "sortableColumns": []
}

Yukarıdaki örnekte includeAnalysis: false gönderildiği için analysis boş dizi döner. includeAnalysis: true gönderilirse her öğe { key, friendlyName, value } biçiminde analiz parametreleriyle doldurulur, örneğin: [{ "key": "musteri_memnuniyeti", "friendlyName": "Müşteri Memnuniyeti", "value": "Olumlu" }].

401Token geçersiz veya eksik

{ "error": "invalid_token" }

429Rate limit aşıldı — 60 istek / 60 saniye

Retry-After: 60

Yanıt Alanları

Alan	Tip	Zorunlu	Açıklama
`callId`	string	Hayır	Çağrının sistemdeki benzersiz kimliği.
`customerId`	string	Hayır	Müşterinin sistemdeki benzersiz kimliği.
`callDate`	datetime	Hayır	Çağrı tarihi. Kullanıcının timezone ayarına göre dönüştürülmüş olabilir.
`queueName`	string	Hayır	Çağrının ait olduğu kuyruk.
`topic`	string	Hayır	Ana konu.
`subTopic`	string	Hayır	Alt konu zinciri.
`resolutionStatus`	string	Hayır	Çözüm durumunun metinsel karşılığı.
`title`	string	Hayır	Çağrı başlığı. Hassas veriler maskelenir.
`summary`	string	Hayır	Özet metni. Telefon, e-posta, TCKN gibi veriler [MASKED] olarak döner.
`callIssueType`	string	Hayır	Çağrı tipi.
`newRequestInfo`	string	Hayır	Yeni talep veya özellik isteği bilgisi. Yoksa null döner.
`direction`	int	Hayır	Çağrı yönü. 0 = Gelen, 1 = Giden.
`directionName`	string	Hayır	Çağrı yönünün metinsel karşılığı. Örn: "Gelen", "Giden".
`resultId`	int	Hayır	Çağrı sonucu id'si. 1 = Cevaplandı, 2 = Meşgule Atıldı, 3 = Meşgul, 4 = Belirsiz, 5 = Kaçırıldı.
`resultName`	string	Hayır	Çağrı sonucunun metinsel karşılığı.
`hangupDirectionId`	int	Hayır	Çağrıyı kim kapattı bilgisinin id'si.
`hangupDirectionName`	string	Hayır	Kapanış yönünün metinsel karşılığı.
`endTime`	datetime	Hayır	Çağrının bitiş zamanı. Yoksa null döner.
`answerTime`	datetime	Hayır	Çağrının cevaplanma zamanı. Cevaplanmadıysa null döner.
`callDurationSeconds`	double	Hayır	Çağrı süresi (saniye). Yoksa null döner.
`queueWaitSeconds`	int	Hayır	Kuyrukta bekleme süresi (saniye).
`personnelId`	string	Hayır	Çağrıyla ilgilenen personelin kimliği. Yoksa null döner.
`personnelName`	string	Hayır	Çağrıyla ilgilenen personelin adı.
`agentId`	string	Hayır	Çağrıyı işleyen yapay zeka ajanının kimliği. Yoksa null döner.
`agentName`	string	Hayır	Çağrıyı işleyen yapay zeka ajanının adı.
`analysis`	array	Hayır	Genişletilmiş analiz parametreleri. İstek gövdesinde includeAnalysis: true gönderilmediği sürece boş dizi döner. Doluysa her öğe { key (snake_case), friendlyName (etiket), value (değer) } biçimindedir.
`metadata`	object	Hayır	Çağrıyı başlatan Çağrı Başlat isteğiyle gönderilen metadata'nın aynen geri dönüşü. Metadata gönderilmemişse null.
`totalResultCount`	int	Hayır	Toplam eşleşen kayıt sayısı.
`totalPageCount`	int	Hayır	Toplam sayfa sayısı.

Veri Güvenliği ve Maskeleme

⚠️

Aşağıdaki bilgiler yanıtta hiçbir zaman dönmez veya maskelenir:

Alan	Davranış
Telefon numarası	Hiç dönmez, `title`/`summary` içinde geçiyorsa `[MASKED]` olarak döner
E-posta	`[MASKED]` olarak döner
TCKN	`[MASKED]` olarak döner

callId alanı çağrının kendi kimliğidir ve telefon numarası gibi hassas veri sayılmaz — yanıtta düz metin olarak döner.

Token Alma & Yenileme Çağrı Başlat