# LINE API

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

<Aside type="caution" title="/createLineMessage ist veraltet">
Neue Integrationen sollten die [Messaging API v2](/de/developer/api-reference/messaging-api-v2/) verwenden – übergeben Sie `platforms: ["LINE"]` an `Notify` und verwenden Sie den `line`-Block innerhalb von `payload.content.localized_content`. Siehe die [Migrationsanleitung](/de/developer/api-reference/messaging-api-v2/migration-from-v1/#from-createlinemessage). Für Rich-Image-, Karussell- oder Flex-Nachrichten konfigurieren Sie diese als LINE-Vorlagen in Ihrem Pushwoosh Control Panel vor und verweisen Sie auf den Vorlagencode über `line.template`.
</Aside>

<Aside> Bevor Sie LINE-Nachrichten senden, stellen Sie sicher, dass die LINE-Plattform ordnungsgemäß konfiguriert ist. [Erfahren Sie mehr](/de/developer/first-steps/connect-messaging-services/line-configuration/) </Aside>

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

Wird verwendet, um LINE-Nachrichten an Benutzer zu senden

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

### Eine Textnachricht senden

Einfache LINE-Nachrichten, die nur aus reinem Text bestehen, ohne Bilder oder Schaltflächen. [Erfahren Sie mehr](https://developers.line.biz/en/reference/messaging-api/#text-message)

> **Tipp:** Für erweiterte Formatierungen und Rich Media verwenden Sie Nachrichtenvorlagen wie [Flex](#eine-flex-nachricht-senden), [Bild](#eine-bildnachricht-senden) oder [Karussell](#eine-bildkarussell-nachricht-senden).

##### Request-Body

| Parameter <div style="width:180px"></div>| Typ  <div style="width: 80px"></div>| Erforderlich | Beschreibung <div style="width:180px"></div> |
| :---- | :---- | :---- | :---- |
| `application` | string | Ja | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| `auth` | string | Ja | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) zur Authentifizierung der Anfrage.  |
| `notifications` | Array von Objekten | Ja | Liste der zu sendenden LINE-Nachrichtenobjekte. |
| `content` | string | Ja | Text der zu sendenden LINE-Nachricht. Maximale Zeichenlänge: 5000.<br/><strong>Hinweis:</strong> Wenn sowohl <code>preset</code> als auch <code>content</code> enthalten sind, überschreibt der Wert aus der Anfrage das <code>preset</code>. |
| `preset` | string | Nein | Code des [LINE-Presets](/de/product/content/line-presets/), das Sie im Pushwoosh Control Panel erstellt haben. **Hinweis:** Wenn sowohl `preset` als auch `content` enthalten sind, überschreibt der Wert aus der Anfrage das `preset`. |
| `send_date` | string | Ja | Datum und Uhrzeit zum Senden der Nachricht. Verwenden Sie das Format `YYYY-MM-DD HH:mm` oder `now`, um sofort zu senden. |
| `devices` | Array von Zeichenketten | Ja | Liste der Gerätecodes (Benutzer-IDs), an die die LINE-Nachricht gesendet werden soll. |

```
{
    "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
        "notifications": [
            {
                "content": "test",
                "preset": "preset_code",
                "send_date":"now",
                "devices": ["XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"]
            }
        ]
    }
}

```

### Eine Bildnachricht senden

Sie können eine [Bildnachricht](https://developers.line.biz/en/reference/messaging-api/#image-message) an LINE-Benutzer senden, indem Sie ein Bildobjekt im Vorlagenfeld Ihrer Anfrage angeben. 

Jede Bildnachricht erfordert zwei Bild-URLs: eine für das **Bild in voller Größe (image\_url)** und eine weitere für die **Vorschau (preview\_image\_url)**. Wenn Benutzer auf die Vorschau tippen, öffnet sich das Bild in voller Größe. Stellen Sie sicher, dass beide URLs HTTPS (TLS 1.2 oder höher) verwenden und auf öffentlich zugängliche Bilddateien verweisen. 

Weitere Details finden Sie im Abschnitt [Bildnachricht](https://developers.line.biz/en/reference/messaging-api/#image-message) in der LINE Messaging API-Dokumentation. 

##### Request-Body 

| Parameter <div style="width:180px"></div>| Typ  <div style="width: 80px"></div>| Erforderlich | Beschreibung <div style="width:180px"></div> |
| :---- | ----- | ----- | ----- |
| `application` | string | Ja | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| `auth` | string | Ja | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) zur Authentifizierung der Anfrage. |
| `notifications` | Array von Objekten | Ja | Liste der zu sendenden Nachrichten. |
| `content` | string | Ja | Wird als Fallback- oder Vorschautext für die Nachricht verwendet. Code des LINE-Presets, das Sie im Pushwoosh Control Panel erstellt haben.<br/><strong>Hinweis:</strong> Wenn sowohl <code>preset</code> als auch <code>template</code> enthalten sind, wird das <code>template</code> aus der Anfrage verwendet.<br/>Wenn sowohl <code>preset</code> als auch <code>content</code> enthalten sind, überschreibt der <code>content</code> aus der Anfrage das Preset. |
| `send_date` | string | Ja | Datum und Uhrzeit zum Senden der Nachricht. Verwenden Sie das Format `YYYY-MM-DD HH:mm` oder `now`, um sofort zu senden. |
| `devices` | Array von Zeichenketten | Ja | Liste der Gerätecodes (Benutzer-IDs), an die die LINE-Nachricht gesendet werden soll. |
| `preset` | string | Nein | Code des [LINE-Presets](/de/product/content/line-presets/), das Sie im Pushwoosh Control Panel erstellt haben.<br/><strong>Hinweis:</strong> Wenn sowohl die Parameter <code>preset</code> als auch <code>template</code> in der Anfrage enthalten sind, überschreiben die Werte aus dem <code>template</code> die im Preset definierten.<br/>Wenn sowohl <code>preset</code> als auch <code>content</code> in derselben Anfrage enthalten sind, überschreibt der direkt in der Anfrage bereitgestellte <code>content</code> den Inhalt aus dem <code>preset</code>. |
| `template` | object | Ja | Nachrichtenlayout-Vorlage. Unterstützt mehrere Nachrichtentypen. Siehe Details unten.  |

##### Vorlagenparameter

**Typ:** image

| Parameter <div style="width:180px"></div>| Typ  <div style="width: 80px"></div>| Erforderlich | Beschreibung <div style="width:180px"></div> |
| :---- | :---- | :---- | :---- |
| `image_url` | string | Ja | URL zum Bild in voller Größe (muss HTTPS verwenden). **Maximale Länge:** 2000 Zeichen. **Format:** JPEG, PNG. **Maximale Größe:** 10 MB. |
| `preview_image_url` | string | Ja | URL zum Vorschaubild, das im Chat angezeigt wird (muss HTTPS verwenden). **Maximale Länge:** 2000 Zeichen. **Format:** JPEG, PNG. **Maximale Größe:** 1 MB.  |

##### Beispielanfrage

```json
{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": [
          "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        ],
        "preset": "preset_code",
        "template": {
          "en": {
            "image": {
              "alt_text": "some text",
              "image_url": "https://images.com/1.jpg",
              "preview_image_url": "https://images.com/1.png"
            }
          }
        }
      }
    ]
  }
}


```

### Eine Bildkarussell-Nachricht senden

Bildkarussell-Nachrichten ermöglichen es Ihnen, mehrere Bilder in einem horizontal scrollbaren Format anzuzeigen. Jedes Bild erscheint als separate, nicht klickbare Spalte, durch die Benutzer in der LINE-Chat-Oberfläche wischen können. 

Dieses Format ist ideal, um Artikel, Werbeaktionen oder visuelle Auswahlen auf ansprechende Weise zu präsentieren. 

Weitere Details finden Sie im Abschnitt [Bildkarussell-Vorlage](https://developers.line.biz/en/reference/messaging-api/#carousel) in der LINE Messaging API-Dokumentation.

##### Request-Body

| Parameter <div style="width:180px"></div>| Typ  <div style="width: 80px"></div>| Erforderlich | Beschreibung <div style="width:180px"></div> |
| :---- | :---- | :---- | :---- |
| `application` | string | Ja | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| `auth` | string | Ja | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) zur Authentifizierung der Anfrage. |
| `notifications` | Array von Objekten | Ja | Liste der zu sendenden Nachrichten. |
| `content` | string | Ja | Wird als Fallback- oder Vorschautext für die Nachricht verwendet.<br/><strong>Hinweis:</strong> Wenn sowohl <code>content</code> als auch <code>template</code> gesetzt sind, wird das <code>template</code> verwendet.<br/>Wenn sowohl ein <code>preset</code> als auch <code>content</code> in derselben Anfrage enthalten sind, überschreibt der direkt in der Anfrage bereitgestellte <code>content</code> den Inhalt aus dem <code>preset</code>. |
| `send_date` | string | Ja | Datum und Uhrzeit zum Senden der Nachricht. Verwenden Sie das Format `YYYY-MM-DD HH:mm` oder `"now"`. |
| `devices` | Array von Zeichenketten | Ja | Liste der Gerätecodes (Benutzer-IDs), an die die LINE-Nachricht gesendet werden soll. |
| `preset` | string | Nein | Code des [LINE-Presets](/de/product/content/line-presets/), das Sie im Pushwoosh Control Panel erstellt haben.<br/><strong>Hinweis:</strong> Wenn sowohl die Parameter <code>preset</code> als auch <code>template</code> in der Anfrage enthalten sind, überschreiben die Werte aus dem <code>template</code> die im <code>preset</code> definierten.<br/>Wenn sowohl ein <code>preset</code> als auch <code>content</code> in derselben Anfrage enthalten sind, überschreibt der direkt in der Anfrage bereitgestellte <code>content</code> den Inhalt aus dem <code>preset</code>. |
| `template` | object | Ja  | Nachrichtenlayout-Vorlage. Unterstützt mehrere Nachrichtentypen. Siehe Details unten. |



##### Vorlagenparameter

**Typ:** image\_carousel

| Parameter <div style="width:180px"></div>| Typ  <div style="width: 80px"></div>| Erforderlich | Beschreibung <div style="width:180px"></div> |
| :---- | :---- | :---- | :---- |
| `alt_text` | string | Ja | Fallback-Text, der in Push-Vorschauen und auf nicht unterstützten Geräten angezeigt wird. Max. 400 Zeichen. |
| `columns` | Array von Objekten | Ja | Array von Bildspalten (1–10 unterstützt). Jede Spalte enthält ein Bild. |
| `image_url` | string  | Ja | URL zum Bild, das in jeder Karussellspalte angezeigt wird und auf eine öffentlich zugängliche JPEG- oder PNG-Datei verweist. Muss HTTPS verwenden. |

##### Beispielanfrage

```json
{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": [
          "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        ],
        "preset": "preset_code",
        "template": {
          "en": {
            "image_carousel": {
              "alt_text": "some text",
              "columns": [
                { "image_url": "https://images.com/1.jpg" },
                { "image_url": "https://images.com/2.jpg" },
                { "image_url": "https://images.com/3.jpg" }
              ]
            }
          }
        }
      }
    ]
  }
}
```

### Eine Flex-Nachricht senden

Flex-Nachrichten sind leistungsstarke, anpassbare Nachrichtentypen, mit denen Sie strukturierte Layouts mit Text, Bildern, Schaltflächen und anderen Komponenten erstellen können. Sie sind ideal für Anwendungsfälle wie Belege, Produktkarten, Menüs oder jeden Inhalt, der von einer visuellen Strukturierung profitiert.

Um eine Flex-Nachricht zu senden, fügen Sie ein `template`-Objekt mit einer `raw`-Payload in Ihre Anfrage ein. Das Nachrichtenlayout muss der [LINE Flex Message-Spezifikation](https://developers.line.biz/en/docs/messaging-api/using-flex-messages/) entsprechen. 

**Tipp:** Sie können Flex-Nachrichten mit dem [LINE Flex Message Simulator](https://developers.line.biz/flex-simulator/) entwerfen und in der Vorschau anzeigen.

##### Request-Body

| Parameter <div style="width:180px"></div>| Typ  <div style="width: 80px"></div>| Erforderlich | Beschreibung <div style="width:180px"></div> |
| :---- | :---- | :---- | :---- |
| `application` | string | Ja | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| `auth` | string | Ja | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) zur Authentifizierung der Anfrage. |
| `notifications` | Array von Objekten | Ja | Liste der zu sendenden Nachrichten. |
| `content` | string | Ja | Wird als Fallback- oder Vorschautext für die Nachricht verwendet.<br/><strong>Hinweis:</strong> Wenn sowohl <code>content</code> als auch <code>template</code> gesetzt sind, wird die Vorlage verwendet.<br/>Wenn sowohl <code>preset</code> als auch <code>content</code> enthalten sind, überschreibt der Inhalt aus der Anfrage das Preset. |
| `send_date` | string | Ja | Wann die Nachricht gesendet werden soll. Verwenden Sie das Format `"now"` oder `YYYY-MM-DD HH:mm`. |
| `devices` | Array von Zeichenketten | Ja | Liste der LINE-Gerätetoken (Benutzer-IDs), die die Nachricht empfangen sollen. |
| `preset` | string | Nein | Code des [LINE-Presets](/de/product/content/line-presets/), das Sie im Pushwoosh Control Panel erstellt haben.<br/><strong>Hinweis:</strong> Wenn sowohl <code>preset</code> als auch <code>template</code> enthalten sind, überschreibt die Vorlage das Preset.<br/>Wenn sowohl <code>preset</code> als auch <code>content</code> enthalten sind, überschreibt der Inhalt aus der Anfrage das Preset. |
| `template` | object | Ja | Nachrichtenlayout-Vorlage. Unterstützt mehrere Nachrichtentypen. Siehe Details unten. |

##### Vorlagenparameter

Für eine Flex-Nachricht verwenden Sie die Raw-Struktur.  
Typ: raw (Flex)

| Parameter <div style="width:180px"></div>| Typ  <div style="width: 80px"></div>| Erforderlich | Beschreibung <div style="width:180px"></div> |
| :---- | :---- | :---- | :---- |
| `alt_text` | string | Ja | Fallback-Text, der in Benachrichtigungen, Chat-Vorschauen und Zitaten angezeigt wird. Max. 400 Zeichen. |
| `content`  | object  | Ja | Flex-Nachrichtenlayout, strukturiert mit `bubble`, `box`, `text` und anderen Komponenten gemäß der Flex-Spezifikation von LINE. |

##### Beispielanfrage

```json
{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": ["XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"],
        "preset": "preset_code", 
        "template": {
          "en": {
            "raw": {
              "alt_text": "My raw template",
              "content": {
                "type": "bubble",
                "body": {
                  "type": "box",
                  "layout": "vertical",
                  "contents": [
                    {
                      "type": "text",
                      "text": "RECEIPT",
                      "weight": "bold",
                      "color": "#1DB446",
                      "size": "sm"
                    }
                    // Additional components...
                  ]
                }
              }
            }
          }
        }
      }
    ]
  }
}
```