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 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.