وب هوک وضعیت پیام های ارسالی از طریق وب سرویس یا URL
با استفاده از این قابلیت وضعیت پیام های ارسالی از طریق وب سرویس یا URL (مانند: ارسال شده به اپراتور، رسیده به مخاطب، نرسیده به مخاطب، ارسال نشده) به آدرس URL تنظیم شده ارسال می گردند. جهت تعریف و مدیریت وب هوک وضعیت پیام های ارسالی، از طریق منوی خدمات پیشرفته، زیر منوی انتقال پیام | وب هوک اقدام نمایید.
وضعیت پیام های ارسالی از طریق وب سرویس یا URL به صورت یک آرایه درون یک شیء JSON با کلید
messages
و از طریق متد
HTTP POST
به URL تنظیم شده ارسال می شوند.
پارامترهای هر عنصر از آرایهی messages عبارتند از:
|
messageForwardingId
|
شناسه انتقال پیام | وب هوک تنظیم شده
|
|
sentMessageId
|
شناسه پیام ارسالی از طریق وب سرویس یا URL
|
|
senderNumber
|
شماره فرستنده
|
|
recipientNumber
|
شماره گیرنده
|
|
messageStatus
|
وضعیت پیام
|
پارامتر messageStatus (وضعیت پیام) حاوی یکی از مقادیر ذیل می باشد :
|
1
|
ارسال شده به درگاه اپراتور
|
|
2
|
رسیده به مخاطب
|
|
3
|
نرسیده به مخاطب
|
|
4
|
ارسال نشده
|
نمونه شیء JSON ارسالی :
{
"messages": [
{
"messageForwardingId": 1001110500,
"sentMessageId": "e2c9e1a9-0493-4bd3-8066-eeda836a5477",
"senderNumber": "10001000",
"recipientNumber": "09100000000",
"messageStatus": 1
},
{
"messageForwardingId": 1001110500,
"sentMessageId": "ca676167-cd66-442b-8997-5f30813b88d6",
"senderNumber": "20002000",
"recipientNumber": "09900000000",
"messageStatus": 2
},
{
"messageForwardingId": 1001110600,
"sentMessageId": "12958838-1091-4439-8b86-7c09b2f94aab",
"senderNumber": 30003000,
"recipientNumber": 9300000000,
"messageStatus": 3
}
]
}