Skip to main content

getstaffmessaginglist

POST v1/reporting/getstaffmessaginglist#

Bu API arac─▒l─▒─č─▒ ile iki tarih aral─▒─č─▒nda bir ├žal─▒┼čan─▒n Diyalog ├╝zerinden yapm─▒┼č oldu─ču mesajla┼čma listesine eri┼čilebilir. API'ye m├╝┼čteri numaras─▒ bilgileri de parametre olarak eklenebilir. M├╝┼čteri numaras─▒ eklenirse ├žal─▒┼čan─▒n o m├╝┼čteri ile yapm─▒┼č oldu─ču mesajla┼čmalar listelenir.

Bir ├žal─▒┼čan─▒n bir ba┼čka biri ile yapt─▒─č─▒ mesajla┼čmalar g├╝nl├╝k bazda listelenir. API'den d├Ânen liste ├žok fazla olabilir bu nedenle servis sayfaland─▒rma y├Ântemi ile cevap d├Âner. Bunun i├žin API, sayfa numaras─▒ ve her sayfa i├žin d├Ânmesi beklenen adet bilgisini parametre olarak al─▒r. Her sayfada g├Âsterilecek olan adet bilgisi 20 adetten b├╝y├╝k olmamal─▒d─▒r. Aksi durumda servis en fazla 20 adet veri d├Âner.

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). Mesajla┼čmalar─▒n sorgulanaca─č─▒ ba┼člang─▒├ž tarihidir.
endDate (long)
Unix epoch timestamps (miliseconds). Mesajla┼čmalar─▒n sorgulanaca─č─▒ biti┼č tarihidir.
staffId (string)
├çal─▒┼čan sicil numaras─▒. Mesajla┼čma listesinin d├Ânmesi istenen ├žal─▒┼čan─▒n sicil numaras─▒d─▒r.
customerId (string)
Opsiyoneldir.
M├╝┼čteri numaras─▒. M├╝┼čteri numaras─▒ verilirse API ├žal─▒┼čan─▒n bu m├╝┼čteri ile olan mesajla┼čmalar─▒n─▒ d├Âner.
isGroupMessaging (boolean)
Opsiyoneldir.
Bu parametre API'ye iletilmezse API grup ve ├Âzel yaz─▒┼čmalar─▒n hepsini cevap olarak d├Âner. E─čer bu parametre iste─če eklenir ve de─čeri true olarak verilirse sadece grup mesajla┼čmalar cevap olarak d├Âner. Benzer ┼čekilde bu parametrenin de─čeri false verilirse API sadece ├Âzel mesajla┼čmalar─▒ d├Âner.
pageNumber (int)
Sayfaland─▒rma (pagination) i├žin sayfa numaras─▒ indeksidir. Sonraki datalar─▒ almak i├žin ayn─▒ sorgu parametreleri ile bu indeks artt─▒r─▒larak istek yap─▒lmadl─▒r.
pageSize (int)
Sayfaland─▒rma (pagination) i├žin her sayfada g├Âsterilecek olan maksimum bilgi adedidir. Bu adet 20'den fazla olmamal─▒d─▒r. E─čer 20'den fazla olursa API maksimum 20 adet bilgi d├Âner.

├ľrnek Json Request Body :#

{
"startDate" : 1610014524000,
"endDate" : 1617969609000,
"staffId" : "45186",
"customerId" : "2337368",
"isGroupMessaging" : true,
"pageNumber" : 1,
"pageSize" : 20
}

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 mesajla┼čman─▒n detaylar─▒ bulunur. API cevap olarak sayfalama y├Ântemi ile istekte verilen pageSize kadar 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
     senderId (string)
┬á┬á┬á┬á┬á Mesaj g├Ânderen ki┼činin sicil numaras─▒ d├Âner.
     nameOfSender (string)
┬á┬á┬á┬á┬á Mesaj g├Ânderen ki┼činin ad ve soyad bilgisidir.
     receiverId (string)
┬á┬á┬á┬á┬á Mesaj alan ki┼činin sicil veya m├╝┼čteri numaras─▒d─▒r.
     nameOfReceiver (string)
┬á┬á┬á┬á┬á Mesaj alan ki┼činin ad ve soyad bilgisidir.
     messagingDate (long)
┬á┬á┬á┬á┬á Unix epoch timestamps (miliseconds). Mesajla┼čma yap─▒lan g├╝n├╝n bilgisini d├Âner. Veriler g├╝nl├╝k olarak tutuldu─ču i├žin bu d├Ânen bilginin tarih k─▒sm─▒n─▒ kullanabilirsiniz. Zaman her zaman 00:00 d├Âner.
     sendMessageCount (int)
┬á┬á┬á┬á┬á Mesaj g├Ânderen ├žal─▒┼čan─▒n ilgili ki┼čiye o g├╝n i├žin ka├ž adet mesaj g├Ânderdi─či bilgisidir. Adet bilgisi maksimum 10 adete kadar hata pay─▒ i├žermektedir.
     isGroupMessaging (boolean)
┬á┬á┬á┬á┬á Yap─▒lan mesajla┼čma grup mesajla┼čma olabilir. E─čer grup mesajla┼čma ise bu alan "true" de─čilse "false" olarak d├Âner.
     groupId (int)
┬á┬á┬á┬á┬á Yap─▒lan mesajla┼čma grup mesajla┼čma ise bu alanda Diyalog platformu ├Âzelinde olu┼čturulan tekil grup id bilgisi d├Âner.
     conversationDetailLink (string)
┬á┬á┬á┬á┬á ─░lgili mesajla┼čman─▒n Diyalog platfromuna ba─član─▒larak g├Âr├╝nt├╝lenebilece─či dinamik linktir. Bu link bir browser'da a├ž─▒ld─▒─č─▒nda, Diyalog uygulamas─▒na ba─član─▒l─▒r ve mesajla┼čma i├žerikleri Diyalog uygulamas─▒ ├╝zerinden g├Âr├╝nt├╝lenebilir.

├ľrnek Response Body :#

[
{
"conversationDetailLink": "http://web.diyalog.im/views.html#/messaging?...",
"groupId": 2128893729,
"isGroupMessaging": true,
"messagingDate": 1617580800000,
"nameOfReceiver": "Cust 113344",
"nameOfSender": "Agent 45153",
"receiverId": "113344",
"sendMessageCount": 6,
"senderId": "45188"
},
{
"conversationDetailLink": "http://web.diyalog.im/views.html#/messaging?...",
"groupId": 0,
"isGroupMessaging": false,
"messagingDate": 1617580800000,
"nameOfReceiver": "Cust 113344",
"nameOfSender": "Agent 45153",
"receiverId": "113344",
"sendMessageCount": 19,
"senderId": "45188"
}
]
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.