وب هوک وضعیت پیام های ارسالی از طریق وب سرویس یا 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": "5eb53790-4d45-4155-b30e-9db5606ba234",
"senderNumber": "10001000",
"recipientNumber": "09100000000",
"messageStatus": 1
},
{
"messageForwardingId": 1001110500,
"sentMessageId": "e64207c1-0078-4120-aff3-3638067911a0",
"senderNumber": "20002000",
"recipientNumber": "09900000000",
"messageStatus": 2
},
{
"messageForwardingId": 1001110600,
"sentMessageId": "ef0b04a1-d95d-40e5-9acb-96ee5db44181",
"senderNumber": 30003000,
"recipientNumber": 9300000000,
"messageStatus": 3
}
]
}