# SMS-API

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

<Aside type="caution" title="/createSMSMessage ist veraltet">
Neue Integrationen sollten die [Messaging API v2](/de/developer/api-reference/messaging-api-v2/) verwenden — übergeben Sie `platforms: ["SMS"]` an `Notify`. Siehe die [Migrationsanleitung](/de/developer/api-reference/messaging-api-v2/migration-from-v1/#from-createsmsmessage).
</Aside>

<Aside type="note">
Bevor Sie SMS-Nachrichten senden, verbinden Sie Ihren SMS-Anbieter im Control Panel. [Erfahren Sie mehr](/de/developer/first-steps/connect-messaging-services/sms-configuration/)
</Aside>

## createSMSMessage <Badge text="Veraltet" variant="caution" size="small" />

Wird verwendet, um SMS-Benachrichtigungen an Benutzer zu senden

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

### Anfragekörper

| Name                           | Erforderlich | Typ     | Beschreibung                                                                                                 |
|--------------------------------|--------------|---------|--------------------------------------------------------------------------------------------------------------|
| **auth***                      | Ja           | string  | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) aus dem Pushwoosh Control Panel.                                                               |
| **application***               | Ja           | string  | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code)                                                                                 |
| **notifications***             | Ja           | array   | Inhaltseinstellungen. JSON-Array von Nachrichtenparametern. Siehe Details unten.                                       |

**Benachrichtigungsparameter**

| Name                             | Erforderlich | Typ     | Beschreibung                                                                                                                                                                                  |
|----------------------------------|--------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **send_date***                   | Ja           | string  | Datum und Uhrzeit zum Senden der Benachrichtigung. Verwenden Sie das Format `JJJJ-MM-TT HH:mm` oder `now`, um sofort zu senden.                                                                                           |
| **content***                     | Ja           | string  | Textinhalt der SMS-Nachricht.                                                                                                                                                              |
| **devices***                     | Ja           | array   | Telefonnummer des Kunden (muss mit einer UserId über `/registerDevice` verknüpft und im `hwid`-Parameter angegeben sein oder `use_auto_registration` verwenden). Hier kann nur eine Nummer angegeben werden. |
| **use_auto_registration**        | Nein         | boolean | Wenn auf `true` gesetzt, wird die im `devices`-Parameter angegebene Telefonnummer automatisch registriert.                                                                                      |
| **dynamic_content_placeholders** | Nein         | object  | Platzhalter für dynamische Inhalte zur Anpassung des Nachrichteninhalts. Jeder Platzhalter wird durch entsprechende dynamische Werte ersetzt.                                                           |
| **preset**                       | Nein         | string  | SMS-[Preset-Code](/de/developer/api-reference/api-identifiers/#preset-code) aus Ihrem Control Panel.                                                                                                                                                      |

### Anfragebeispiel

```json
{
  "request": {
    "application": "12345-67891",    // erforderlich. Pushwoosh-Anwendungscode.
    "auth": "yxoPUlwqm…………pIyEX4H",  // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel.
    "notifications": [{
      "send_date": "now",            // erforderlich. JJJJ-MM-TT HH:mm ODER "now".
      "content": "Hallo!",           // erforderlich. SMS-Text (String).
      "devices": ["+1234567890"],    // erforderlich. Telefonnummer des Kunden (muss mit einer
                                     //           UserId über /registerDevice verknüpft und im
                                     //           "hwid"-Parameter angegeben sein oder "use_auto_registration" verwenden).
                                     //           Hier kann nur eine Nummer angegeben werden.
      "preset": "XXXXX-XXXXX",       // optional. SMS-Preset-Code aus Ihrem Control Panel.
      "use_auto_registration": true  // optional. Registriert die im "devices"-Parameter angegebene
                                     //           Telefonnummer automatisch.
    }]
  }
}
```

### Antwortbeispiel

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

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

<Aside type="note">
Derzeit muss jede SMS in einer separaten Anfrage für jeden Kunden gesendet werden.
</Aside>

Um SMS-Statistiken zu erhalten, verwenden Sie die Methode [totalsByIntervals](/de/developer/api-reference/statistics-api/message-statistics-api/#totalsbyintervals).

Sie können auch Statistiken für jede Nachricht im Bereich [Nachrichtenverlauf](/de/product/statistics-and-analytics/message-history/) einsehen.

<Aside type="caution">
Bitte beachten Sie, dass einige Mobilfunkanbieter keine Daten zum Zustellungsstatus übermitteln, sodass die Statistiken möglicherweise nicht ganz genau sind. Sie können die Details bei den Mobilfunkanbietern überprüfen, die Ihren Kunden Nummern zur Verfügung stellen.
</Aside>