Skip to main content

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

Schema
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.
Not : E─čer iki tarih aral─▒─č─▒nda ├žal─▒┼čan ve m├╝┼čteri aras─▒ndaki aramalaar g├Âr├╝nt├╝lenmek isteniyorsa staffId ve customerId alanlar─▒ API'ye verilmelidir.

├ľrnek Json Request Body :#

{
"startDate" : 1617278400000,
"endDate" : 1617969609000,
"callType" : "voice",
"staffId" : "45186",
"customerId" : "2337368"
}

Responses#

HTTP 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 :#

[
{
"callEndedAt": 1617111451686,
"callId": -1527120504243668640,
"callStartedAt": 1617111449440,
"callState": "MISSED",
"callTime": 0,
"callType": "video",
"callViewUrl": "",
"initiatorId": "45188",
"nameOfInitiator": "Agent 45153",
"nameOfReceiver": "android 5667067",
"receiverId": "5667067"
},
{
"callEndedAt": 1617111385505,
"callId": 3387307531615898478,
"callStartedAt": 1617111363995,
"callState": "ENDED",
"callTime": 11,
"callType": "video",
"callViewUrl": "http://web.diyalog.im/v1/playrecords/3387307531615898478...",
"initiatorId": "45188",
"nameOfInitiator": "Agent 45153",
"nameOfReceiver": "android 5667067",
"receiverId": "5667067"
}
]
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 CodeMesajA├ž─▒klama
400Required headers not foundDate, X-Requester-UserId veya X-Authorization header alanlar─▒ndan biri veya birka├ž─▒ eksik.
400Authorization failed due to data format not validX-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.
400Authorization failed due to date not validX-DLG-DATE tarih format─▒ "EEE, dd MMM yyyy HH:mm:ss Z" format─▒nda de─čil. Kontrol edin..
401Authorization failed─░stek do─črulanamad─▒. ─░mza de─čeri do─čru de─čil.
403Request time may not be correct.─░stek header'─▒nda gelen x-dlg-date ve sunucu zaman─▒ aras─▒nda +/- 15 dakikadan fazla fark var.