getcalllist
POST v1/reporting/getcalllist#
Bu API aracılığı ile iki tarih aralığında Diyalog üzerinden yapılan aramaların (görüntülü / sesli) listesine erişilebilir. API'ye çalışan sicili ve/veya müşteri numarası bilgileri de parametre olarak eklenebilir.
Her istekte maximum 20 adet bilgi tarihe göre yeniden eskiye doğru döner.
API'ye verilen iki tarih aralığında 20 adetten daha fazla öğe olabilir. Bu durumda en son yapılan 20 canlı yardım döner. İki tarih aralığında yapılan diğer öğeleride alabilmek için API cevabında dönen en eski tarihli (son öğe) öğenin tarihi alınmalı ve bu tarih kullanılarak API tekrar tekrar çağırılmalıdır.
API istekleri
- HMAC Authentication ile doğrulanmalıdır. HMAC Authentication için Authentication dokümanına bakınız.
- API URI : https://DIYALOG-SERVER-API-ENDPOINT/v1/reporting/getcalllist
- HTTP İstek Türü POST
- HTTP Content-Type application/json
#
Request BodySchema |
---|
json object |
startDate (long) Unix epoch timestamps (miliseconds). Aramaların sorgulanacağı başlangıç tarihidir. |
endDate (long) Unix epoch timestamps (miliseconds). Aramaların sorgulanacağı bitiş tarihidir. |
callType (string) Arama türüne göre sorgu yapabilenizi sağlar. Alabileceği değerler aşağıdaki gibidir : "all" : Görüntülü ve sesli görüşmelerin hepsini döner. "video" : Görüntülü görüşmeleri döner. "voice" : Sesli görüşmeleri döner. |
staffId (string) Opsiyoneldir. Çalışan sicil numarası. Eğer bir çalışanın verilen iki tarih aralığındaki aramaları görüntülenmek isteniyorsa bu bilgi API'ye verilmelidir. |
customerId (string) Opsiyoneldir. Müşteri numarası. Eğer bir müşterinin verilen iki tarih aralığındaki aramaları görüntülenmek isteniyorsa bu bilgi API'ye verilmelidir. |
#
Örnek Json Request Body :#
ResponsesHTTP 200 Response |
---|
json object array API cevap olarak json array döner. Bu array içerisinde aşağıdaki alanlardan oluşan json objeleri döner. Her objenin içerisinde yapılan aramanın detayları bulunur. API cevap olarak maksimum 20 adet bilgi (json objesi) tarih sıralamasına göre yeniden eskiye doğru sıralı şekilde döner. Eğer herhangi bir arama bulunamaz ise array boş olarak döner. |
json object |
callId (long) Diyalog sisteminde arama için oluşturulan tekil id. |
initiatorId (string) Arayan kişinin sicil veya müşteri numarasıdır. |
nameOfInitiator (string) Arayan kişinin ad ve soyad bilgisidir. |
receiverId (string) Aranan kişinin sicil veya müşteri numarasıdır. |
nameOfInitiator (string) Aranan kişinin ad ve soyad bilgisidir. |
callStartedAt (long) Unix epoch timestamps (miliseconds). Aramanın başladığı tarih ve zaman bilgisidir. |
callEndedAt (long) Unix epoch timestamps (miliseconds). Aramanın sona erdiği tarih ve zaman bilgisidir. |
callTime (int) Arama süresini saniye cinsinden verir. Eğer arama başlamamış ise yani karşı taraf kabul etmemiş veya bağlantı kurulamamış ise bu değer 0 olarak döner. |
callType (string) Aramanın video veya sesli görüşme olup olmadığı bilgisini verir. "video" : Video görüşme "voice" : Sesli görüşme "" : Diyalog 1.6.2 versiyonu öncesinde sesli ve video görüşme ayrımı yapılmamaktaydı. Bu versiyon öncesindeki aramaları türü bilinememektedir. Bu nedenle boşluk olarak dönebilir. |
callState (string) Aramanın en son aldığı durum bilgisini döner. Durum değerleri aşağıdaki gibidir : "START" : Bir kişi tarafından arama başlatıldığında durum "START" olur. Bu durumun dönmesi beklenmemektedir. "ENDED" : Arama başlamış, görüşme başlamış ve sonlandırılmıştır. "MISSED" : Arama karşı tarafın kabul etmemesi veya açmaması nedeniyle sonlandırılmıştır. |
callViewUrl (string) Arama kaydının izlenebileceği dinamik link bu alanda döner. Eğer arama kaydı oluşmamış veya arama başlamamış ise bu boşluk olarak dönecektir. Arama bu link bir browserda açılarak izlenebilir. Bu link bir browser aracılığı ile açıldığında Diyalog platformuna bağlanılır ve arama kaydı Diyalog platformu üzerinden gösterilir. |
#
Örnek Response Body :HTTP 500 Response |
---|
string API hata aldığında HTTP 500 status kodu ile cevap dönecektir. API'nin hata mesajı metin olarak döner. |
#
API isteği doğrulama sırasında hata alırsa aşağıdaki hata kodlarını döner.Http Status Code | Mesaj | Açıklama |
---|---|---|
400 | Required headers not found | Date, X-Requester-UserId veya X-Authorization header alanlarından biri veya birkaçı eksik. |
400 | Authorization failed due to data format not valid | X-Authorization header alanındaki bilgiler doğru formatta değil. Alanın "DLGA " ile başlayıp accesKeyId ve imza değerleri arasına : olduğunu kontrol edin. |
400 | Authorization failed due to date not valid | X-DLG-DATE tarih formatı "EEE, dd MMM yyyy HH:mm:ss Z" formatında değil. Kontrol edin.. |
401 | Authorization failed | İstek doğrulanamadı. İmza değeri doğru değil. |
403 | Request time may not be correct. | İstek header'ında gelen x-dlg-date ve sunucu zamanı arasında +/- 15 dakikadan fazla fark var. |