واجهة برمجة تطبيقات الرسائل القصيرة (SMS)

createSMSMessage مهمل

يُستخدم لإرسال إشعارات الرسائل القصيرة (SMS) إلى المستخدمين

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

نص الطلب

الاسم	مطلوب	النوع	الوصف
auth*	نعم	string	رمز الوصول إلى واجهة برمجة التطبيقات (API access token) من لوحة تحكم Pushwoosh.
application*	نعم	string	رمز تطبيق Pushwoosh
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) للرسائل القصيرة من لوحة التحكم الخاصة بك.

مثال على الطلب

{
  "request": {
    "application": "12345-67891",    // مطلوب. رمز تطبيق Pushwoosh.
    "auth": "yxoPUlwqm…………pIyEX4H",  // مطلوب. رمز الوصول إلى واجهة برمجة التطبيقات (API access token) من لوحة تحكم Pushwoosh.
    "notifications": [{
      "send_date": "now",            // مطلوب. YYYY-MM-DD HH:mm أو "now".
      "content": "Hello!",           // مطلوب. نص الرسالة القصيرة (string).
      "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": []
  }
}

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

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