# /createMessage-Parameter

<Aside type="caution" title="Veraltet">
`/createMessage` ist veraltet. Neue Integrationen sollten die [Messaging API v2](/de/developer/api-reference/messaging-api-v2/) verwenden – siehe die [Migrationsanleitung](/de/developer/api-reference/messaging-api-v2/migration-from-v1/) für eine feldweise Zuordnung der unten aufgeführten Parameter.
</Aside>

Hier finden Sie die Beschreibungen der API-Parameter von [`/createMessage`](/de/developer/api-reference/messages-api/#createmessage).

- [Erforderliche Parameter](#required-parameters) müssen enthalten sein, um eine `/createMessage` API-Anfrage erfolgreich zu senden und eine Push-Benachrichtigung zur angegebenen Zeit zu übertragen.

- [Optionale Parameter](#optional-parameters) ermöglichen es Ihnen, die Eigenschaften von Push-Benachrichtigungen anzupassen.

<Aside type="note">
Wenn Sie _/createMessage_ zum Senden von SMS verwenden, beziehen Sie sich bitte auf [Parameter zum Senden von SMS](/de/developer/api-reference/sms/#createsmsmessage). Andere Parameter werden nicht übergeben.
</Aside>

<span id="required-parameters" />

## Erforderliche Parameter

Erforderliche Parameter sind obligatorisch für die Verwendung in [`/createMessage`](/de/developer/api-reference/messages-api/#createmessage)-Anfragen. 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).

<img src="/messages-api-prerequisites-1.webp" alt="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 **Einstellungen** → **API-Zugriff** und kopieren Sie ein Token, das Sie verwenden möchten, oder generieren Sie ein neues.

<img src="/messages-api-prerequisites-2.webp" alt="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.

<img src="/messages-api-prerequisites-3.webp" alt="Dialog zur Generierung von API-Token mit Berechtigungen und Anwendungs-Kontrollkästchen"/>

### content

Die Zeichenfolge oder das Objekt, das den Nachrichteninhalt definiert. Der "content"-Parameter, der mit einem Zeichenfolgen-Typ-Wert ü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 dem Absenden der Anfrage gesendet.

<span id="optional-parameters" />

## Optionale Parameter

<span id="campaign" />

### campaign

Der Code einer Kampagne. Um einen Kampagnencode zu erhalten, gehen Sie zu **Statistiken** → **Aggregierte Statistiken** und wählen Sie die Kampagne aus, die Sie verwenden möchten. Der Kampagnencode wird am Ende der Seiten-URL im Format `XXXXX-XXXXX` sichtbar sein.

**Beispiel:**

**URL:** `https://app.pushwoosh.com/applications/AAAAA-AAAAA/statistics/aggregated-message?campaignCode=XXXXX-XXXXX`

**Kampagnencode:** `XXXXX-XXXXX`

Um eine Liste von 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.

<span id="capping_days" />

### capping_days

Zeitraum, der für das Frequency Capping angewendet werden soll, in Tagen (max. 30 Tage). Siehe [Frequency Capping](/de/product/messaging-channels/message-delivery-settings/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.

<span id="capping_count" />

### 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/message-delivery-settings/frequency-capping/) für Details.

<span id="conditions" />

### 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 Wertvergleichsoperator ("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 min-Operandenwert, aber kleiner oder gleich dem max-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 `["value 1", "value 2", "value 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 `[value 1, value 2, value N]` sein |
| **BETWEEN** | Operand muss ein Array von ganzen Zahlen wie `[min_value, max_value]` 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"` (Zeichenfolge)
* Unix-Zeitstempel `1234567890` (Ganzzahl)
* `"N days ago"` (Zeichenfolge) 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 `["value 1", "value 2", "value N"]` sein.

<Aside type="danger" title="Wichtig">
Denken Sie daran, dass die Parameter „filter“ und „conditions“ nicht zusammen verwendet werden sollten.\
Außerdem werden beide **ignoriert**, wenn der Parameter „devices“ in derselben Anfrage verwendet wird.
</Aside>

<Aside type="note" title="Länder- und Sprach-Tags">
Der Wert des Sprach-Tags ist ein zweibuchstabiger Kleinbuchstabencode gemäß [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).
Der Wert des Länder-Tags ist ein zweibuchstabiger GROSSBUCHSTABEN-Code gemäß [ISO_3166-2](https://en.wikipedia.org/wiki/ISO_3166-2).

Um beispielsweise eine Push-Benachrichtigung an portugiesischsprachige Abonnenten in Brasilien zu senden, müssen Sie die folgende Bedingung angeben: `"conditions": [["Country", "EQ", "BR"],["Language", "EQ", "pt"]]`
</Aside>

<span id="conditions_operator" />

### conditions_operator

Logischer Operator für Bedingungen-Arrays. Mögliche Werte: AND | OR. AND ist der Standardwert.

Wenn der angewendete Operator AND ist (wenn kein Operator angegeben ist oder der 'conditions_operator'-Parameter 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.

<span id="data" />

### data

JSON-Zeichenfolge 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 eine JSON-Zeichenfolge konvertiert).

<span id="devices" />

### 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.

<span id="dynamic_content" />

### dynamic_content

Platzhalter für [Dynamic Content](/de/product/personalization/dynamic-content), die anstelle von Geräte-Tag-Werten verwendet werden sollen. 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"
},
```

<span id="filter" />

### 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.

<img src="/messages-api-prerequisites-7.webp" alt="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.

<span id="ignore_user_timezone" />

### ignore_user_timezone

Wenn auf 'true' gesetzt, wird die Nachricht zu der im "send_date"-Parameter angegebenen Zeit und Datum gemäß UTC-0 gesendet.

Wenn auf 'false' gesetzt, erhalten Benutzer die Nachricht zur angegebenen lokalen Zeit gemäß den Einstellungen ihres Geräts.

<span id="inbox_date" />

### 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 nächsten Tag nach dem Sendedatum aus dem Inbox entfernt.

<Aside type="note">
Um die Nachricht im Inbox zu speichern, verwenden Sie mindestens einen der 'inbox'-Parameter: "inbox_date" oder "inbox_image".
</Aside>

<Aside type="caution">
Die Nachricht wird am angegebenen Datum um 00:00:01 Uhr aus dem Inbox entfernt, sodass der vorherige Tag der letzte Tag ist, an dem ein Benutzer die Nachricht in seinem Inbox sehen kann.
</Aside>

<span id="inbox_image" />

### inbox_image

Die URL des benutzerdefinierten Bildes, das neben der Nachricht im [Inbox](/de/developer/guides/message-inbox/mobile-message-inbox) angezeigt werden soll.

<Aside type="note">
Um die Nachricht im Inbox zu speichern, verwenden Sie mindestens einen der 'inbox'-Parameter: "inbox_date" oder "inbox_image".
</Aside>

<span id="inbox_days" />

### inbox_days

Die Lebensdauer einer Inbox-Nachricht in Tagen, bis zu 30 Tage. Nach diesem Zeitraum wird die Nachricht aus dem Posteingang entfernt. Kann anstelle des **inbox_date**-Parameters verwendet werden.

<span id="link" />

### link

Die URL, die geöffnet wird, sobald ein Benutzer eine Push-Benachrichtigung öffnet.

<span id="message_type" />

### message_type

Gibt den Nachrichtentyp an. Funktioniert für alle Plattformen, an die Sie mit dieser Methode senden, einschließlich SMS und WhatsApp, sowie in `createSMSMessage` und `createWhatsAppMessage`. 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, wird die Nachricht als Marketingnachricht behandelt: Sie wird nicht an Mitglieder der [Kontrollgruppe](/de/product/audience-data-and-segmentation/control-groups/) zugestellt, und SMS-Nachrichten werden anhand der [Marketing-Einwilligung](/de/product/messaging-channels/sms-viber-marketing-consent/) geprüft. Um eine Servicenachricht an alle zu senden, setzen Sie `message_type` auf `transactional`.

<span id="minimize_link" />

### minimize_link

Shortener zum Minimieren der im "link"-Parameter ü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.

<span id="platforms" />

### platforms

Das Array von Plattform-Codes, um die Nachricht nur an bestimmte Plattformen zu senden.

Verfügbare Plattform-Codes umfassen: `1` — iOS, `3` — Android, `7` — Mac OS X, `8` — Windows, `9` — Amazon, `10` — Safari, `11` — Chrome, `12` — Firefox, `14` — E-Mail, `17` — Huawei, `18` — SMS und `21` — WhatsApp.

<span id="preset" />

### 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 **Inhalt** → **Presets**, erweitern Sie das Preset, das Sie verwenden möchten, und kopieren Sie den **Preset-Code** aus den Details des Presets.

<img src="/messages-api-prerequisites-8.webp" alt="Preset-Liste im Inhaltsbereich, die den Preset-Code anzeigt"/>

<span id="rich_media" />

### rich_media

Der Code einer [In-Apps](/de/product/content/in-apps/)-Seite, die Sie an Ihre Nachricht anhängen möchten. Um einen Code zu erhalten, gehen Sie zu **Inhalt** → **In-Apps**, öffnen Sie die 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).

<img src="/messages-api-prerequisites-9.webp" alt="In-Apps-Seite im Inhaltsbereich mit Rich-Media-Code in der URL-Leiste des Browsers"/>

<span id="send_rate" />

### send_rate

Drosselung zur Begrenzung der Push-Sendegeschwindigkeit. Gültige Werte liegen zwischen 100 und 1000 Pushes/Sekunde.

<span id="timezone" />

### timezone

Zeitzone, die berücksichtigt werden soll, wenn die Nachricht an einem bestimmten Datum und zu 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.

<span id="template_bindings" />

### template_bindings

Vorlagen-Platzhalter zur Verwendung in Ihrer Inhaltsvorlage. Siehe die [Anleitung zu Liquid Templates](/de/developer/guides/personalization/liquid-templates/) für Details.

<span id="transactionid" />

### transactionId

Eindeutiger Nachrichtenidentifikator, um das Duplizieren von Nachrichten bei Netzwerkproblemen zu verhindern. Sie können jeder Nachricht, die über die Anfrage [`/createMessage`](/de/developer/api-reference/messages-api/#createmessage) oder [`/createTargetedMessage`](/de/developer/api-reference/messages-api/#createtargetedmessage) erstellt wird, eine beliebige ID zuweisen. Wird auf der Seite von Pushwoosh für 5 Minuten gespeichert.

<span id="use_latest_user_device" />

### use_latest_user_device

Wenn auf `true` gesetzt, wird ein Push pro Benutzer anstelle von einem pro Gerät zugestellt: Nur das Gerät mit der letzten Anwendungsöffnung unter den Plattformen in `platforms` erhält ihn. Wenn keines der Geräte eines Benutzers auf diesen Plattformen diese Daten hat, erhält stattdessen das erste passende Gerät die Nachricht, sodass der Versand niemals verworfen wird. Geräte ohne Benutzer-ID sind nicht betroffen. Gilt unabhängig davon, wie die Zielgruppe angesprochen wurde – durch `users`, `filter` oder `conditions`. Funktioniert genauso wie `use_latest_user_device` in der [Messaging API v2](/de/developer/api-reference/messaging-api-v2/notify/#notifysegment). Standardmäßig `false` (an jedes Gerät senden).

<span id="users" />

### users

Das Array von [User-IDs](/de/developer/pushwoosh-knowledge-hub/users-userids/). Die User-ID ist ein eindeutiger Benutzeridentifikator, der durch eine API-Anfrage von [`/registerUser`](/de/developer/api-reference/user-centric-api/), [`/registerDevice`](/de/developer/api-reference/device-api/#registerdevice) oder [`/registerEmail`](/de/developer/api-reference/email-api/) gesetzt wird.