SMS API

createSMSMessage Veraltet

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 aus dem Pushwoosh Control Panel.
application*	Ja	string	Pushwoosh-Anwendungscode
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 `YYYY-MM-DD 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 aus Ihrem Control Panel.

Anfragebeispiel

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

Antwortbeispiel

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

Fehlerantwort

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

Um SMS-Statistiken zu erhalten, verwenden Sie die Methode totalsByIntervals.

Sie können auch Statistiken für jede Nachricht im Bereich Nachrichtenverlauf einsehen.