3 - ارسال پیام

ارسال پیام به صورت گروهی به چند مدل مختلف امکان پذیر است. موارد مشترک در فراخوانی درخواست به شرح زیر ارائه و در انتهای تمامی مدل ها، دریافت پاسخ توضیحات ارائه می‌شود.

درخواست:

هدر:

توضیحات:

نکات:

در ارسال‌های گروهی می‌توانید تا ۲۵۰ پیام مجزا ارسال نمایید.

طول پیام می‌تواند تا 32 پارت باشد.

ارسال پیام گروهی

ارسال پیام به‌صورت گروهی با امکان تعیین فرستنده، گیرنده، متن و زمان ارسال برای هر پیام به‌صورت مجزا.

{
  "sender": "982000111",
  "recipient": "9891111",
  "body": "BODY",
  "customerId": "CUSTOMER_ID",
  "sendDate": "YYYY-MM-DD HH:MM:SS"
}

ارسال پیام گروهی با فرستنده ثابت

ارسال پیام به چند گیرنده با یک شماره فرستنده ثابت و متن‌های متغیر برای هر گیرنده.

فراخوانی درخواست:

بدنه:

{
  "sender": "982000111",
  "smsItems": [
    {
      "recipient": "9891111",
      "body": "BODY",
      "customerId": "CUSTOMER_ID",
      "sendDate": "2025-08-13 15:30:00"
    }
  ]
}

دریافت پاسخ:

بدنه:

[
  {
    "customerId": "CUSTOMER_ID",
    "mobile": "MOBILE",
    "serverId": "SERVER_ID"
  },
  {
    "customerId": "CUSTOMER_ID",
    "mobile": "MOBILE",
    "errorCode": "ERROR_CODE",
    "description": "DESCRIPTION"
  }
]

توضیحات:

نکات:

وجود ServerId به معنی ثبت موفقیت آمیز درخواست در غیر اینصورت وجود errorCode نشانگر بروز خطا در درخواست ارسالی است.(لیست خطاها در انتهای مستند آورده شده است)

در صورت تکراری بودن مقدار CustomerId، هنگام فراخوانی متد getStatus تمام پیام‌های با این مقدار برگردانده می‌شوند.