LINE API

createLineMessage

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

Tipp: Für erweiterte Formatierungen und Rich Media verwenden Sie Nachrichtenvorlagen wie Flex, Bild oder Karussell.

Anfragekörper

Parameter	Typ	Erforderlich	Beschreibung
`application`	string	Ja	Pushwoosh-Anwendungscode
`auth`	string	Ja	API-Zugriffstoken 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. Hinweis: Wenn sowohl `preset` als auch `content` enthalten sind, überschreibt der Wert aus der Anfrage das `preset`.
`preset`	string	Nein	Code des 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 Strings	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 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 in der Dokumentation der LINE Messaging API.

Anfragekörper

Parameter	Typ	Erforderlich	Beschreibung
`application`	string	Ja	Pushwoosh-Anwendungscode
`auth`	string	Ja	API-Zugriffstoken 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. Hinweis: Wenn sowohl `preset` als auch `template` enthalten sind, wird das `template` aus der Anfrage verwendet. Wenn sowohl `preset` als auch `content` enthalten sind, überschreibt der `content` 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 Strings	Ja	Liste der Gerätecodes (Benutzer-IDs), an die die LINE-Nachricht gesendet werden soll.
`preset`	string	Nein	Code des LINE-Presets, das Sie im Pushwoosh Control Panel erstellt haben. Hinweis: Wenn sowohl die Parameter `preset` als auch `template` in der Anfrage enthalten sind, überschreiben die Werte aus dem `template` die im Preset definierten Werte. Wenn sowohl `preset` als auch `content` in derselben Anfrage enthalten sind, überschreibt der direkt in der Anfrage bereitgestellte `content` den Inhalt aus dem `preset`.
`template`	object	Ja	Nachrichtenlayout-Vorlage. Unterstützt mehrere Nachrichtentypen. Siehe Details unten.

Vorlagenparameter

Typ: image

Parameter	Typ	Erforderlich	Beschreibung
`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

{
  "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 in der Dokumentation der LINE Messaging API.

Anfragekörper

Parameter	Typ	Erforderlich	Beschreibung
`application`	string	Ja	Pushwoosh-Anwendungscode
`auth`	string	Ja	API-Zugriffstoken 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. Hinweis: Wenn sowohl `content` als auch `template` gesetzt sind, wird das `template` verwendet. Wenn sowohl ein `preset` als auch `content` in derselben Anfrage enthalten sind, überschreibt der direkt in der Anfrage bereitgestellte `content` den Inhalt aus dem `preset`.
`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 Strings	Ja	Liste der Gerätecodes (Benutzer-IDs), an die die LINE-Nachricht gesendet werden soll.
`preset`	string	Nein	Code des LINE-Presets, das Sie im Pushwoosh Control Panel erstellt haben. Hinweis: Wenn sowohl die Parameter `preset` als auch `template` in der Anfrage enthalten sind, überschreiben die Werte aus dem `template` die im `preset` definierten Werte. Wenn sowohl ein `preset` als auch `content` in derselben Anfrage enthalten sind, überschreibt der direkt in der Anfrage bereitgestellte `content` den Inhalt aus dem `preset`.
`template`	object	Ja	Nachrichtenlayout-Vorlage. Unterstützt mehrere Nachrichtentypen. Siehe Details unten.

Vorlagenparameter

Typ: image_carousel

Parameter	Typ	Erforderlich	Beschreibung
`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

{
  "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 folgen.

Tipp: Sie können Flex-Nachrichten mit dem LINE Flex Message Simulator entwerfen und in der Vorschau anzeigen.

Anfragekörper

Parameter	Typ	Erforderlich	Beschreibung
`application`	string	Ja	Pushwoosh-Anwendungscode
`auth`	string	Ja	API-Zugriffstoken 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. Hinweis: Wenn sowohl `content` als auch `template` gesetzt sind, wird die Vorlage verwendet. Wenn sowohl `preset` als auch `content` 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 Strings	Ja	Liste der LINE-Gerätetokens (Benutzer-IDs), die die Nachricht erhalten sollen.
`preset`	string	Nein	Code des LINE-Presets, das Sie im Pushwoosh Control Panel erstellt haben. Hinweis: Wenn sowohl `preset` als auch `template` enthalten sind, überschreibt die Vorlage das Preset. Wenn sowohl `preset` als auch `content` 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	Typ	Erforderlich	Beschreibung
`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

{
  "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...
                  ]
                }
              }
            }
          }
        }
      }
    ]
  }
}