Rapor Alma

Her kullanıcıya atılan mesaja birer reportid verilir. Mesaj kullanıcılara iletildiğinde ve kullanıcı mesajı okuduğunda bu reportid kullanılarak servislere bildirim atılır. Reportid bilgilerini ve raporları almak için servisin rapor alma yetkisinin olması gerekir. Yetki alınması için bipussu super admini ile iletişime geçilir. Servisin eş zamanlı/eş zamansız oluşuna göre raporlar ikiye ayrılır:

Yapılan isteğe dönen cevapta rapor yer alır.

Servisin geri besleme url’i + /report adresine cevap dönülür.

Eş zamanlı rapor iletimi

Yapılan isteğe dönen cevapta rapor yer alır. Bu raporu destekleyen servis türleri:

Sendmsgserv servisinde tüm takipçilere gönderim yapıldığında (receiver: 1)

İstek
{  
    "txnid": "Broadcast-1Content",  
    "resultcode": 0,  
    "list": [{  
        "resultcode": 0,  
        "receiver": "9053XXXXXXXX",  
        "reportid": "6a7Q8-1502",  
        "numberofmessage": 1,  
        "totalnumberofmessage": 1  
    }]  
}  
Özellik
ÖzellikDeğerAçıklama
*txnidstringisteğe ait id değeri
*resultcodestringGönderim sonucu.
*listobjectKullanıcı listesi
*resultcodelongBu mesaj için işlem sonucu
*receiverstringGönderim yapılan alıcı özelindeki sonuç 0: Başarılı, Diğer herşey: Başarısız
*reportidstringEğer resultcode 0 ise bu kullanıcıya gönderilen mesajın idsi. Gönderildi, okundu bilgileri daha sonra bu id ile gönderilecektir
*numberofmessageintKaçıncı mesaj olduğu
*totalnumberofmessageintKullanıcıya gönderilen mesajın sırası. Birden çok mesaj aynı anda gönderilmiş olabilir. Örneğin 2 mesaj tek kullanıcıya gönderildiyse bu değer mesajın sırasını gösterir.

Eş zamansız rapor iletimi

Yapılan isteğe dönen cevapta rapor yer almaz. Gönderim yapıldıktan sonra servisin geri besleme url’i + /report adresine cevap dönülür.

İstek
{  
    "reqid": 12,
    "txnid": "Broadcast-1Content",
    "resultcode": 0,
    "list": [
        {  
            "receiver": "9053XXXXXXXX",
            "resultcode": 0,
            "reportid": "6a7Q8-1502",
            "numberofmessage": 1,
            "totalnumberofmessage": 1 
        }, {  
            "receiver": "9053XXXXXXXX",
            "resultcode": 312,
            "reportid": null, 
            "numberofmessage": null,
            "totalnumberofmessage": 1
        }  
    ]  
}  
Özellik
ÖzellikDeğerAçıklama
*reqidstringRapor gönderimine ait id değeri
*txnidstringisteğe ait id değeri
*resultcodestringGönderim sonucu.
*listobjectKullanıcı listesi
*resultcodelongBu mesaj için işlem sonucu
*receiverstringGönderim yapılan alıcı özelindeki sonuç 0: Başarılı, Diğer herşey: Başarısız
*reportidstringEğer resultcode 0 ise bu kullanıcıya gönderilen mesajın idsi. Gönderildi, okundu bilgileri daha sonra bu id ile gönderilecektir
*numberofmessageintKaçıncı mesaj olduğu
*totalnumberofmessageintKullanıcıya gönderilen mesajın sırası. Birden çok mesaj aynı anda gönderilmiş olabilir. Örneğin 2 mesaj tek kullanıcıya gönderildiyse bu değer mesajın sırasını gösterir.

Reportid Takip Etme

Kullanıcı kendisine gönderilen mesajı aldığında, iletildi ve görüntülendi mesajları geri besleme URL’inize aynı reportid ile gönderilir. Mesaj gönderdiğinizde aldığınız reportid ile geri besleme URL’inize gelen report id eşleştirilerek iletildi/görüntülendi raporlarının takibi sağlanır. Kullanıcı Aksiyonları kısmında detaylı bilgiye erişilebilir.