SMS API

createSMSMessage

تُستخدم لإرسال إشعارات SMS للمستخدمين

POST https://api.pushwoosh.com/json/1.3/createSMSMessage

جسم الطلب

الاسم	مطلوب	النوع	الوصف
auth*	نعم	string	API access token من لوحة تحكم Pushwoosh.
application*	نعم	string	Pushwoosh application code
notifications*	نعم	array	إعدادات المحتوى. مصفوفة JSON لمعلمات الرسالة. انظر التفاصيل أدناه.

معلمات الإشعار

الاسم	مطلوب	النوع	الوصف
send_date*	نعم	string	تاريخ ووقت إرسال الإشعار. استخدم التنسيق `YYYY-MM-DD HH:mm` أو `now` للإرسال فوراً.
content*	نعم	string	محتوى نص رسالة SMS.
devices*	نعم	array	رقم هاتف العميل (يجب أن يكون مرتبطاً بـ UserId باستخدام `/registerDevice` ومحدداً في معلمة `hwid` أو استخدم `use_auto_registration`). يمكن تحديد رقم واحد فقط هنا.
use_auto_registration	لا	boolean	إذا تم تعيينه إلى `true`، سيتم تسجيل رقم الهاتف المحدد في معلمة `devices` تلقائياً.
dynamic_content_placeholders	لا	object	عناصر نائبة للمحتوى الديناميكي لتخصيص محتوى الرسالة. سيتم استبدال كل عنصر نائب بالقيم الديناميكية المقابلة.
preset	لا	string	Preset Code لـ SMS من لوحة التحكم الخاصة بك.

مثال الطلب

{
  "request": {
    "application": "12345-67891",    // مطلوب. Pushwoosh application code.
    "auth": "yxoPUlwqm…………pIyEX4H",  // مطلوب. API access token من لوحة تحكم Pushwoosh.
    "notifications": [{
      "send_date": "now",            // مطلوب. YYYY-MM-DD HH:mm أو "now".
      "content": "Hello!",           // مطلوب. نص SMS (سلسلة نصية).
      "devices": ["+1234567890"],    // مطلوب. رقم هاتف العميل (يجب أن يكون مرتبطاً بـ UserId
                                     //           باستخدام /registerDevice ومحدداً في معلمة
                                     //           "hwid" أو استخدم "use_auto_registration").
                                     //           يمكن تحديد رقم واحد فقط هنا.
      "preset": "XXXXX-XXXXX",       // اختياري. SMS Preset Code من لوحة التحكم الخاصة بك.
      "use_auto_registration": true  // اختياري. تسجيل رقم الهاتف المحدد في معلمة
                                     //           "devices" تلقائياً.
    }]
  }
}

مثال الاستجابة

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "9648-0B10ECB6-0D9F214D"
    ]
  }
}

استجابة الخطأ

{
  "status_code": 210,
  "status_message": "Invalid devices list. \"devices\" must be an array.",
  "response": {
    "Messages": []
  }
}

للحصول على إحصائيات SMS، استخدم طريقة totalsByIntervals.

يمكنك أيضاً عرض الإحصائيات لكل رسالة في قسم Message History.