# /createMessage-Parameter Hier finden Sie die Beschreibungen der [`/createMessage`](/de/developer/api-reference/messages-api/#createmessage) API-Parameter. - [Erforderliche Parameter](#erforderliche-parameter) müssen enthalten sein, um eine `/createMessage` API-Anfrage erfolgreich zu senden und eine Push-Benachrichtigung zur angegebenen Zeit zu übertragen. - [Optionale Parameter](#optionale-parameter) ermöglichen es Ihnen, die Eigenschaften von Push-Benachrichtigungen anzupassen. ## Erforderliche Parameter Erforderliche Parameter müssen in [`/createMessage`](/de/developer/api-reference/messages-api/#createmessage) Anfragen zwingend verwendet werden. Andernfalls wird die Anfrage nicht übermittelt. ### application Eindeutiger Code einer in Ihrem Pushwoosh-Konto erstellten App. Der App-Code befindet sich in der oberen linken Ecke des Control Panels oder in der Antwort auf eine [`/createApplication`](/de/developer/api-reference/applications/#createapplication) Anfrage. Der App-Code ist ein durch Bindestriche getrennter Satz von 10 Zeichen (sowohl Buchstaben als auch Ziffern). Pushwoosh-Anwendungscode, der im Control Panel in der oberen linken Ecke angezeigt wird Wenn Sie eine App über die API erstellen, erhalten Sie einen App-Code in der Antwort auf Ihre [`/createApplication`](/de/developer/api-reference/applications/#createapplication) Anfrage. Um einen Code einer zuvor erstellten App über die API zu erhalten, rufen Sie [`/getApplications`](/de/developer/api-reference/applications/#getapplications) auf. In der Antwort auf die [`/getApplications`](/de/developer/api-reference/applications/#getapplications) Anfrage erhalten Sie die Liste aller in Ihrem Pushwoosh-Konto erstellten Apps mit ihren Namen und Codes. ### auth API-Zugriffstoken aus dem Pushwoosh Control Panel. Gehen Sie zu **Settings** → **API Access** und kopieren Sie ein Token, das Sie verwenden möchten, oder generieren Sie ein neues. Seite mit den API-Zugriffseinstellungen im Pushwoosh Control Panel, die API-Zugriffstoken anzeigt Geben Sie beim Generieren eines Zugriffstokens dessen Berechtigungen an. Aktivieren Sie die Kontrollkästchen für die Arten von Aktivitäten, für die Sie das API-Token verwenden möchten. Sie können app-spezifische API-Token erstellen, indem Sie die Kontrollkästchen für Anwendungen aktivieren. Dialog zur Generierung von API-Token mit Berechtigungen und Anwendungskontrollkästchen ### content Die Zeichenfolge oder das Objekt, das den Nachrichteninhalt definiert. Der Parameter "content", der mit einem Zeichenfolgenwert übermittelt wird, sendet dieselbe Nachricht an alle Empfänger. ```txt title="String" "content": "Hello world!", ``` JSON-Objekte werden zur Angabe von Inhalten mit [Dynamic Content](/de/developer/guides/personalization/dynamic-content/) verwendet, zum Beispiel für mehrsprachige Nachrichten. ```txt title="Object" "content": { "en": "Hello!", "es": "¡Hola!", "de": "Hallo!" }, ``` ### notifications Das JSON-Array der Push-Eigenschaften. Muss mindestens die erforderlichen Parameter `content` und `send_date` enthalten. Optionale Parameter zur Verwendung innerhalb des "notifications"-Arrays: * [campaign](#campaign) * [capping_days](#capping_days) * [capping_count](#capping_count) * [conditions](#conditions) * [data](#data) * [devices](#devices) * [dynamic_content](#dynamic_content) * [filter](#filter) * [ignore_user_timezone](#ignore_user_timezone) * [inbox_date](#inbox_date) * [inbox_image](#inbox_image) * [link](#link) * [minimize_link](#minimize_link) * [message_type](#message_type) * [platforms](#platforms) * [preset](#preset) * [rich_media](#rich_media) * [send_rate](#send_rate) * [timezone](#timezone) * [template_bindings](#template_bindings) * [transactionId](#transactionid) * [users](#users) ### send_date Datum und Uhrzeit, zu der die Nachricht gesendet wird. Kann ein beliebiges Datum und eine beliebige Uhrzeit im Format YYYY-MM-DD HH:mm oder 'now' sein. Wenn auf 'now' gesetzt, wird die Nachricht sofort nach Absenden der Anfrage gesendet. ## Optionale Parameter ### campaign Der Code einer Kampagne. Um einen Kampagnencode zu erhalten, gehen Sie zu **Statistics** → **Aggregated statistics** und wählen Sie die Kampagne aus, die Sie verwenden möchten. Der Kampagnencode ist am Ende der Seiten-URL im Format `XXXXX-XXXXX` sichtbar. **Beispiel:** **URL:** `https://app.pushwoosh.com/applications/AAAAA-AAAAA/statistics/aggregated-message?campaignCode=XXXXX-XXXXX` **Kampagnencode:** `XXXXX-XXXXX` Um eine Liste der Kampagnen mit ihren Codes zu erhalten, rufen Sie [`/getCampaigns`](/de/developer/api-reference/campaigns/#getcampaigns) auf. In der Antwort auf die `/getCampaigns`-Anfrage erhalten Sie die Liste aller für eine bestimmte App in Ihrem Pushwoosh-Konto erstellten Kampagnen mit ihren Codes, Namen und Beschreibungen. ### capping_days Zeitraum, der für das Frequency Capping angewendet werden soll, in Tagen (max. 30 Tage). Siehe [Frequency Capping](/de/product/messaging-channels/global-frequency-capping/) für Details. Frequency Capping wird nicht auf Nachrichten mit `message_type: transactional` angewendet. In allen anderen Fällen wird Frequency Capping angewendet, einschließlich Anfragen, bei denen `message_type` weggelassen wird. ### capping_count Die maximale Anzahl von Pushes, die von einer bestimmten 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. Siehe [Frequency Capping](/de/product/messaging-channels/global-frequency-capping/) für Details. ### conditions Bedingungen sind Arrays wie `[tagName, operator, operand]`, die zum Senden gezielter Nachrichten basierend auf [Tags](/de/developer/guides/audience-and-segmentation/tags/) und deren Werten verwendet werden, wobei: * tagName — der Name eines anzuwendenden Tags, * [operator](/de/developer/guides/audience-and-segmentation/tags#tag-operators) — ein Wertevergleichsoperator ("EQ" | "IN" | "NOTEQ" | "NOTIN" | "LTE" | "GTE" | "BETWEEN" | "NOTSET" | "ANY"), * [operand](/de/developer/guides/audience-and-segmentation/tags#tag-values) — Tag-Werte eines der folgenden Typen: string | integer | array | date | boolean | list #### Operatorbeschreibung | | | | -------- | ----------- | | **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 minimalen Operandenwert, aber kleiner oder gleich dem maximalen Operandenwert (Operand muss immer ein Array sein). | | **NOTSET** | Tag ist nicht gesetzt. Operand wird nicht berücksichtigt. | | **ANY** | Tag hat einen beliebigen Wert. Operand wird nicht berücksichtigt. | #### String-Tags **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 wie `["Wert 1", "Wert 2", "Wert N"]` sein | | **NOTSET** | Tag ist nicht gesetzt. Operand wird nicht berücksichtigt | | **ANY** | Tag hat einen beliebigen Wert. Operand wird nicht berücksichtigt | #### Integer-Tags **Gültige Operatoren**: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY **Gültige Operanden:** | | | | -------- | ------- | | **EQ, NOTEQ, GTE, LTE** | Operand muss eine ganze Zahl sein | | **IN, NOTIN** | Operand muss ein Array von ganzen Zahlen wie `[Wert 1, Wert 2, Wert N]` sein | | **BETWEEN** | Operand muss ein Array von ganzen Zahlen wie `[min_Wert, max_Wert]` sein | | **NOTSET** | Tag ist nicht gesetzt. Operand wird nicht berücksichtigt | | **ANY** | Tag hat einen beliebigen Wert. Operand wird nicht berücksichtigt | #### Datums-Tags **Gültige Operatoren**: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY **Gültige Operanden:** * `"YYYY-MM-DD 00:00"` (string) * Unix-Zeitstempel `1234567890` (integer) * `"vor N Tagen"` (string) für die Operatoren EQ, BETWEEN, GTE, LTE #### Boolesche Tags **Gültige Operatoren**: EQ, NOTSET, ANY **Gültige Operanden:** `0, 1, true, false` #### Listen-Tags **Gültige Operatoren**: IN, NOTIN, NOTSET, ANY **Gültige Operanden:** Operand muss ein Array von Zeichenfolgen wie `["Wert 1", "Wert 2", "Wert N"]` sein. ### conditions_operator Logischer Operator für Bedingungs-Arrays. Mögliche Werte: AND | OR. AND ist der Standardwert. Wenn der angewendete Operator AND ist (wenn kein Operator angegeben ist oder der Parameter 'conditions_operator' den Wert 'AND' hat), erhalten Geräte, die gleichzeitig alle Bedingungen erfüllen, die Push-Benachrichtigung. Wenn der Operator OR ist, erhalten Geräte, die eine der angegebenen Bedingungen erfüllen, die Nachricht. ### data JSON-String oder JSON-Objekt, das verwendet wird, um beliebige [benutzerdefinierte Daten](/de/developer/guides/messaging-channels/using-custom-data) in der Push-Payload zu übergeben; wird als "u"-Parameter in der Payload übergeben (in einen JSON-String konvertiert). ### devices Das Array von [Push-Token](/de/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) oder [HWIDs](/de/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) zum Senden gezielter Push-Benachrichtigungen. Wenn gesetzt, wird die Nachricht nur an die Geräte in der Liste gesendet. ### dynamic_content Platzhalter für [Dynamic Content](/de/product/personalization/dynamic-content), die anstelle von Geräte-Tag-Werten verwendet werden. Das folgende Beispiel sendet die Nachricht "Hallo, John!" an jeden Benutzer, den Sie ansprechen. Wenn nicht gesetzt, werden die Dynamic Content-Werte aus den Geräte-Tags übernommen. ``` "content": "Hello, {firstname|CapitalizeFirst}!", "dynamic_content_placeholders": { "firstname": "John", "lastname": "Doe" }, ``` ### filter Der Name eines [Segments](/de/product/audience-data-and-segmentation/segmentation/) genau so, wie es im Pushwoosh Control Panel oder über eine [`/createFilter`](/de/developer/api-reference/segmentation-filters-api/#createfilter) API-Anfrage erstellt wurde. Gehen Sie zum Abschnitt **Audience** → **Segments** und überprüfen Sie die Liste der erstellten Segmente. Segmentliste im Audience-Bereich des Pushwoosh Control Panels Um die Segmentliste über die API zu erhalten, rufen Sie die API-Methode [`/listFilters`](/de/developer/api-reference/segmentation-filters-api/#listfilters) auf. In der Antwort auf die `/listFilters`-Anfrage erhalten Sie die Liste aller in Ihrem Pushwoosh-Konto erstellten Segmente mit den Namen, Bedingungen und Ablaufdaten der Segmente. ### ignore_user_timezone Wenn auf 'true' gesetzt, wird die Nachricht zu der im Parameter "send_date" angegebenen Zeit und dem Datum gemäß UTC-0 gesendet. Wenn auf 'false' gesetzt, erhalten die Benutzer die Nachricht zur angegebenen Ortszeit gemäß den Einstellungen ihres Geräts. ### inbox_date Das Datum, bis zu dem die Nachricht im [Inbox](/de/developer/guides/message-inbox/mobile-message-inbox) der Benutzer aufbewahrt werden soll. Wenn nicht angegeben, wird die Nachricht am Tag nach dem Sendedatum aus dem Inbox entfernt. ### inbox_image Die URL des benutzerdefinierten Bildes, das neben der Nachricht im [Inbox](/de/developer/guides/message-inbox/mobile-message-inbox) angezeigt werden soll. ### inbox_days Die Lebensdauer einer Inbox-Nachricht in Tagen, bis zu 30 Tage. Nach diesem Zeitraum wird die Nachricht aus dem Inbox entfernt. Kann anstelle des Parameters **inbox_date** verwendet werden. ### link Die URL, die geöffnet wird, sobald ein Benutzer eine Push-Benachrichtigung öffnet. ### message_type Gibt den Typ der Push-Nachricht an. Verfügbare Werte sind `marketing` und `transactional`. Siehe [Marketing- vs. Transaktionsnachrichten](/de/product/messaging-channels/marketing-vs-transactional/) für Details. Dieser Parameter ist optional. Wenn er weggelassen wird, erhalten Benutzer mit `PW_ControlGroup: true` die Nachricht nicht. ### minimize_link Shortener zum Minimieren der im Parameter "link" übermittelten URL. Bitte beachten Sie, dass die Größe der Push-Benachrichtigungs-Payload begrenzt ist. Erwägen Sie daher, kurze URLs zu erstellen, um das Limit nicht zu überschreiten. Verfügbare Werte: 0 — nicht minimieren, 2 — bitly. Standard = 2. Der Google URL Shortener ist seit dem 30. März 2019 deaktiviert. ### platforms Das Array der Plattform-Codes, um die Nachricht nur an bestimmte Plattformen zu senden. Verfügbare Plattform-Codes sind: `1` — iOS, `3` — Android, `7` — Mac OS X, `8` — Windows, `9` — Amazon, `10` — Safari, `11` — Chrome, `12` — Firefox, `14` — Email, `17` — Huawei, `18` — SMS und `21` — WhatsApp. ### preset Der Code eines [Presets](/de/product/content/push-presets/), das im Pushwoosh Control Panel oder über die API erstellt wurde. Um einen Preset-Code zu erhalten, gehen Sie zu **Content** → **Presets**, erweitern Sie das Preset, das Sie verwenden möchten, und kopieren Sie den **Preset Code** aus den Details des Presets. Preset-Liste im Content-Bereich, die den Preset-Code anzeigt ### rich_media Der Code einer [Rich Media](/de/product/content/in-apps/)-Seite, die Sie Ihrer Nachricht anhängen möchten. Um einen Code zu erhalten, gehen Sie zu **Content** → **Rich Media**, öffnen Sie eine Rich Media-Seite, die Sie verwenden möchten, und kopieren Sie den Code aus der URL-Leiste Ihres Browsers. Der Code ist ein durch Bindestriche getrennter Satz von 10 Zeichen (sowohl Buchstaben als auch Ziffern). Rich Media-Seite im Content-Bereich mit Rich Media-Code in der URL-Leiste des Browsers ### send_rate Drosselung zur Begrenzung der Push-Sendegeschwindigkeit. Gültige Werte liegen zwischen 100 und 1000 Pushes/Sekunde. ### timezone Zeitzone, die berücksichtigt werden soll, wenn die Nachricht zu einem bestimmten Datum und einer bestimmten Uhrzeit gesendet wird. Wenn gesetzt, wird die Zeitzone des Geräts ignoriert. Wenn ignoriert, wird die Nachricht in UTC gesendet. Siehe [https://php.net/manual/timezones.php](https://php.net/manual/timezones.php) für unterstützte Zeitzonen. ### template_bindings Vorlagen-Platzhalter zur Verwendung in Ihrer Inhaltsvorlage. Siehe die [Anleitung zu Liquid Templates](/de/developer/guides/personalization/liquid-templates/) für Details. ### transactionId Eindeutiger Nachrichten-Identifikator zur Vermeidung von doppelten Nachrichten bei Netzwerkproblemen. Sie können jeder Nachricht, die über eine [`/createMessage`](/de/developer/api-reference/messages-api/#createmessage) oder [`/createTargetedMessage`](/de/developer/api-reference/messages-api/#createtargetedmessage) Anfrage erstellt wird, eine beliebige ID zuweisen. Wird auf der Seite von Pushwoosh für 5 Minuten gespeichert. ### users Das Array von [userIds](/de/developer/pushwoosh-knowledge-hub/users-userids/). Die User ID ist ein eindeutiger Benutzeridentifikator, der durch eine [`/registerUser`](/de/developer/api-reference/user-centric-api/), [`/registerDevice`](/de/developer/api-reference/device-api/#registerdevice) oder [`/registerEmail`](/de/developer/api-reference/email-api/) API-Anfrage gesetzt wird.