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

import { Badge } from '@astrojs/starlight/components';

<Aside type="caution" title="/createSMSMessage تم إيقافه">
يجب على عمليات التكامل الجديدة استخدام [Messaging API v2](/ar/developer/api-reference/messaging-api-v2/) — مرر `platforms: ["SMS"]` إلى `Notify`. راجع [دليل الترحيل](/ar/developer/api-reference/messaging-api-v2/migration-from-v1/#from-createsmsmessage).
</Aside>

<Aside type="note">
قبل إرسال رسائل SMS، قم بتوصيل مزود خدمة الرسائل القصيرة الخاص بك في لوحة التحكم (Control Panel). [تعرف على المزيد](/ar/developer/first-steps/connect-messaging-services/sms-configuration/)
</Aside>

## createSMSMessage <Badge text="مهمل" variant="caution" size="small" />

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

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

### نص الطلب

| الاسم | مطلوب | النوع | الوصف |
|---|---|---|---|
| **auth*** | نعم | string | [رمز الوصول إلى API](/ar/developer/api-reference/api-identifiers/#api-access-token) من لوحة تحكم Pushwoosh. |
| **application*** | نعم | string | [رمز تطبيق Pushwoosh](/ar/developer/api-reference/api-identifiers/#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 | [رمز الإعداد المسبق](/ar/developer/api-reference/api-identifiers/#preset-code) للرسائل القصيرة من لوحة التحكم الخاصة بك. |

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

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

### مثال على الاستجابة

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

### استجابة الخطأ
```json
{
  "status_code": 210,
  "status_message": "Invalid devices list. \"devices\" must be an array.",
  "response": {
    "Messages": []
  }
}
```

<Aside type="note">
 حاليًا، يجب إرسال كل رسالة SMS في طلب منفصل لكل عميل.
</Aside>

للحصول على إحصائيات الرسائل القصيرة، استخدم طريقة [totalsByIntervals](/ar/developer/api-reference/statistics-api/message-statistics-api/#totalsbyintervals).

يمكنك أيضًا عرض إحصائيات كل رسالة في قسم [سجل الرسائل (Message History)](/ar/product/statistics-and-analytics/message-history/).

<Aside type="caution">
يرجى ملاحظة أن بعض مشغلي شبكات الهاتف المحمول لا ينقلون بيانات حالة التسليم، لذلك قد لا تكون الإحصائيات دقيقة. يمكنك التحقق من التفاصيل مع مشغلي شبكات الهاتف المحمول الذين يوفرون الأرقام لعملائك.
</Aside>