Zum Inhalt springen
Benutzerhandbücher Support Demo anfordern Anmelden
Pushwoosh.com

Messages API

createMessage Veraltet

Anchor link to

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

Erstellt eine neue Push-Benachrichtigung.

Anforderungskörper

Anchor link to
NameTypBeschreibung
auth*stringAPI-Zugriffstoken aus dem Pushwoosh Control Panel.
application*stringPushwoosh-Anwendungscode
notifications*arrayJSON-Array mit Nachrichtenparametern. Details finden Sie im Anforderungsbeispiel unten.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "C3F8-C3863ED4-334AD4F1"
    ]
  }
}

Anforderungsbeispiel

Anchor link to
Beispiel
{
  "request": {
    "application": "XXXXX-XXXXX",       // erforderlich. Pushwoosh-Anwendungscode.
    "auth": "yxoPUlwqm…………pIyEX4H",     // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel.
    "notifications": [{
      "send_date": "now",               // optional. YYYY-MM-DD HH:mm ODER 'now'
      "content": {                      // optional. Objekt ODER Zeichenfolge.
        "en": "English",                //           Verwenden Sie stattdessen "wns_content" für Windows.
        "fr": "French"
      },
      "title": {                        // optional. Objekt ODER Zeichenfolge.
        "en": "Title",                  //           Wird ignoriert, wenn plattformspezifische Titel angegeben sind
        "fr": "Titre"                   //           'ios_title', 'android_header', etc.
      },                                //           siehe die Beispiele für plattformspezifische Parameter unten.
      "subtitle":{                      // optional. Objekt ODER Zeichenfolge.
        "en": "Subtitle",               //           Wird ignoriert, wenn plattformspezifische Titel angegeben sind
        "fr": "Sous-titre"              //           'ios_subtitle', etc.
      },                                //           siehe die Beispiele für plattformspezifische Parameter unten.
      "ignore_user_timezone": true,     // optional.
      "timezone": "America/New_York",   // optional. Wenn ignoriert, ist UTC-0 Standard für "send_date".
                                        //           Siehe https://php.net/manual/timezones.php für
                                        //           unterstützte Zeitzonen.
      "campaign": "CAMPAIGN_CODE",      // optional. Kampagnencode, dem Sie diese
                                        //           Push-Nachricht zuweisen möchten.
      "geozone": {                      // optional. An Geozone senden
        "lat": 22.22,
        "lng": 33.33,
        "range": 110
      },
      "rich_media": "XXXXX-XXXXX",      // optional. Kopieren Sie den Rich-Media-Code aus der URL-Leiste
                                        //           der Rich-Media-Editor-Seite im Pushwoosh Control Panel.
      "link": "https://google.com",     // optional. Für Deeplinks fügen Sie "minimize_link": 0 hinzu
      "minimize_link": 0,               // optional. 0 – nicht minimieren, 2 – bitly. Standard = 2.
                                        //           Bitte beachten Sie, dass Shortener Einschränkungen
                                        //           bezüglich der Anzahl der Aufrufe haben.
      "data": {                         // optional. JSON-Zeichenfolge oder JSON-Objekt, wird als
        "key": "value"                  //           "u"-Parameter in der Payload übergeben (in JSON-Zeichenfolge konvertiert).
      },
      "transactionId": "unique UUID",   // optional. Eindeutiger Nachrichtenidentifikator, um Duplikate
                                        //           im Falle von Netzwerkproblemen zu verhindern. Wird auf der Seite von
                                        //           Pushwoosh für 5 Minuten gespeichert.
      "platforms": [                    // optional. 1 – iOS; 3 – Android; 7 – Mac OS X; 8 – Windows;
        1, 3, 7, 8, 9, 10,              //           9 – Amazon; 10 – Safari; 11 – Chrome;
        11, 12, 17                      //           12 – Firefox; 17 – Huawei
      ],
      "preset": "XXXXX-XXXXX",          // optional. Push-Preset-Code aus Ihrem Control Panel.
                                        //           Wenn spezifische Parameter in der Anfrage gesendet werden,
                                        //           überschreiben sie die Parameter des Presets.
      "send_rate": 100,                 // optional. Drosselung. Gültige Werte sind von 100 bis 1000 Pushes/Sekunde.
      "send_rate_avoid": true,          // optional. Wenn auf true gesetzt, wird das Drosselungslimit nicht auf
                                        //           diese spezifische Push-Benachrichtigung angewendet.
      // Vorlagenbezogen, bitte lesen Sie den Leitfaden zur Template Engine, um mehr zu erfahren
      "template_bindings": {            // optional.
        "TemplatePlaceholder": "Value"
      },
      "dynamic_content_placeholders": { // optional. Platzhalter für dynamische Inhalte anstelle von Geräte-Tags.
        "firstname": "John",
        "lastname": "Doe"
      },
      "message_type": "marketing",       // optional. "marketing" oder "transactional".
                                         // Wenn weggelassen, erhalten Benutzer mit PW_ControlGroup: true die Nachricht nicht.


      // Parameter für Frequency Capping. Stellen Sie sicher, dass das globale Frequency Capping im Control Panel konfiguriert ist.
      // Frequency Capping gilt nicht für transaktionale Nachrichten.
      // In allen anderen Fällen, einschließlich des weggelassenen "message_type", gilt das Frequency Capping.
      "capping_days": 30,               // optional. Anzahl der Tage für das Frequency Capping (max. 30 Tage)
      "capping_count": 10,              // optional. Die maximale Anzahl von Pushes, die von einer
                                        //           spezifischen App an ein bestimmtes Gerät innerhalb eines 'capping_days'-
                                        //           Zeitraums gesendet werden können. Falls die erstellte Nachricht das
                                        //           'capping_count'-Limit für ein Gerät überschreitet, wird sie nicht
                                        //           an dieses Gerät gesendet.
      "capping_exclude": true,          // optional. Wenn auf true gesetzt, wird diese Push-Benachrichtigung nicht
                                        //           für das Capping zukünftiger Pushes gezählt.
      "capping_avoid": true,            // optional. Wenn auf true gesetzt, wird das Capping nicht auf
                                        //           diese spezifische Push-Benachrichtigung angewendet.


      // Um die Nachricht über die API im Posteingang zu speichern, verwenden Sie "inbox_date" oder "inbox_image".
      // Die Nachricht wird gespeichert, wenn mindestens einer dieser Parameter verwendet wird.
      "inbox_date": "2017-02-02",       // optional. Geben Sie an, wann eine Nachricht aus dem Posteingang entfernt werden soll.
                                        //           Die Nachricht wird am angegebenen Datum um 00:00:01 UTC
                                        //           aus dem Posteingang entfernt, sodass der vorherige Tag der
                                        //           letzte Tag ist, an dem ein Benutzer die Nachricht in seinem Posteingang sehen kann.
                                        //           Wenn nicht angegeben, ist das Standard-Entfernungsdatum der
                                        //           nächste Tag nach dem Sendedatum.
      "inbox_image": "Inbox image URL", // optional. Das Bild, das neben der Nachricht angezeigt werden soll.
    "inbox_days": 5,                  // optional. Geben Sie an, wann eine Nachricht aus dem
                                        //           Posteingang entfernt werden soll (Lebensdauer einer Posteingangsnachricht in Tagen).
                                        //           Kann anstelle des Parameters "inbox_date" verwendet werden.
                                        //           Bis zu 30 Tage.


      "devices": [                      // optional. Geben Sie Tokens oder HWIDs an, um gezielte Push-
          "hwid_XXXX"                   //           Benachrichtigungen zu senden. Nicht mehr als 1000 Tokens/HWIDs in
      ],                                //           einem Array. Wenn gesetzt, wird die Nachricht nur an
                                        //           die Geräte auf der Liste gesendet. Eine Anwendungsgruppe für die Geräteliste
                                        //           ist nicht zulässig. iOS-Push-Tokens dürfen nur in Kleinbuchstaben sein.
      "to": [                           // optional. Für E-Mail, SMS und ähnliche Kanäle. Liste der Empfänger
          "email_1", "email_2"          //           (z. B. E-Mail-Adressen, Telefonnummern). Max. 1000 Elemente.
      ],                                //           Für Push verwenden Sie stattdessen "devices".
      // Benutzerzentrierte Push-Benachrichtigungen
      "users": [                        // optional. Wenn gesetzt, wird die Nachricht nur an die
          "user_XXXX"                   //           angegebenen Benutzer-IDs zugestellt (gesetzt über den /registerUser-Aufruf).
      ],                                //           Wenn zusammen mit "devices" oder "to" angegeben,
                                        //           wird letzteres ignoriert. Nicht mehr als 1000 Benutzer-
                                        //           IDs in einem Array. Eine Anwendungsgruppe für die Benutzerliste
                                        //           ist nicht zulässig.


      // Filter und Bedingungen
      "filter": "FILTER_NAME",          // optional.
      "conditions": [                   // optional. Siehe die Anmerkung unten.
        ["Country", "EQ", "fr"],
        ["Language", "EQ", "en"]
      ],
      "conditions_operator": "AND"      // optional. Logischer Operator für Bedingungs-Arrays.
                                        //           Mögliche Werte: AND | OR. AND ist der Standardwert.
    }]
  }
}

Anforderungsbeispiel für VoIP-Benachrichtigung

Anchor link to

Pushwoosh unterstützt Anrufbenachrichtigungen im VoIP-Stil für iOS und Android.
Nachfolgend finden Sie Beispiel-API-createMessage-Anfragen für jede Plattform.

iOS

Anchor link to
Beispiel
{
  "request": {
    "application": "XXXXX-XXXXX",     // erforderlich. Pushwoosh-Anwendungscode.
    "auth": "yxoPUlwqm…………pIyEX4H",   // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel.
    "notifications": [
      {
        "voip_push": true,            // erforderlich. Der Parameter ist erforderlich, um eine VoIP-Push-Benachrichtigung zu senden.
        "ios_root_params": {
          "aps": {
            "mutable-content": 1      // erforderlich für iOS10+ Medienanhänge.
          },
          "callerName": "CallerName", // optional. Name des Anrufers. Wenn nicht angegeben, wird "unbekannter Anrufer" angezeigt.
          "video": true,              // optional. Gibt an, ob Videoanrufe unterstützt werden.
          "supportsHolding": true,    // optional. Gibt an, ob die Anklopffunktion unterstützt wird.
          "supportsDTMF": false,      // optional. Steuert die Unterstützung von Dual-Tone Multi-Frequency-Signalen.
          "callId": "42",             // optional. Der eindeutige Identifikator des abzubrechenden Anrufs.
          "cancelCall": true          // optional. Auf "true" setzen, um den Anruf mit der angegebenen "callId" abzubrechen.
        }
      }
    ]
  }
}

Android

Anchor link to
Beispiel
{
  "request": {
    "application": "XXXXX-XXXXX",   // erforderlich. Pushwoosh-Anwendungscode.
    "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel.
    "notifications": [
      {
      "voip_push": true,            // erforderlich. Der Parameter ist erforderlich, um eine VoIP-Push-Benachrichtigung zu senden.
      "android_root_params": {
        "callerName": "callerName", // optional. Name des Anrufers. Wenn nicht angegeben, wird "unbekannter Anrufer" angezeigt.
        "video": true,              // optional. Gibt an, ob Videoanrufe unterstützt werden.
        "callId": 42,               // optional. Der eindeutige Identifikator des abzubrechenden Anrufs.
        "cancelCall": true          // optional. Auf "true" setzen, um den Anruf mit der angegebenen "callId" abzubrechen.
        }
      }
    ]
  }
}

Plattformspezifische Parameter

Anchor link to

iOS-Parameter

Anchor link to
Beispiel
{
  "request": {
    "application": "12345-67891",         // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H",       // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "ios_title": {                      // optional. Objekt ODER Zeichenfolge. Fügt einen iOS-spezifischen Titel für die Push-Benachrichtigung hinzu.
        "en": "title"
      },
      "ios_subtitle": {                   // optional. Objekt ODER Zeichenfolge. Fügt einen iOS-spezifischen Untertitel für die Push-Benachrichtigung hinzu.
        "en": "subtitle"
      },
      "ios_content": {                    // optional. Objekt ODER Zeichenfolge. Fügt iOS-spezifischen Inhalt für die Push-Benachrichtigung hinzu.
        "en": "content"
      },
      "ios_badges": 5,                    // optional. iOS-Anwendungs-Badge-Nummer.
                                          //           Verwenden Sie "+n" oder "-n", um den Badge-Wert um n zu erhöhen/verringern.
      "ios_sound": "sound file.wav",      // optional. Name der Sounddatei im Haupt-Bundle der Anwendung.
                                          //           Wenn leer gelassen, erzeugt das Gerät einen Standard-Systemton.
      "ios_sound_off": true,              // optional. Aktivieren/Deaktivieren des durch das Feld "ios_sound" festgelegten Tons.
      "ios_ttl": 3600,                    // optional. Time-to-Live-Parameter - maximale Lebensdauer der Nachricht in Sekunden.
      "ios_silent": 1,                    // optional. Aktiviert stille Benachrichtigungen (ignoriert "sound" und "content").
      "ios_category_id": "1",             // optional. iOS8-Kategorie-ID von Pushwoosh.
      "ios_root_params": {                // optional. Parameter auf Root-Ebene für das aps-Dictionary.
        "aps": {
          "content-available": "0",       // optional. Setzen Sie "1", um einen stillen Push zu senden, und "0" für einen regulären Push.
          "mutable-content": 1            // erforderlich für iOS10+ Medienanhänge.
        },
        "callerName": "CallerName",       // optionaler VoIP-Parameter. Name des Anrufers. Wenn nicht angegeben, wird "unbekannter Anrufer" angezeigt.
        "video": true,                    // optionaler VoIP-Parameter. Gibt an, ob Videoanrufe unterstützt werden.
        "supportsHolding": true,          // optionaler VoIP-Parameter. Gibt an, ob die Anklopffunktion unterstützt wird.
        "supportsDTMF": false,            // optionaler VoIP-Parameter. Steuert die Unterstützung von Dual-Tone Multi-Frequency-Signalen.
        "data": {}                        // optional. Vom Benutzer bereitgestellte Daten, max. 4 KB
      },
      "ios_attachment": "URL",            // optional. Medieninhalte in die Benachrichtigung einfügen.
      "ios_thread_id": "some thread id",  // optional. Kennung zum Gruppieren verwandter Benachrichtigungen.
                                          //           Nachrichten mit derselben Thread-ID werden
                                          //           auf dem Sperrbildschirm und im Benachrichtigungscenter gruppiert.
      "ios_critical": true,               // optional. Markiert die iOS-Benachrichtigung als kritischen Alarm,
                                          //           der auch dann einen Ton abspielt, wenn ein Gerät stummgeschaltet ist oder
                                          //           der „Nicht stören“-Modus aktiviert ist.
      "ios_category_custom": "category",  // optional. Benutzerdefinierte APNS-Kategorie.
      "ios_interruption_level": "active", // optional. Einer von "passive", "active", "time-sensitive",
                                          //           "critical". Gibt die Wichtigkeit und
                                          //           den Zustellungszeitpunkt einer Benachrichtigung an. Details finden Sie im
                                          //           Leitfaden für einmalige Push-Benachrichtigungen.
      "apns_collapse_id": "promo",        // optional. APNs-Collapse-Identifier. Benachrichtigungen mit demselben
                                          //           apns_collapse_id ersetzen sich gegenseitig auf dem Gerät.
      "apns_trim_content": 1              // optional. (0|1) Kürzt die überschüssigen Inhaltszeichenfolgen mit Ellipsen.
    }]
  }
}

Android-Parameter

Anchor link to
Beispiel
{
  "request": {
    "application": "12345-67891",            // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H",          // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "android_header": {                    // optional. Android-Benachrichtigungs-Header.
        "en": "header"
      },
      "android_content": {                   // optional. Android-Benachrichtigungsinhalt.
        "en": "content"
      },
      "android_root_params": {               // optional. Benutzerdefiniertes Schlüssel-Wert-Objekt.
        "key": "value",                      //           Parameter auf Root-Ebene für die Android-Payload-Empfänger.
        "CancelID": 12345678,                // optional. Bricht die Push-Benachrichtigung mit der
        "voip": true,                        // erforderlicher VoIP-Parameter. Der Parameter ist erforderlich, um VoIP-Push-Benachrichtigungen zu senden.
        "callerName": "callerName",          // optionaler VoIP-Parameter. Name des Anrufers. Wenn nicht angegeben, wird "unbekannter Anrufer" angezeigt.
        "video": true,                       // optionaler VoIP-Parameter. Gibt an, ob Videoanrufe unterstützt werden.
      },                                     //           angegebenen Nachrichten-ID ab (ID aus dem Nachrichtenverlauf abrufen)
      "android_sound": "soundfile",          // optional. Keine Dateierweiterung. Wenn leer gelassen,
                                             //           erzeugt das Gerät einen Standard-Systemton.
      "android_sound_off": true,             // optional. Aktivieren/Deaktivieren des durch das Feld "android_sound" festgelegten Tons
      "android_icon": "icon.png",            // optional.
      "android_custom_icon": "URL.png",      // optional. Vollständige URL zur Bilddatei.
      "android_banner": "URL.png",           // optional. Vollständige URL zur Bilddatei.
      "android_badges": 5,                   // optional. Android-Anwendungssymbol-Badge-Nummer.
                                             //           Verwenden Sie "+n" oder "-n", um den Badge-Wert um n zu erhöhen/verringern.
      "android_gcm_ttl": 3600,               // optional. Time-to-Live-Parameter – maximale Lebensdauer der Nachricht in Sekunden.
      "android_vibration": 0,                // optional. Android-Vibrationserzwingung für hochpriorisierte Pushes.
      "android_led": "#rrggbb",              // optional. LED-Hex-Farbe, das Gerät wird sein Bestes tun, um sich anzunähern.
      "android_priority": -1,                // optional. Setzt den "importance"-Parameter für Geräte mit
                                             //           Android 8.0 und höher sowie den "priority"-Parameter
                                             //           für Geräte mit Android 7.1 und niedriger. Legt die
                                             //           Unterbrechungsstufe eines Benachrichtigungskanals oder einer bestimmten
                                             //           Benachrichtigung fest. Gültige Werte sind -2, -1, 0, 1, 2.
      "android_delivery_priority": "normal", // optional. "normal" oder "high".
                                             //           Ermöglicht die Zustellung von Benachrichtigungen, wenn das
                                             //           Gerät im Energiesparmodus ist.
      "android_ibc": "#RRGGBB",              // optional. Symbolhintergrundfarbe auf Lollipop, #RRGGBB,
                                             //           #AARRGGBB, "red", "black", "yellow", etc.
      "android_silent": 1,                   // optional. 0 oder 1. Stille Benachrichtigung aktivieren.
                                             //           Ton und Inhalt ignorieren
      "android_group_id": "123",             // optional. Kennung zum Gruppieren verwandter Benachrichtigungen. Nachrichten mit
                                             //           derselben Thread-ID werden im
                                             //           Benachrichtigungscenter gruppiert.
      "android_collapse_key": "promo"        // optional. FCM-Collapse-Key. Benachrichtigungen mit demselben
                                             //           Collapse-Key ersetzen sich gegenseitig, während das Gerät offline ist.
    }]
  }
}

Huawei-Parameter

Huawei
{
  "request": {
    "application": "12345-67891",                   // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H",                 // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "huawei_android_header": {                    // optional. Objekt ODER Zeichenfolge. Benachrichtigungstitel
        "en": "header"
      },
      "huawei_android_content": {                   // optional. Objekt ODER Zeichenfolge. Benachrichtigungsinhalt
        "en": "content"
      },
      "huawei_android_badges": true,                // optional.
      "huawei_android_silent": 0,                   // optional. 0 oder 1. Stille Benachrichtigung aktivieren.
                                                    //           Ton und Inhalt ignorieren
      "huawei_android_icon": "URL.png",             // optional.
      "huawei_android_led": "#FF0011",              // optional. LED-Hex-Farbe, das Gerät wird sein Bestes tun, um sich anzunähern
      "huawei_android_vibration": 1,                // optional. Huawei-Vibrationserzwingung für hochpriorisierte Pushes
      "huawei_android_sound": "sound.wav",          // optional. Wenn leer gelassen, erzeugt das Gerät
                                                    //           einen Standard-Systemton
      "huawei_android_sound_off": true,             // optional. Aktivieren/Deaktivieren des durch das
                                                    //           Feld "huawei_android_sound" festgelegten Tons
      "huawei_android_custom_icon": "URL.png",      // optional
      "huawei_android_gcm_ttl": 2400,               // optional. Time-to-Live-Parameter - maximale
                                                    //           Lebensdauer der Nachricht in Sekunden
      "huawei_android_banner": "URL.png",           // optional. Vollständiger Pfad-URL zur Bilddatei
      "huawei_android_root_params": {               // optional. Benutzerdefiniertes Schlüssel-Wert-Objekt.
        "key": "value"                              //           Parameter auf Root-Ebene für Huawei-Payload-Empfänger.
      },
      "huawei_android_priority": 0,                 // optional. Gültige Werte: -2, -1, 0, 1, 2
      "huawei_android_ibc": "#0011AA",              // optional. Symbolhintergrundfarbe auf Lollipop
      "huawei_android_lockscreen": 1,               // optional
      "huawei_android_delivery_priority": "normal", // optional. "normal" oder "high". Ermöglicht die Benachrichtigungs-
                                                    //           zustellung im Energiesparmodus
      "huawei_android_group_id": "group_id"         // optional. Kennung zum Gruppieren verwandter Benachrichtigungen
    }]
  }
}

Safari-Parameter

Anchor link to
Safari
{
  "request": {
    "application": "12345-67891",    // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H",  // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "safari_url_args": [           // erforderlich, aber der Wert kann leer sein
        "firstArgument",
        "secondArgument"
      ],
      "safari_title": {              // optional. Objekt ODER Zeichenfolge. Titel der Benachrichtigung.
        "en": "content"
      },
      "safari_content": {            // optional. Objekt ODER Zeichenfolge. Inhalt der Benachrichtigung.
        "en": "content"
      },
      "safari_action": "Click here", // optional.
      "safari_ttl": 3600             // optional. Time-to-Live-Parameter – die maximale
                                     //           Lebensdauer einer Nachricht in Sekunden.
    }]
  }
}

Chrome-Parameter

Anchor link to
Chrome
{
  "request": {
    "application": "12345-67891",          // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H",        // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "chrome_title": {                    // optional. Objekt ODER Zeichenfolge. Sie können den Header
        "en": "title"                      //           der Nachricht in diesem Parameter angeben.
      },
      "chrome_content": {                  // optional. Objekt ODER Zeichenfolge. Sie können den Inhalt
        "en": "content"                    //           der Nachricht in diesem Parameter angeben.
      },
      "chrome_icon": "URL.png",            // optional. Vollständige URL zum Symbol oder Dateipfad zu den Erweiterungsressourcen
      "chrome_gcm_ttl": 3600,              // optional. Time-to-Live-Parameter – maximale Lebensdauer der Nachricht in Sekunden.
      "chrome_duration": 20,               // optional. max. 50 Sekunden. Ändert die Anzeigezeit von Chrome-Pushes.
                                           //           Auf 0 setzen, um den Push anzuzeigen, bis der Benutzer damit interagiert.
      "chrome_image": "image_URL",         // optional. URL zu einem großen Bild.
      "chrome_root_params": {              // optional. Setzen Sie spezifische Parameter für Nachrichten, die an Chrome gesendet werden.
        "key": "value"
      },
      "chrome_button_text1": "text1",      // optional
      "chrome_button_url1": "button1_URL", // optional. Wird ignoriert, wenn chrome_button_text1 nicht gesetzt ist.
      "chrome_button_text2": "text2",      // optional
      "chrome_button_url2": "button2_url"  // optional. Wird ignoriert, wenn chrome_button_text2 nicht gesetzt ist.
    }]
  }
}

Firefox-Parameter

Anchor link to
Firefox
{
  "request": {
    "application": "12345-67891",   // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "firefox_title": {            // optional. Objekt ODER Zeichenfolge. Sie können hier den Nachrichten-Header angeben.
        "en": "title"
      },
      "firefox_content": {          // optional. Objekt ODER Zeichenfolge. Sie können hier den Nachrichteninhalt angeben.
        "en": "content"
      },
      "firefox_icon": "URL.png",    // optional. Vollständiger Pfad-URL zum Symbol oder Pfad zur
                                    //           Datei in den Erweiterungsressourcen.
      "firefox_root_params": {      // optional. Setzen Sie spezifische Parameter für Nachrichten, die an Firefox gesendet werden.
        "key": "value"
      }
    }]
  }
}

Amazon-Parameter

Anchor link to
Amazon
{
  "request": {
    "application": "12345-67891",   // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "adm_header": {               // optional. Objekt ODER Zeichenfolge. Sie können hier den Nachrichten-Header angeben.
        "en": "header"
      },
      "adm_content": {              // optional. Objekt ODER Zeichenfolge. Sie können hier den Nachrichteninhalt angeben.
        "en": "content"
      },
      "adm_root_params": {          // optional. Benutzerdefiniertes Schlüssel-Wert-Objekt
        "key": "value"
      },
      "adm_sound": "push.mp3",      // optional.
      "adm_sound_off": true,        // optional. Aktivieren/Deaktivieren des durch das Feld "adm_sound" festgelegten Tons
      "adm_icon": "icon.png",       // optional. Vollständige URL zum Symbol.
      "adm_custom_icon": "URL.png", // optional.
      "adm_banner": "URL.png",      // optional.
      "adm_ttl": 3600,              // optional. Time-to-Live-Parameter – die maximale Lebensdauer
                                    //           der Nachricht in Sekunden.
      "adm_priority": -1            // optional. Priorität des Pushs in der Amazon-Push-Schublade,
                                    //           gültige Werte sind -2, -1, 0, 1 und 2.
    }]
  }
}

Mac OS X-Parameter

Anchor link to
Mac OS X
{
  "request": {
    "application": "12345-67891",   // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "mac_title": {                // optional. Objekt ODER Zeichenfolge. Fügt einen Titel für die Push-Benachrichtigung hinzu.
        "en": "title"
      },
      "mac_subtitle": {             // optional. Fügt einen Untertitel für die Push-Benachrichtigung hinzu.
        "en": "subtitle"
      },
      "mac_content": {              // optional. Fügt Inhalt für die Push-Benachrichtigung hinzu.
        "en": "content"
      },
      "mac_badges": 3,              // optional.
      "mac_sound": "sound.caf",     // optional.
      "mac_sound_off": true,        // optional. Aktivieren/Deaktivieren des durch das Feld "mac_sound" festgelegten Tons
      "mac_root_params": {          // optional.
        "content-available": 1
      },
      "mac_ttl": 3600               // optional. Time-to-Live-Parameter – maximale Lebensdauer der Nachricht in Sekunden.
    }]
  }
}

Windows-Parameter

Anchor link to
Windows
{
  "request": {
    "application": "12345-67891",   // erforderlich. Pushwoosh-Anwendungscode
    "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "notifications": [{
      "wns_content": {              // erforderlich. Inhalt (XML oder roh) der Benachrichtigung, kodiert in MIME's base64
                                    //           in Form von Objekt ODER Zeichenfolge
        "en": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48YmFkZ2UgdmFsdWU9ImF2YWlsYWJsZSIvPg==",
        "de": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48YmFkZ2UgdmFsdWU9Im5ld01lc3NhZ2UiLz4="
      },
      "wns_type": "Badge",          // optional. 'Tile' | 'Toast' | 'Badge' | 'Raw'
      "wns_tag": "myTag",           // optional. Wird in der Kachel-Ersetzungsrichtlinie verwendet.
                                    //           Eine alphanumerische Zeichenfolge von nicht mehr als 16 Zeichen.
      "wns_cache": 1,               // optional. (1|0) Übersetzt in den Wert von X-WNS-Cache-Policy.
      "wns_ttl": 600                // optional. Ablaufzeit für die Benachrichtigung in Sekunden.
    }]
  }
}

Antwort:

HTTP-Statuscodestatus_codeBeschreibung
200200Nachricht erfolgreich erstellt
200210Argumentfehler. Siehe status_message für weitere Informationen
400N/AFehlerhafte Anforderungszeichenfolge
500500Interner Fehler

API-Nachrichtenverfolgung

Anchor link to

Aus Gründen des Lastausgleichs speichern wir keine Nachrichten, die über die API mit dem „devices“-Parameter gesendet werden, der weniger als 10 Geräte in einem Array enthält. Aus diesem Grund werden solche Nachrichten nicht in Ihrem Nachrichtenverlauf angezeigt.

Um Push-Berichte während der Testphase zu sehen, verwenden Sie die API-Nachrichtenverfolgung. Wenn Sie diese Option EINschalten, können Sie dieses Limit für 1 Stunde außer Kraft setzen und solche Push-Benachrichtigungen im Nachrichtenverlauf speichern. Die API-Nachrichtenverfolgung schaltet sich nach 1 Stunde automatisch AUS.

Die API-Nachrichtenverfolgung kann auf der Seite Nachrichtenverlauf aktiviert werden, indem Sie oben rechts auf API-Nachrichtenverfolgung starten klicken.

Tag-Bedingungen

Anchor link to

Jede Tag-Bedingung ist ein Array wie [tagName, operator, operand], wobei

  • tagName: Name eines Tags
  • operator: “EQ” | “IN” | “NOTEQ” | “NOTIN” | “LTE” | “GTE” | “BETWEEN” | “NOTSET” | “ANY”
  • operand: Zeichenfolge | Ganzzahl | Array | Datum

Operatorbeschreibung

Anchor link to
  • EQ: Tag-Wert ist gleich dem Operanden;
  • IN: Tag-Wert überschneidet sich mit dem Operanden (Operand muss immer ein Array sein);
  • NOTEQ: Tag-Wert ist nicht gleich einem Operanden;
  • NOTIN: Tag-Wert überschneidet sich nicht mit dem Operanden (Operand muss immer ein Array sein);
  • GTE: Tag-Wert ist größer oder gleich dem Operanden;
  • LTE: Tag-Wert ist kleiner oder gleich dem Operanden;
  • BETWEEN: Tag-Wert ist größer oder gleich dem min-Operandenwert, aber kleiner oder gleich dem max-Operandenwert (Operand muss immer ein Array sein);
  • NOTSET: Tag nicht gesetzt. Operand wird nicht berücksichtigt;
  • ANY: Tag hat einen beliebigen Wert. Operand wird nicht berücksichtigt.

String-Tags

Anchor link to

Gültige Operatoren: EQ, IN, NOTEQ, NOTIN, NOTSET, ANY
Gültige Operanden:

  • EQ, NOTEQ: Operand muss eine Zeichenfolge sein;
  • IN, NOTIN: Operand muss ein Array von Zeichenfolgen sein wie ["value 1", "value 2", "value N"];
  • NOTSET: Tag nicht gesetzt. Operand wird nicht berücksichtigt;
  • ANY: Tag hat einen beliebigen Wert. Operand wird nicht berücksichtigt.

Integer-Tags

Anchor link to

Gültige Operatoren: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY
Gültige Operanden:

  • EQ, NOTEQ, GTE, LTE: Operand muss eine Ganzzahl sein;
  • IN, NOTIN: Operand muss ein Array von Ganzzahlen sein wie [value 1, value 2, value N];
  • BETWEEN: Operand muss ein Array von Ganzzahlen sein wie [min_value, max_value];
  • NOTSET: Tag nicht gesetzt. Operand wird nicht berücksichtigt;
  • ANY: Tag hat einen beliebigen Wert. Operand wird nicht berücksichtigt.

Datums-Tags

Anchor link to

Gültige Operatoren: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY
Gültige Operanden:

  • "YYYY-MM-DD 00:00" (Zeichenfolge)
  • Unix-Zeitstempel 1234567890 (Ganzzahl)
  • "N days ago" (Zeichenfolge) für die Operatoren EQ, BETWEEN, GTE, LTE

Boolesche Tags

Anchor link to

Gültige Operatoren: EQ, NOTSET, ANY
Gültige Operanden: 0, 1, true, false

Listen-Tags

Anchor link to

Gültige Operatoren: IN, NOTIN, NOTSET, ANY
Gültige Operanden: Operand muss ein Array von Zeichenfolgen sein wie ["value 1", "value 2", "value N"].

/createMessage-Snippets

Anchor link to

Beispiel /createMessage-Anfragen:

#!/bin/bash


#Usage
if [ ! -n "$1" ] || [ ! -n "$2" ]
then
  echo "`basename $0` usage: api_token appid message";
  exit 1;
fi;
MESSAGE="$3";
if [ -z "$3" ]
then
MESSAGE='One push to rule them all!'
fi;


echo -e "Response:"
curl --data-binary "
{\"request\":
    {\"application\":\"$2\",
     \"auth\":\"$1\",
     \"notifications\":
        [{
                        \"send_date\": \"now\",
            \"content\": \"$MESSAGE\"
        }]
    }
}" \
-H "Content-type: application/json" \
"https://api.pushwoosh.com/json/1.3/createMessage"
echo "";
exit 0;

deleteMessage

Anchor link to

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

Löscht eine Nachricht, unabhängig davon, ob sie noch geplant ist oder bereits gesendet wurde. Bei einer geplanten Nachricht wird diese auch sofort aus dem Nachrichtenverlauf entfernt – bei einer bereits gesendeten Nachricht beachten Sie die nachstehende Warnung.

Nachfolgesendungen, die aus der Nachricht mit Erneut an Nicht-Öffner senden erstellt wurden, sind nicht betroffen – löschen oder stornieren Sie jede davon separat.

Verwenden Sie stattdessen /cancelMessage, wenn Sie das Senden stoppen, aber die Nachricht im Nachrichtenverlauf mit dem Status canceled behalten möchten.

Anforderungskörper

Anchor link to
NameTypBeschreibung
auth*stringAPI-Zugriffstoken aus dem Pushwoosh Control Panel.
message*stringNachrichtencode, der in der /createMessage-Anfrage erhalten wurde.
{
  "status_code": 200,
  "status_message": "OK"
}
Beispiel
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H",  // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "message": "xxxx-xxxxxxx-xxxxxx" // erforderlich. Nachrichtencode, der in /createMessage erhalten wurde
  }
}

Statuscodes:

HTTP-Statuscodestatus_codeBeschreibung
200200Nachricht erfolgreich gelöscht
200210Argumentfehler, z. B. befindet sich die Nachricht noch im Status creating. Siehe status_message für weitere Informationen
400N/AFehlerhafte Anforderungszeichenfolge
500500Interner Fehler
<?php
// see https://gomoob.github.io/php-pushwoosh/delete-message.html
use Gomoob\Pushwoosh\Model\Request\DeleteMessageRequest;


// creates request instance
$request = DeleteMessageRequest::create()->setMessage('MESSAGE_CODE');


// call '/deleteMessage' Web Service
$response = $pushwoosh->deleteMessage($request);


if($response->isOk()) {
    print 'Great, my message has been deleted !';
} else {
    print 'Oups, the deletion failed :-(';
    print 'Status code : ' . $response->getStatusCode();
    print 'Status message : ' . $response->getStatusMessage();
}

getMessageDetails

Anchor link to

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

Ruft die Nachrichtendetails ab.

Anforderungskörper

Anchor link to
NameTypBeschreibung
auth*stringAPI-Zugriffstoken aus dem Pushwoosh Control Panel.
message*stringNachrichtencode oder Nachrichten-ID.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "message": {
      "id": 2068991743,
      "created": "2016-09-14 17:19:42",
      "send_date": "2016-09-14 17:19:41",
      "status": "done",
      "content": {
        "en": "Hello {Name|CapitalizeFirst|friend}! 🚀"
      },
      "platforms": "[1]",
      "ignore_user_timezone": "1",
      "code": "XXXX-92B4C3C5-A7F5EF70",
      "data": {
        "key": "value"
      }
    }
  }
}
Beispiel
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H",  // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "message": "xxxx-xxxxxxx-xxxxxx" // erforderlich. Nachrichtencode oder Nachrichten-ID
  }
}

createTargetedMessage Veraltet

Anchor link to

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

Erstellt eine neue gezielte Push-Benachrichtigung.

Anforderungskörper

Anchor link to
NameTypBeschreibung
auth*stringAPI-Zugriffstoken aus dem Pushwoosh Control Panel.
devices_filter*stringSiehe Anmerkung unten.
send_date*stringYYYY-MM-DD HH:mm oder ‘now’.
ignore_user_timezonebooleanWenn ignoriert, ist UTC-0 Standard für “send_date”.
timezonestringWenn ignoriert, ist UTC-0 Standard für “send_date”.
campaignstringCode einer Kampagne, der Sie diese Push-Nachricht zuweisen möchten.
content*stringBenachrichtigungsinhalt. Details finden Sie im Anforderungsbeispiel.
transactionIdstringEindeutiger Nachrichtenidentifikator, um das Duplizieren von Nachrichten im Falle von Netzwerkproblemen zu verhindern. Wird auf der Seite von Pushwoosh für 5 Minuten gespeichert.
linkstringLink, der geöffnet wird, sobald ein Benutzer eine Push-Nachricht öffnet.
minimize_linkinteger0 - nicht minimieren, 2 - bit.ly. Standard = 2.
dataobjectJSON-Zeichenfolge oder JSON-Objekt. Wird als “u”-Parameter in der Payload übergeben (in JSON-Zeichenfolge konvertiert).
presetstringPreset-Code.
send_rateintegerDrosselung. Gültige Werte sind von 100 bis 1000 Pushes pro Sekunde.
inbox_datestringGeben Sie an, wann eine Nachricht aus dem Posteingang entfernt werden soll.
inbox_imagestringURL des Bildes, das neben der Nachricht im Posteingang angezeigt werden soll.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "messageCode": "97B0-C7473871-2FBDFDC6"
  }
}

Weitere Antwortbeispiele:

{
  "status_code": 210,
  "status_message": "Errors occurred while compiling filter",
  "response": {
    "errors": [{
      "message": "Invalid tag set specification. \")\" expected.",
      "type": "syntax"
    }]
  }
}
Beispiel
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",    // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "devices_filter": "A(\"XXXXX-XXXXX\") * T(\"City\", EQ, \"Name\")", // erforderlich. Syntax unten erklärt
    "send_date": "now",                // optional. YYYY-MM-DD HH:mm ODER 'now'
    "ignore_user_timezone": true,      // optional.
    "timezone": "America/New_York",    // optional. Wenn ignoriert, ist UTC-0 Standard für "send_date".
                                       //           Weitere Informationen https://php.net/manual/timezones.php.
    "campaign": "CAMPAIGN_CODE",       // optional. Kampagnencode, dem Sie diese Push-Nachricht zuweisen möchten.
    "content": {                       // optional. Objekt ODER Zeichenfolge. Verwenden Sie stattdessen "wns_content" für Windows.
      "en": "English",
      "de": "Deutsch"
    },
    "transactionId": "unique UUID",    // optional. Eindeutiger Nachrichtenidentifikator, um das Duplizieren von Nachrichten
                                       //           im Falle von Netzwerkproblemen zu verhindern. Wird auf der Seite von
                                       //           Pushwoosh für 5 Minuten gespeichert.
    "rich_media": "XXXXX-XXXXX",       // optional. Kopieren Sie den Rich-Media-Code aus der URL-Leiste der
                                       //           Rich-Media-Editor-Seite im Pushwoosh Control Panel.
    "link": "https://google.com",      // optional. Für Deeplinks fügen Sie "minimize_link": 0 hinzu
    "minimize_link": 0,                // optional. 0 – nicht minimieren, 2 – bitly. Standard = 2.
                                       //           Der Google URL-Shortener ist seit dem 30. März 2019 deaktiviert.
                                       //           Bitte beachten Sie, dass Shortener Einschränkungen
                                       //           bezüglich der Anzahl der Aufrufe haben.
    "data": {                          // optional. JSON-Zeichenfolge oder JSON-Objekt.
      "key": "value"                   //           Wird als "u"-Parameter in der Payload übergeben
    },                                 //           (in JSON-Zeichenfolge konvertiert).
    "preset": "XXXXX-XXXXX",           // optional. Push-Preset-Code aus Ihrem Control Panel.
    "send_rate": 100,                  // optional. Drosselung. Gültige Werte sind von 100 bis 1000 Pushes/Sekunde.
    "dynamic_content_placeholders": {  // optional. Platzhalter für dynamische Inhalte anstelle von Geräte-Tags.
      "firstname": "John",
      "lastname": "Doe"
    },


    // Um die Nachricht über die API im Posteingang zu speichern, verwenden Sie "inbox_date" oder "inbox_image".
    // Die Nachricht wird gespeichert, wenn mindestens einer dieser Parameter verwendet wird.
    "inbox_image": "Inbox image URL",  // optional. Das Bild, das neben der Nachricht angezeigt werden soll.
    "inbox_date": "2017-02-02"         // optional. Geben Sie an, wann eine Nachricht aus dem Posteingang entfernt werden soll.
                                       //           Die Nachricht wird am angegebenen Datum um 00:00:01 UTC aus dem
                                       //           Posteingang entfernt, sodass der vorherige Tag der letzte
                                       //           Tag ist, an dem ein Benutzer die Nachricht in seinem Posteingang sehen kann.
                                       //           Wenn nicht angegeben, ist das Standard-Entfernungsdatum der nächste
                                       //           Tag nach dem Sendedatum.
  }
}

Die Grundlagen sind sehr einfach – alle Filter werden auf den Mengen von Entitäten ausgeführt.

Mengen

Anchor link to

Mengen sind definiert als:

1. Geräte, die die jeweilige App abonniert haben (A);
2. Geräte, die den angegebenen Tag-Werten (T) oder app-spezifischen Tag-Werten (AT) entsprechen;\

Syntax

Anchor link to

Versuchen wir es mit einigen Beispielen gemäß der obigen Liste.

Targeting von App-Abonnenten

Anchor link to

Der “A”-Filter definiert eine Menge von Geräten, die eine bestimmte App abonniert haben:

A("XXXXX-XXXXX", ["iOS", "Android", "OsX", "Windows", "Amazon", "Safari", "Chrome", "Firefox"])

wobei

  • “XXXXX-XXXXX” – Pushwoosh-Anwendungscode
  • [“iOS”, “Android”, …] – Array der Zielplattformen. Wenn weggelassen, wird die Nachricht an alle für diese App verfügbaren Plattformen gesendet.

Filtern nach Tag-Werten

Anchor link to

Der “T”-Filter definiert eine Menge von Geräten, denen bestimmte Tag-Werte zugewiesen sind.

T(\"Age\", IN, [17,20])

Definiert die Menge der Geräte, bei denen das Tag „age“ auf einen der Werte 17, 18, 19, 20 gesetzt ist.

Tag-Typen und Operatoren

Anchor link to

Es ist sehr wichtig zu verstehen, dass Tags zwischen den Apps geteilt werden, was ein sehr leistungsfähiges Instrument zur Segmentierung und Filterung Ihrer Zielbenutzer darstellt, ohne sich an eine bestimmte App zu binden.

Das Tag kann einer von drei verschiedenen Typen sein: String, Integer, List. Der Tag-Typ definiert, welche Operatoren Sie für ein bestimmtes Tag verwenden können.

String-Tags

Anchor link to

Anwendbare Operatoren:

  • EQ – zielt auf Geräte mit einem bestimmten Tag-Wert ab
  • IN – zielt auf Geräte mit einem der angegebenen Tag-Werte ab
  • NOTIN – zielt auf Geräte ohne angegebene Tag-Werte ab
  • NOTEQ – zielt auf Geräte mit einem Tag-Wert ab, der nicht dem angegebenen entspricht
  • NOTSET – zielt auf Geräte ohne Wert für ein bestimmtes Tag ab
  • ANY – zielt auf Geräte mit einem beliebigen Wert für ein bestimmtes Tag ab

Beispiele:

T (\"Age\", EQ, 30) – filtert Benutzer im Alter von 30 Jahren

T (\"favorite_color\", IN, [\"red\",\"green\",\"blue\"]) – filtert Benutzer, die Rot, Grün oder Blau als ihre Lieblingsfarbe gewählt haben.

T (\"Name", NOTSET, \"\") – zielt auf Geräte ohne Wert für das Name-Tag ab.

Sie können numerische Werte mit den String-Tags verwenden, aber solche Werte werden in eine Zeichenfolge konvertiert.

Integer-Tags

Anchor link to

Anwendbare Operatoren:

  • GTE – größer oder gleich einem angegebenen Wert
  • LTE– kleiner oder gleich einem angegebenen Wert
  • EQ – gleich einem angegebenen Wert
  • BETWEEN – zwischen den angegebenen min- und max-Werten
  • IN – einer der angegebenen Werte
  • NOTIN – keine angegebenen Werte einem Gerät zugewiesen
  • NOTEQ – Geräte mit einem Tag-Wert, der nicht dem angegebenen entspricht
  • NOTSET – Geräte ohne Wert für ein bestimmtes Tag
  • ANY – Geräte mit einem beliebigen Wert für ein bestimmtes Tag

Beispiele:

T (\"Level\", EQ, 14) – filtert nur Benutzer auf Level 14.

T (\"Level\", BETWEEN, [1,5) – filtert Benutzer auf den Levels 1, 2, 3, 4 und 5.

T (\"Level", GTE, 29) – zielt auf Benutzer ab, die mindestens Level 29 erreicht haben.

Listen-Tags

Anchor link to

Anwendbare Operatoren:

  • IN – Geräte mit einem der angegebenen Tag-Werte

Beispiel: T("Category", IN, ["breaking_news","business","politics"])

Datums-Tags

Anchor link to

Anwendbare Operatoren:

  • GTE – größer oder gleich einem angegebenen Wert
  • LTE– kleiner oder gleich einem angegebenen Wert
  • EQ – gleich einem angegebenen Wert
  • BETWEEN – zwischen den angegebenen min- und max-Werten
  • NOTEQ – Geräte mit einem Tag-Wert, der nicht dem angegebenen entspricht
  • NOTSET – Geräte ohne Wert für ein bestimmtes Tag
  • ANY – Geräte mit einem beliebigen Wert für ein bestimmtes Tag

Beispiele:

AT("7777D-322A7","Last Application Open", BETWEEN, ["2022-02-28", "2022-03-02"])

AT("7777D-322A7","Last Application Open", GTE, "90 days ago")

Operationen

Anchor link to
  • “+” – verbindet zwei Mengen (entspricht ODER)
  • “*” – schneidet zwei Mengen (entspricht UND)
  • “\” – subtrahiert eine Menge von einer anderen (entspricht NICHT)

Alle Operationen sind linksassoziativ. ”+” und ”*” haben die gleiche Priorität. "" hat eine höhere Priorität. Sie können Klammern verwenden, um die Prioritäten der Berechnungen zu definieren.

Beachten Sie, dass die “\”-Operation nicht kommutativ ist. A("12345-12345") \ A("67890-67890") ist nicht dasselbe wie A("67890-67890") \ A("12345-12345").

getPushHistory Veraltet

Anchor link to

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

Ruft den Nachrichtenverlauf mit Push-Details ab.

Anforderungskörper

Anchor link to
NameTypBeschreibung
auth*stringAPI-Zugriffstoken aus dem Pushwoosh Control Panel.
limitMessagesintegerBegrenzt die Anzahl der Nachrichten in einer Antwort. Mögliche Werte von 10 bis 1000.
sourcestringPush-Verlaufsquelle. Kann null sein oder: “CP”, “API”, “GeoZone”, “RSS”, “AutoPush”, “A/B Test”.
searchBystringMögliche Werte, nach denen gesucht werden kann. Kann null sein oder: “notificationID”, “notificationCode”, “applicationCode”, “campaignCode”.
valuestringSuchwert, der gemäß dem Feld “searchBy” festgelegt wird.
lastNotificationIDstringWird zur Paginierung verwendet. Letzte messageId aus dem vorherigen /getPushHistory-Aufruf. Details siehe unten.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "rows": [{
      "id": 10191611434,
      "code": "8071-07AD1171-77238AD1",
      "createDate": "2020-09-14 12:26:21",
      "sendDate": "2020-09-14 12:26:21",
      "content": {
        "en": "Hello!"
      },
      "url": null,
      "ios_title": null,
      "ios_subtitle": null,
      "ios_root_params": null,
      "android_header": null,
      "android_root_params": null,
      "conditions": null,
      "conditions_operator": "AND",
      "filter_code": "E3A64-A5F3C",
      "filter_conditions": "#In-app Purchase(≠0)",
      "filter_name": "Purchased something",
      "geozone": null,
      "campaignId": "",
      "campaignName": "",
      "subscription_segments": null,
      "open": {
        "C90C0-0E786": {
          "IOS": 0
        }
      },
      "sent": {
        "C90C0-0E786": {
          "IOS": 1
        }
      },
      "ctr": {
        "C90C0-0E786": 0
      }
    }, {
      "id": 10191609202,
      "code": "41CA-83F8E0D7-7A63822B",
      "createDate": "2020-09-14 12:25:55",
      "sendDate": "2020-09-14 12:25:55",
      "content": {
        "en": "Hi!"
      },
      "url": null,
      "ios_title": null,
      "ios_subtitle": null,
      "ios_root_params": null,
      "android_header": null,
      "android_root_params": null,
      "conditions": null,
      "conditions_operator": "AND",
      "filter_code": null,
      "filter_conditions": null,
      "filter_name": null,
      "geozone": null,
      "campaignId": "",
      "campaignName": "",
      "subscription_segments": {
        "2D732-BB981": "News"
      },
      "open": {
        "C90C0-0E786": {
          "CHROME": 0,
          "IOS": 0
        }
      },
      "sent": {
        "C90C0-0E786": {
          "CHROME": 1,
          "IOS": 2
        }
      },
      "ctr": {
        "C90C0-0E786": 0
      }
    }]
  }
}
Beispiel
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H",  // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "source": null,                  // optional. Mögliche Werte sind null, "CP", "API", "GeoZone",
                                     //           "RSS", "AutoPush", "A/B Test"
    "searchBy": "applicationCode",   // optional. Mögliche Werte sind "", "notificationID",
                                     //           "notificationCode", "applicationCode", "campaignCode"
    "value": "C8717-703F2",          // optional. Suchwert, der gemäß dem Feld "searchBy" festgelegt wird.
    "lastNotificationID": 0,         // optional. Wird zur Paginierung verwendet. Letzte messageId aus dem
                                     //           vorherigen /getPushHistory-Aufruf. Details siehe unten.
    "limitMessages": 1000            // optional. Möglicher Wert von 10 bis 1000.
  }
}

Diese Methode gibt 1000 Nachrichten aus dem Konto zurück, sortiert nach Nachrichten-ID. Um die zweite Seite zu erhalten, geben Sie die letzte Nachrichten-ID der vorherigen Antwort im Parameter lastNotificationId an.

Antwortdatentypen

Anchor link to
id -- int | 0
code -- string
createDate -- string  (date: %Y-%m-%d %H:%M:%S)
sendDate -- string  (date: %Y-%m-%d %H:%M:%S)
content -- array ( dict {lang: value} | list [])
title -- array ( dict {lang: value} | list [])
subtitle -- array ( dict {lang: value} | list [])
url -- string
ios_title -- string | array ( dict {lang: value} ) | null
ios_subtitle -- string | array ( dict {lang: value} ) | null
ios_root_params -- dict (JSON) | null
android_header -- string | array ( dict {lang: value} ) | null
android_root_params -- dict (JSON) | null
conditions -- list (JSON) | null
conditions_operator -- string | null
filter_code -- string | null
filter_name -- string | null
filter_conditions -- string | null
geozone -- string | null
campaignId -- string | ""
campaignName -- string | ""
subscription_segments (obsolete) -- list (JSON) | null
data -- dict (JSON) | null
open -- dict [dict [string: int]]  | ""   Example: 'open': {'AAAAA-BBBBB': {'IOS': 1, 'ANDROID': 1}}
sent -- dict [dict [string: int]]  | ""   Example: 'sent': {'AAAAA-BBBBB': {'IOS': 10, 'ANDROID': 10}}
ctr -- dict [string: int] | ""  Example: {'AAAAA-BBBBB': 1}
errors -- dict [string: int] | ""  Example: {'ANDROID': 1, 'IOS': 1}

cancelMessage

Anchor link to

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

Bricht das Senden einer geplanten Nachricht ab. Die Nachricht verbleibt im Nachrichtenverlauf mit dem Status canceled. Nachfolgesendungen, die daraus mit Erneut an Nicht-Öffner senden erstellt wurden, werden ebenfalls abgebrochen.

Verwenden Sie stattdessen /deleteMessage, wenn Sie möchten, dass die Nachricht aus dem Nachrichtenverlauf entfernt wird (siehe die Warnung dort zu bereits gesendeten Nachrichten).

Anforderungskörper

Anchor link to
NameTypBeschreibung
auth*stringAPI-Zugriffstoken aus dem Pushwoosh Control Panel.
message*stringDer Nachrichtencode, der in der /createMessage-Antwort erhalten wurde.
{
   "status_code":200,
   "status_message":"OK"
}
Beispiel
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H",  // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "message": "xxxx-xxxxxxx-xxxxxx" // erforderlich. Der Nachrichtencode, der in der /createMessage-Antwort erhalten wurde
  }
}

Statuscodes:

HTTP-Statuscodestatus_codeBeschreibung
200200Nachricht erfolgreich abgebrochen
200210Argumentfehler. Siehe status_message für weitere Informationen.
400N/AFehlerhafte Anforderungszeichenfolge
500500Interner Fehler