لوگو

پنل کاربری

8 - دریافت وضعیت پیام

سرویس وضعیت تحویل پیام (Message Delivery Status Push) ردیابی وضعیت تحویل پیام‌های ارسالی مشتری (MT) را فراهم می‌کند.

پس از ارسال پیامک به کاربر، سرویس فرآیند تحویل را مانیتور کرده و وضعیت به‌روزرسانی‌ شده را به سرور مشتری منتقل می‌کند. اطلاع از تحویل موفقیت‌آمیز پیامک، شفافیت و بینش‌های عملی را به کمپین‌های پیامکی مشتری ارائه می‌دهد.

مزایا:

  • شفافیت: دریافت بلادرنگ به‌روزرسانی‌های وضعیت تحویل پیام ارسالی
  • مدیریت خطاها: شناسایی و رفع سریع مشکلات تحویل پیام ارسالی به منظور بهبود اثربخشی ارتباطات

با استفاده از دو سرویس دریافت پیام (MO) و وضعیت تحویل پیام ، مدیریت جامع و کارآمد پیام‌های ورودی و خروجی تضمین می‌شوند. این امر اعتمادپذیری و بینش‌ لازم برای حفظ ارتباطات بی‌نقص میان مشتری و کاربر را فراهم می‌کند.

دریافت وضعیت پیام :

در این سرویس اطلاعات مربوط به وضعیت کلی پیام ارسال شده، برای URL ثبت شده بر روی سرشماره مشتری ارسال می‌شود. این سرویس دو نوع متد POST و GET را پشتیبانی می‌کند.

  • در صورت استفاده از نوع GET، اطلاعات به صورت Query param ارسال می‌شود.
آدرس:URL?messageId=301047287&timestamp=1733240217567&totalParts=10&deliveredParts=10&from=9820001&to=989000000000&trackId=673b1c7fae0e9d4c6331ba2d&batchId=673b1b63ae0e9d4c6328a786&customerId=1234&&status=DELIVERED
  • در صورت استفاده از متد POST، اطلاعات به صورت Request body ارسال می‌گردد. لازم به ذکر است در متد POST لیستی از وضعیت پیام ارسال می‌شود که به شکل زیر است:
{
   "statusItems": [
      {
         "messageId": MESSAGE_ID,
         "timestamp": TIMESTAMP,
         "totalParts": TOTAL_PARTS,
         "deliveredParts": DELIVERED_PARTS,
         "from": "FROM",
         "to": "TO",
         "trackId": "TRACK_ID",
         "batchId": "BATCH_ID",
         "customerId": "CUSTOMER_ID",
         "status": "STATUS"
      }
   ]
}
  • توضیحات اطلاعات ارسالی در سرویس دریافت وضعیت پیام:
توضیحاتنوعنام پارامتر
شناسه پیامLongmessageId
زمان ارسال پیامLongtimestamp
تعداد پارت‌های کل پیامLongtotalParts
تعداد پارت‌های ارسال شدهLongdeliveredParts
شماره مبداStringfrom
شماره مقصدStringto
شناسه پیام تکیStringtrackId
شناسه پیام گروهیStringbatchId
شناسه ارسال مشتری در وب‌سرویسStringcustomerId
وضعیت پیام ارسالیEnum (DELIVERED / UNDELIVERED)status