Du hast verschiedene Möglichkeiten, Produkte mit deinen Kund*innen zu teilen.
Katalognachrichten sind Nachrichten, 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.
Du musst in Meta hochgeladenen Bestand in einem E-Commerce-Katalog mit deinem WhatsApp-Unternehmenskonto verbunden haben.
Verwende den Endpunkt WhatsApp-Unternehmenstelefonnummer > Nachrichten, um eine Katalognachricht zu senden.
POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
{ "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>" } }
Platzhalter | Beschreibung | Beispielwert |
---|---|---|
String | Erforderlich. Text, der im Nachrichtentext angezeigt werden soll. Maximal 1024 Zeichen. |
|
String | Optional. Text, der im Footer der Nachricht angezeigt werden soll. Maximal 60 Zeichen. |
|
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 |
|
String | Telefonnummer des*der Kund*in. |
|
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!" } } }'
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA" } ] }
Katalogvorlagennachrichten sind Vorlagennachrichten, die einen Button enthalten, der beim Antippen deinen Produktkatalog in WhatsApp anzeigt.
Unter Katalogvorlagen erfährst du, wie du diese Vorlagen erstellst und sendest.
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/
Zum Beispiel:
https://wa.me/c/15555455657
Nachrichtenvorlagen-Nachrichten für mehrere Produkte (MPM, Multi-Product Message) zeigen Produktinformationen zu maximal 30 Produkten aus deinem E-Commerce-Katalog, anpassbar eingeteilt in Abschnitten.
Unter Nachrichtenvorlagen für mehrere Produkte erfährst du, wie du MPM-Vorlagen erstellst und sendest.
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 Benutzer*innen auf „Start Shopping“ (Einkauf starten) klicken: | Beispiel für Produktdetailseite: |
Kund*innen, die Nachrichten für mehrere oder einzelne Produkte erhalten, können im Wesentlichen drei Aktionen ausführen:
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:
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.
Nachrichten für mehrere und einzelne Produkte können:
Nachrichten für mehrere und einzelne Produkte können nicht:
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.
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 |
|
Änderung der Verfügbarkeit |
|
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:
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.
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.
Sie verbinden die Funktionen mit Navigationstools wie NLP, Textsuche oder Listennachrichten und Antwort-Buttons, damit Kund*innen das Gesuchte schnell finden.
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.
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.
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.
Nachrichten für mehrere Produkte eignen sich am besten, um Kund*innen zu einer bestimmten Teilmenge aus deinem Bestand zu leiten, z. B.:
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.:
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.
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.
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 |
---|---|
|
|
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" } } }
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 |
---|---|
|
|
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" }, ... ] } ] } } }
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:
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/v20.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.
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", }] }