# SMS API

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

<Aside type="caution" title="/createSMSMessage अब अप्रचलित है">
नए इंटीग्रेशन को [Messaging API v2](/hi/developer/api-reference/messaging-api-v2/) का उपयोग करना चाहिए — `Notify` को `platforms: ["SMS"]` पास करें। [माइग्रेशन गाइड](/hi/developer/api-reference/messaging-api-v2/migration-from-v1/#from-createsmsmessage) देखें।
</Aside>

<Aside type="note">
SMS संदेश भेजने से पहले, कंट्रोल पैनल में अपने SMS प्रदाता को कनेक्ट करें। [और जानें](/hi/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*** | हाँ | स्ट्रिंग | Pushwoosh कंट्रोल पैनल से [API एक्सेस टोकन](/hi/developer/api-reference/api-identifiers/#api-access-token)। |
| **application*** | हाँ | स्ट्रिंग | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| **notifications*** | हाँ | ऐरे | कंटेंट सेटिंग्स। संदेश पैरामीटर का JSON ऐरे। नीचे विवरण देखें। |

**नोटिफिकेशन पैरामीटर्स**

| नाम | आवश्यक | प्रकार | विवरण |
|---|---|---|---|
| **send_date*** | हाँ | स्ट्रिंग | सूचना भेजने की तारीख और समय। तुरंत भेजने के लिए `YYYY-MM-DD HH:mm` या `now` प्रारूप का उपयोग करें। |
| **content*** | हाँ | स्ट्रिंग | SMS संदेश की टेक्स्ट सामग्री। |
| **devices*** | हाँ | ऐरे | ग्राहक का फ़ोन नंबर (`/registerDevice` का उपयोग करके एक UserId से जुड़ा होना चाहिए और `hwid` पैरामीटर में निर्दिष्ट होना चाहिए या `use_auto_registration` का उपयोग करें)। यहाँ केवल एक नंबर निर्दिष्ट किया जा सकता है। |
| **use_auto_registration** | नहीं | बूलियन | यदि `true` पर सेट किया गया है, तो `devices` पैरामीटर में निर्दिष्ट फ़ोन नंबर स्वचालित रूप से पंजीकृत हो जाएगा। |
| **dynamic_content_placeholders** | नहीं | ऑब्जेक्ट | संदेश सामग्री को अनुकूलित करने के लिए डायनामिक कंटेंट प्लेसहोल्डर। प्रत्येक प्लेसहोल्डर को संबंधित डायनामिक मानों से बदल दिया जाएगा। |
| **preset** | नहीं | स्ट्रिंग | आपके कंट्रोल पैनल से SMS [प्रीसेट कोड](/hi/developer/api-reference/api-identifiers/#preset-code)। |

### रिक्वेस्ट का उदाहरण

```json
{
  "request": {
    "application": "12345-67891",    // आवश्यक। Pushwoosh एप्लिकेशन कोड।
    "auth": "yxoPUlwqm…………pIyEX4H",  // आवश्यक। Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन।
    "notifications": [{
      "send_date": "now",            // आवश्यक। YYYY-MM-DD HH:mm या "now"।
      "content": "Hello!",           // आवश्यक। SMS टेक्स्ट (स्ट्रिंग)।
      "devices": ["+1234567890"],    // आवश्यक। ग्राहक का फ़ोन नंबर (/registerDevice का उपयोग करके
                                     //           एक UserId से जुड़ा होना चाहिए और "hwid" पैरामीटर में
                                     //           निर्दिष्ट होना चाहिए या "use_auto_registration" का उपयोग करें)।
                                     //           यहाँ केवल एक नंबर निर्दिष्ट किया जा सकता है।
      "preset": "XXXXX-XXXXX",       // वैकल्पिक। आपके कंट्रोल पैनल से SMS प्रीसेट कोड।
      "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>

SMS आँकड़े प्राप्त करने के लिए, [totalsByIntervals](/hi/developer/api-reference/statistics-api/message-statistics-api/#totalsbyintervals) विधि का उपयोग करें।

आप [संदेश इतिहास](/hi/product/statistics-and-analytics/message-history/) अनुभाग में प्रत्येक संदेश के लिए आँकड़े भी देख सकते हैं।

<Aside type="caution">
कृपया ध्यान दें कि कुछ मोबाइल ऑपरेटर डिलीवरी स्थिति डेटा प्रसारित नहीं करते हैं, इसलिए आँकड़ों को अधिक सटीक होने की आवश्यकता हो सकती है। आप उन मोबाइल ऑपरेटरों से विवरण की जाँच कर सकते हैं जो आपके ग्राहकों को नंबर प्रदान करते हैं।
</Aside>