Produkte mit Kund*innen teilen

Unternehmen haben mehrere Möglichkeiten, um Produkte mit 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 – Nachrichten mit Katalog-Miniaturbildern und einem Link zu deinem gesamten Produktkatalog.
• Produktnachrichten – Nachrichten 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 30 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": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

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

Eigenschaften

Beispielanfrage

{
  "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, können Unternehmen einen Link zu ihrem gesamten Produktkatalog senden. In einer SMS können Unternehmen 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 Unternehmen den Katalog deaktivieren, wird beim Tippen auf „wa.me“-Links und den Button Katalog ansehen in der Katalog-Link-Nachricht die Nachricht Ungültiger Katalog-Link angezeigt.

Hänge zum Erstellen des „wa.me“-Links die Telefonnummer des Unternehmens, einschließlich Landesvorwahl, 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 Benutzer*innen auf „Leg los mit dem Shopping“ klicken:	Beispiel für Produktdetailseite:

Übersicht

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

1. Produkte ansehen: Kund*innen können sich eine Liste der Produkte oder nur ein Produkt ansehen. Wenn ein*e Benutzer*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.
2. Produkte zu einem Warenkorb hinzufügen: Benutzer*innen können ein Produkt zu ihrem Warenkorb hinzufügen oder Mengen direkt in der Liste oder auf der Produktdetailseite ändern. 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 dem Unternehmen und Kund*innen so lange bestehen, bis der Warenkorb an das Unternehmen gesendet wird. Weitere Informationen dazu findest du unter Warenkorb-Erlebnis.
3. Einen Warenkorb an das Unternehmen senden: Nachdem alle benötigten Artikel hinzugefügt wurden, können Kund*innen ihren Warenkorb an das Unternehmen senden, mit dem sie kommunizieren. Danach kann das Unternehmen die nächsten Schritte festlegen, z. B. Versandinformationen anfordern oder Zahlungsoptionen angeben.

Wenn Kund*innen mehrere Geräte mit demselben WhatsApp-Konto verknüpft haben, 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 Empfänger*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. Das Unternehmen erhält außerdem eine Webhook-Benachrichtigung, die besagt, dass die Nachricht nicht zugestellt werden konnte, weil der*die Empfänger*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 derselben Unterhaltung erneut geöffnet werden.

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

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

Produkt-Updates

Unter Umständen müssen Unternehmen die Merkmale von Artikeln in ihrem Katalog aktualisieren. Je nach dem aktualisierten Merkmal verfahren wir folgendermaßen mit Nachrichten, in denen das betreffende Produkt erwähnt wird:

Warenkorb-Erlebnis

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

• Er ist speziell mit dem Chat-Thread zwischen einer Person und einem Unternehmen auf einem bestimmten Gerät verknüpft: Pro Chat-Thread zwischen Kund*in und Unternehmen 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 beim Unternehmen eröffnen und den Prozess erneut beginnen.
• Er ist unbegrenzt gültig: Der Warenkorb bleibt im Chat-Thread bestehen, bis er an das Unternehmen 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. Unternehmen können Warenkörbe nicht 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 Benutzungserfahrung. Sie eignen sich, wenn Kund*innen zur einer Teilmenge von Artikeln geleitet werden sollen, die für sie besonders relevant sind, anstatt den gesamten Bestand eines Unternehmens zu 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.

Vorteile

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

• Interaktiv 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 dem Bestand eines Unternehmens 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

Bevor du eine Nachricht sendest, musst du die WhatsApp-ID des Empfängers mit einem Aufruf an den /contacts-Node abrufen.

Wir empfehlen, Webhooks zum Empfangen des Nachrichtenstatus und von Benachrichtigungen über eingehende Nachrichten einzurichten. Auf diese Weise kannst du verfolgen, ob eine Nachricht gesendet wurde und was Kund*innen geantwortet haben.

Schritt 1: interactive-Objekt 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:

Am Ende sollte das interactive-Objekt in etwa wie folgt aussehen:

"interactive": {
    "type": "product",
    "body": {
      "text": "text-body-content"
    },
    "footer": {
      "text": "text-footer-content"
    },
    "action": {
      "catalog_id": "catalog-id",
      "product_retailer_id": "product-SKU-in-catalog"
    }
}

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:

Am Ende sollte das interactive-Objekt in etwa wie folgt aussehen:

"interactive": 
    {
    "type": "product_list",
    "header":{
       "type": "text",
        "text": "text-header-content"
     },
     "body":{
        "text": "text-body-content"
      },
     "footer":{
        "text":"text-footer-content"
     },
     "action":{
        "catalog_id":"catalog-id",
        "sections": [
             {
             "title": "the-section-title",             
             "product_items": [
                  { "product_retailer_id": "product-SKU-in-catalog" },
                  { "product_retailer_id": "product-SKU-in-catalog" },
                            ...
              ]},
              {
              "title": "the-section-title",
              "product_items": [
                 { "product_retailer_id": "product-SKU-in-catalog" }
                           ...
              ]},
               ...
       ]
     },  
    }

Fehlende Artikel

Wenn keiner der in den API-Aufrufen oben bereitgestellten Artikel einem Produkt aus dem Facebook-Katalog des Unternehmens 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 dem Facebook-Katalog des Unternehmens entsprechen. In diesem Fall geschieht Folgendes:

• Nachrichten werden erfolgreich gesendet.
• Artikel ohne Übereinstimmung werden weggelassen.
• Das Unternehmen erhält eine Fehlermeldung und wird zu einer Katalogaktualisierung aufgefordert.

Schritt 2: Allgemeine Nachrichtenparameter hinzufügen

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

{
  "recipient_type": "individual",
  "to" : "whatsapp-id", // WhatsApp ID of the recipient
  "type": "interactive",
  "interactive":{
    // The interactive object  
   }
  }

Hier findest du allgemeine Parameter, die allen Nachrichtentypen gemein sind.

Schritt 3: POST-Aufruf /messages senden

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

{
  "messages": [{
    "id": "{message-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.