WhatsApp Business Platform > Cloud API > Leitfäden

Produkte mit Kund*innen teilen

Du hast verschiedene Möglichkeiten, Produkte mit deinen Kund*innen zu teilen:

Katalognachrichten – Freitextnachrichten mit einem Button, der beim Antippen deinen Produktkatalog in WhatsApp anzeigt.
Katalogvorlagennachrichten – Vorlagennachrichten, die einen Button enthalten, der beim Antippen deinen Produktkatalog in WhatsApp anzeigt.
Katalog-Link-Nachrichten – Freitextnachrichten mit Katalog-Miniaturbildern und einem Link zu deinem gesamten Produktkatalog.
Produktnachrichten – Freitextnachrichten mit Informationen zu einem einzelnen Produkt oder maximal 30 Produkten aus deinem Produktkatalog.
Vorlagennachrichten für mehrere Produkte – Vorlagennachrichten mit Informationen zu maximal 30 Produkten aus deinem E-Commerce-Katalog, eingeteilt in bis zu 10 Abschnitten in einer einzigen Nachricht.

Katalognachrichten

Katalognachrichten sind Freitextnachrichten, mit denen du deinen Produktkatalog vollständig in WhatsApp präsentieren kannst.

Katalognachrichten zeigen im Titel ein Produkt-Miniaturbild deiner Wahl, einen selbstdefinierten Textkörper, einen Titel und Untertitel mit festem Text und einen Katalog anzeigen-Button.

Wenn ein*e Kund*in auf den Button Katalog anzeigen tippt, wird dein Produktkatalog in WhatsApp angezeigt.

Anforderungen

Du musst in Meta hochgeladenen Bestand in einem E-Commerce-Katalog mit deinem WhatsApp-Unternehmenskonto verbunden haben.

Anfragesyntax

Verwende den Endpunkt WhatsApp-Unternehmenstelefonnummer > Nachrichten, um eine Katalognachricht zu senden.

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Anfrageinhalt

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      
      /* Parameters object is optional */
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

Eigenschaften

Platzhalter	Beschreibung	Beispielwert
`<BODY_TEXT>` String	Erforderlich. Text, der im Nachrichtentext angezeigt werden soll. Maximal 1024 Zeichen.	`Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.`
`<FOOTER_TEXT>` String	Optional. Text, der im Footer der Nachricht angezeigt werden soll. Maximal 60 Zeichen.	`Best grocery deals on WhatsApp!`
`<THUMBNAIL_PRODUCT_RETAILER_ID>` String	Optional. SKU-Nummer des Artikels. Im Commerce Manager als Inhalts-ID gekennzeichnet. Das Miniaturbild dieses Artikels wird als Header-Bild der Nachricht verwendet. Wenn das `parameters`-Objekt weggelassen wird, wird das Produktbild des ersten Artikels in deinem Katalog verwendet.	`2lc20305pt`
`<TO>` String	Telefonnummer desder Kundin.	`+16505551234`

Beispielanfrage

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}'

Beispielantwort

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Katalogvorlagennachrichten

Katalogvorlagennachrichten sind Vorlagennachrichten, die einen Button enthalten, der beim Antippen deinen Produktkatalog in WhatsApp anzeigt.

Um eine Katalogvorlagennachricht zu senden, benötigst du eine Katalogvorlage. In unserem Katalogvorlagen-Dokument erfährst du, wie du diese Vorlagen erstellst und in einer Vorlagennachricht sendest.

Katalog-Link-Nachrichten

Durch Erstellen eines „wa.me“-Links, der in eine normale SMS-Nachricht eingefügt wird, kannst du einen Link zu deinem gesamten Produktkatalog senden. In einer SMS kannst du die optionale preview_url auf true festlegen, damit die Nachricht eine Gruppe von Miniaturbildern des Produktkatalogs jeder URL im Nachrichten-String body darstellt.

Hinweis: Wenn du den Katalog deaktivierst, wird beim Tippen auf „wa.me“-Links und den Button Katalog ansehen in der Katalog-Link-Nachricht die Nachricht Ungültiger Katalog-Link angezeigt.

Zum Erstellen des „wa.me“-Links hänge die Telefonnummer deines Unternehmens, einschließlich Ländervorwahl, an das Ende des folgenden Strings an:

https://wa.me/c/

Beispiel:

https://wa.me/c/15555455657

Produktnachrichten

Nachrichten für mehrere Produkte und Nachrichten für einzelne Produkte sind beides interactive-Nachrichten.

Beispiel für eine Nachricht für mehrere Produkte:	Beispiel für eine Nachricht für einzelne Produkte:

Menü, das ausgelöst wird, wenn Benutzerinnen auf „Start Shopping“ (Einkauf starten) klicken:*	Beispiel für Produktdetailseite:

Übersicht

Kund*innen, die Nachrichten für mehrere oder einzelne Produkte erhalten, können im Wesentlichen drei Aktionen ausführen:

Produkte ansehen: Kund*innen können eine Liste der Produkte oder nur ein Produkt aufrufen. Wenn ein*e Kund*in auf einen bestimmten Artikel klickt, rufen wir die aktuellen Informationen zum Produkt ab und stellen das Produkt im PDP-Format (Product Detail Page, Produktdetailseite) dar. Aktuell unterstützen PDPs nur Produktbilder. Videos und/oder GIFs, die zum Produkt hinzugefügt wurden, werden auf der PDP nicht angezeigt.
Produkte zu einem Warenkorb hinzufügen: Wenn ein*e Benutzer*in ein Produkt zu einem Warenkorb hinzufügt, rufen wir die aktuellen Informationen zum Artikel ab. Wenn es bei einem der Artikel eine Statusänderung gegeben hat, blenden wir ein Dialogfeld ein, das Folgendes besagt: „Mindestens ein Artikel im Warenkorb wurde aktualisiert“. Weitere Informationen dazu findest du unter Produkt-Updates. Ein Warenkorb bleibt in einem Chat-Thread zwischen dir und deinen Kund*innen so lange bestehen, bis der Warenkorb an dich gesendet wird. Weitere Informationen dazu findest du unter Warenkorb-Erlebnis.
Einen Warenkorb an dich senden: Nachdem alle benötigten Artikel hinzugefügt wurden, können Kund*innen ihren Warenkorb an dich senden. Danach kannst du die nächsten Schritte festlegen, z. B. Versandinformationen anfordern oder Zahlungsoptionen angeben.

Wenn dein*e Kund*in mehrere Geräte mit seinem*ihrem Konto verknüpft hat, werden die Nachrichten für mehrere und einzelne Produkte zwischen den Geräten synchronisiert. Der Warenkorb ist jedoch lokal für jedes einzelne Gerät vorhanden. Weitere Informationen dazu findest du unter Warenkorb-Erlebnis.

Derzeit können diese Arten von Nachrichten auf den folgenden Plattformen empfangen werden:

iOS: 2.21.100 (Nachrichten für mehrere Produkte) und 2.21.210 (Nachrichten für einzelne Produkte).
Android: 2.21.9.15 (Nachrichten für mehrere Produkte) und 2.21.19 (Nachrichten für einzelne Produkte).
Web: Der Webclient, der diese Funktionen unterstützt, wurde gelauncht.

Wenn die App-Version des*der Kund*in Nachrichten für mehrere oder einzelne Produkte nicht unterstützt, erhält diese*r stattdessen eine Nachricht, in der erläutert wird, dass die Nachricht aufgrund einer veralteten WhatsApp-Version nicht empfangen werden konnte. Wir senden dir außerdem eine Webhook-Benachrichtigung, die besagt, dass die Nachricht nicht zugestellt werden konnte, weil der*die Kund*in eine veraltete WhatsApp-Version verwendet.

Erwartetes Verhalten für Nachrichten

Nachrichten für mehrere und einzelne Produkte können:

Von einem*einer Benutzer*in an eine*n andere*n weitergeleitet werden.
Von einem*einer Benutzer*in in demselben Chat erneut geöffnet werden.

Nachrichten für mehrere und einzelne Produkte können nicht:

Als Benachrichtigungen gesendet werden. Sie können lediglich als Bestandteil bestehender Unterhaltungen gesendet werden.

Einschränkungen

Im Gegensatz zu Produktnachrichten, die über die WhatsApp Business-App gesendet werden, wird bei Nachrichten, die über die Cloud API gesendet werden, im Header des Chat-Threads derzeit kein Warenkorb-Symbol angezeigt.

Produkt-Updates

Unter Umständen musst du die Eigenschaften von Artikeln in deinem Katalog aktualisieren. Je nach der aktualisierten Eigenschaft verfahren wir folgendermaßen mit Nachrichten, in denen das betreffende Produkt erwähnt wird:

Aktualisierte Eigenschaft	Aktualisierungsverfahren
Preis, Bezeichnung, Beschreibung und Bild eines Produkts	Du sendest eine Nachricht für mehrere oder einzelne Produkte mit Produkt A. Du aktualisierst die Eigenschaften von Produkt A im Katalog. Die Bildschirme, die das betreffende Produkt anzeigen, werden aktualisiert, sobald der Client desder Kundin vom Server über die Änderung informiert wird.
Änderung der Verfügbarkeit	Du sendest einemeiner Kundin eine Nachricht für mehrere oder einzelne Produkte mit Produkt B. Du verkaufst die gesamte verfügbare Menge von Produkt B. Anschließend aktualisierst du den Katalog und gibst an, dass Produkt B nicht mehr erhältlich ist. Hat eine Kundin Produkt B bereits einem Warenkorb hinzugefügt, wird der Artikel aus dem Warenkorb entfernt. Der Warenkorb zeigt ein Dialogfeld an, das besagt: „Mindestens ein Artikel im Warenkorb wurde aktualisiert.“ Hat derdie Kundin Produkt B nicht dem Warenkorb hinzugefügt, wird die Nachricht für mehrere oder einzelne Produkte den Artikel nun als nicht verfügbar darstellen.

Aktualisierte Eigenschaft

Aktualisierungsverfahren

Preis, Bezeichnung, Beschreibung und Bild eines Produkts

Du sendest eine Nachricht für mehrere oder einzelne Produkte mit Produkt A.
Du aktualisierst die Eigenschaften von Produkt A im Katalog.
Die Bildschirme, die das betreffende Produkt anzeigen, werden aktualisiert, sobald der Client des*der Kund*in vom Server über die Änderung informiert wird.

Änderung der Verfügbarkeit

Du sendest einem*einer Kund*in eine Nachricht für mehrere oder einzelne Produkte mit Produkt B.
Du verkaufst die gesamte verfügbare Menge von Produkt B. Anschließend aktualisierst du den Katalog und gibst an, dass Produkt B nicht mehr erhältlich ist.
Hat ein*e Kund*in Produkt B bereits einem Warenkorb hinzugefügt, wird der Artikel aus dem Warenkorb entfernt. Der Warenkorb zeigt ein Dialogfeld an, das besagt: „Mindestens ein Artikel im Warenkorb wurde aktualisiert.“
Hat der*die Kund*in Produkt B nicht dem Warenkorb hinzugefügt, wird die Nachricht für mehrere oder einzelne Produkte den Artikel nun als nicht verfügbar darstellen.

Warenkorb-Erlebnis

Nach dem Anzeigen von Produkten können Kund*innen sie ihrem Warenkorb hinzufügen und diesen Warenkorb an dich senden. Für den Handel auf WhatsApp zeichnet sich ein Warenkorb durch folgende Merkmale aus:

Ist speziell mit dem Chat-Thread zwischen einem*einer Kund*in und einem Unternehmen auf einem bestimmten Gerät verknüpft: Pro Chat-Thread zwischen Kund*in und dir wird nur ein Warenkorb erstellt und Warenkörbe bleiben nicht über mehrere Geräte hinweg bestehen. Nachdem ein Warenkorb gesendet wurde, kann der*die Kund*in einen weiteren Warenkorb bei dir eröffnen und den Prozess erneut beginnen.
Er ist unbegrenzt gültig: Der Warenkorb bleibt im Chat-Thread bestehen, bis er an dich gesendet wird. Nach dem Senden ist der Warenkorb leer.

Kund*innen können einem Warenkorb maximal 99 Einheiten jedes einzelnen Katalogartikels hinzufügen. Für die Anzahl der unterschiedlichen Artikel, die einem Warenkorb hinzugefügt werden können, gibt es jedoch keine Obergrenze.

Nachdem ein Warenkorb gesendet wurde, können keine Änderungen mehr vorgenommen werden. Kund*innen können einen neuen Warenkorb senden, wenn sie neue Artikel benötigen oder ihre Bestellung ändern möchten. Du kannst keine Warenkörbe an Kund*innen senden.

Beispiel für ein Warenkorb-Erlebnis und erwartetes Verhalten für Statusänderungen bei Artikeln

Vorteile

Nachrichten für einzelne und mehrere Produkte schaffen eine einfache und personalisierte Benutzer*innen-Erfahrung. Sie eignen sich, wenn Kund*innen zu einigen Artikeln geleitet werden sollen, die jeweils besonders relevant für sie sind. So müssen sie nicht deinen ganzen Katalog durchstöbern.

Einfach und effizient

Sie verbinden die Funktionen mit Navigationstools wie NLP, Textsuche oder Listennachrichten und Antwort-Buttons, damit Kund*innen das Gesuchte schnell finden.

Persönlich

Sie werden dynamisch ausgefüllt und können daher für Kund*in oder Situation personalisiert werden. Beispiel: Du kannst eine Nachricht für mehrere Produkte zu den von einem*einer Kund*in am häufigsten bestellten Artikeln anzeigen.

Geschäftsergebnisse

Ein performanter Kanal zum Ankurbeln des Bestellaufkommens. In der Testphase erzielten Unternehmen im Durchschnitt eine Conversion von 7 % bei Nachrichten für mehrere Produkte, die an erhaltene Warenkörbe gesendet wurden.

Keine Vorlagen

Für interaktive Nachrichten sind keine Vorlagen oder Vorabgenehmigungen erforderlich. Sie werden in Echtzeit generiert und spiegeln stets die aktuellen Artikeldetails, Preise und Warenbestände aus dem Bestand wider.

Anwendungsmöglichkeiten

Nachrichten für mehrere Produkte eignen sich am besten, um Kund*innen zu einer bestimmten Teilmenge aus deinem Bestand zu leiten, z. B.:

Im Rahmen einer Unterhaltung einkaufen. Beispiel: Verwenden der Suchfunktion, damit Kund*innen eine Einkaufsliste verfassen, und als Antwort darauf eine Nachricht für mehrere Produkte senden
Zu einer bestimmten Kategorie navigieren, z. B. Sportbekleidung
Personalisierte Angebote oder Empfehlungen
Schon einmal bestellte Artikel erneut bestellen. Beispiel: Ein*e Benutzer*in kann die regelmäßige Bestellung von weniger als 30 Artikeln nachbestellen.

Nachrichten für einzelnen Produkte eignen sich am besten, um Kund*innen zu einem bestimmten Artikel aus deinem Bestand zu leiten und dabei aus einer begrenzten Anzahl von Optionen schnell eine Antwort zu senden, z. B.:

Auf die konkrete Anfrage eines*einer Kund*in antworten
Eine Empfehlung aussprechen
Einen schon einmal bestellten Artikel erneut bestellen

Beide Funktionen können auch im Rahmen einer Interaktion mit einem*einer menschlichen Mitarbeiter*in verwendet werden. Dazu musst du jedoch die entsprechenden Tools entwickeln, damit der*die menschliche Mitarbeiter*in im Thread eine Nachricht für mehrere bzw. einzelne Produkte generieren kann.

Erste Schritte

Führe vor dem Senden von Produktnachrichten die ersten Schritte aus, die für deine Anforderungen am besten geeignet sind:

Alle in diesem Leitfaden erwähnten API-Aufrufe müssen mit einem Zugriffsschlüssel authentifiziert werden. Entwickler*innen können ihre API-Aufrufe mit Zugriffsschlüsseln authentifizieren, die im App-Dashboard über WhatsApp > API-Einrichtung generiert wurden. Lösungspartner müssen sich mit einem Zugriffsschlüssel mit der Berechtigung whatsapp_business_messaging authentifizieren.

Schritt 1: Das Objekt „interactive“ zusammenstellen

Nachrichten für einzelne Produkte

Zum Senden einer Nachricht für ein einzelnes Produkt stelle ein interactive-Objekt des Typs product mit den folgenden Komponenten zusammen:

Erforderliche Komponenten	Optionale Komponenten
Objekt „action“: Muss sowohl „catalog_id“ als auch „product_retailer_id“ enthalten	Objekt „body“ Objekt „footer“

Ausführliche Informationen dazu findest du unter Nachrichten, Objekt „interactive“. Am Ende dieses Prozesses sollte das Objekt „interactive“ in etwa wie folgt aussehen:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

Nachrichten für mehrere Produkte

Zum Senden einer Nachricht für mehrere Produkte stelle ein interactive-Objekt des Typs product_list mit den folgenden Komponenten zusammen:

Erforderliche Komponenten	Optionale Komponenten
Objekt „header“: Der Typ des Headers muss auf „text“ festgelegt sein. Denke daran, ein Objekt „text“ mit dem gewünschten Inhalt hinzuzufügen. Objekt „body“ Objekt „action“: Muss „catalog_id“ und „sections“ enthalten Bei „sections“ muss es sich um ein Array von Objekten handeln, die jeden Abschnitt mit „title“ und „product_items“ beschreiben. Der Wert von „product_items“ jedes Abschnitts muss ein Array sein, das jedes Produkt im Abschnitt mit „product_retailer_id“ und der SKU-Nummer des Produkts beschreibt.	Objekt „footer“

Erforderliche Komponenten

Optionale Komponenten

Objekt „header“: Der Typ des Headers muss auf „text“ festgelegt sein. Denke daran, ein Objekt „text“ mit dem gewünschten Inhalt hinzuzufügen.
Objekt „body“
Objekt „action“: Muss „catalog_id“ und „sections“ enthalten
- Bei „sections“ muss es sich um ein Array von Objekten handeln, die jeden Abschnitt mit „title“ und „product_items“ beschreiben.
  - Der Wert von „product_items“ jedes Abschnitts muss ein Array sein, das jedes Produkt im Abschnitt mit „product_retailer_id“ und der SKU-Nummer des Produkts beschreibt.

Objekt „footer“

Ausführliche Informationen dazu findest du unter Nachrichten, Objekt „interactive“. Am Ende dieses Prozesses sollte das Objekt „interactive“ in etwa wie folgt aussehen:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

Fehlende Artikel

Wenn keiner der in den API-Aufrufen oben bereitgestellten Artikel einem Produkt aus deinem Produktkatalog entspricht, wird eine Fehlermeldung gesendet und die Nachricht für mehrere bzw. einzelne Produkte wird nicht an den*die Benutzer*in gesendet.

Bei Nachrichten für mehrere Produkte muss mindestens ein Artikel aus der Produktliste einem Artikel aus deinem Produktkatalog entsprechen. In diesem Fall geschieht Folgendes:

Nachrichten werden erfolgreich gesendet.
Artikel ohne Übereinstimmung werden weggelassen.
Du erhältst eine Fehlermeldung und wirst zu einer Katalogaktualisierung aufgefordert.

Schritt 2: Gängige Nachrichtenparameter hinzufügen

Ist das „interactive“-Objekt fertiggestellt, füge die anderen Parameter an, die eine Nachricht ausmachen: recipient_type, to, messaging_product und type. Denke daran, type auf interactive festzulegen.

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

Informationen zu allen verfügbaren Parametern findest du unter Referenz, Nachrichten.

Schritt 3: Eine Anfrage an den Nachrichtenendpunkt senden

Sende eine POST-Anfrage an den /PHONE_NUMBER_ID/messages-Endpunkt mit dem JSON-Objekt, das du in den Schritten 1 und 2 erstellt hast. Wenn deine Nachricht erfolgreich gesendet wird, erhältst du die folgende Antwort:

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

Vorlagennachrichten für mehrere Produkte

Um eine Vorlagennachricht für mehrere Produkte zu senden, benötigst du eine Nachrichtenvorlage für mehrere Produkte. In unserem Dokument Nachrichtenvorlagen für mehrere Produkte erfährst du, wie du diese Vorlagen erstellst und in einer Vorlagennachricht sendest.

WhatsApp Business Platform | Cloud API | Business Management API