Marketing-Nachrichten

In diesem Dokument erfährst, wie du das Opt-in einer Person zum Senden von Marketing-Nachrichten erhältst, welche genauen Anforderungen und Einschränkungen für das Senden von Anfragen gelten, und wie du Opt-in-Anfragen für Marketing-Nachrichten erstellst und sendest.

Übersicht

Über Marketing-Nachrichten können Facebook-Seiten oder professionelle Instagram-Konten Nachrichten außerhalb des Standard-Nachrichtenfensters senden, wenn du die Berechtigung dazu erhalten hast. Marketing-Nachrichten ermöglichen es dir, Beziehungen zu Personen aufzubauen, die an dir oder deinem Unternehmen interessiert sind.

„Marketing-Nachrichten“ ist ein neues, optionales Premium-Feature, das wir künftig kostenpflichtig anbieten. Derzeit berechnen wir Unternehmen nur die von der WhatsApp Business API gesendeten Nachrichten und berücksichtigen bei der Preisgestaltung dafür das Kund*innenfeedback. Sollte sich etwas an der kostenlosen Testversion ändern, werden wir Kunden und Partner mit ausreichend Vorlauf darüber informieren.

Anforderungen

• Du musst alle geltenden Entwicklungsrichtlinien einhalten, wenn du Marketing-Nachrichten oder andere Features der Messenger-Plattform nutzt.

• Du darfst Opt-in-Anfragen für Marketing-Nachrichten nur innerhalb des standardmäßigen Messaging-Fensters senden. Durch die aktive Zustimmung eines*einer Nutzer*in für Marketing-Nachrichten wird nicht das 24-Stunden-Messaging-Fenster geöffnet.

• Deine App und/oder dein Messaging-Erlebnis darf nicht unverhältnismäßig viel negatives Feedback von Nutzer*innen erhalten. Sollten wir feststellen, dass das Messaging-Erlebnis deiner App Nutzer*innen vorrangig negativ auffällt, werden möglicherweise die Messaging-Funktionen eingeschränkt oder sogar entzogen.

• Du darfst Marketing-Nachrichten, einschließlich Opt-in-Anfragen, nicht dazu verwenden, Nutzer*innen Spam zu senden. Darunter fällt auch das häufige Senden wiederholter Opt-in-Anfragen an die gleichen Nutzer*innen und andere Arten von Spam, die in unseren Entwickler-Richtlinien näher definiert sind.

• Du wirst angehalten, die Auflagen und Einschränkungen für die Funktionalitäten der Messenger-Plattform bzw. der Marketing-Nachrichten zu achten, damit wir den dir gebotenen Leistungsumfang gewährleisten und aufrechterhalten können.

Einschränkungen

• Du kannst einer Person nur eine Opt-in-Anfrage pro Woche mit dem gleichen Titel senden. Dies umfasst den Standardwert von „Updates und Promotions“.
• Sende Personen keine doppelten Opt-in-Anfragen. Eine doppelte Opt-in-Anfrage ist eine Anfrage, die den gleichen title für Benachrichtigungen von einer Facebook-Seite oder die gleichen Werte für title und image_url für Benachrichtigungen von einem professionellen Instagram-Konto verwendet.
• Du kannst Opt-in-Anfragen nur während des Standardnachrichtenfensters senden.
• Wenn eine Person dem Empfang von Marketing-Nachrichten zustimmt, wird dadurch kein Standard-Messaging-Fenster geöffnet.
• Du kannst lediglich sehen, ob eine Person dem Empfang von Marketing-Nachrichten zugestimmt hat, aber nicht den Status ausstehender Opt-in-Anfragen prüfen.
• Wenn eine Person entschieden hat, keine Marketing-Nachrichten mehr zu empfangen, werden deine Nachrichten an diese Person nicht mehr zugestellt und du erhältst eine Fehlermeldung.
• Personen können deine Nachrichten blockieren, stummschalten oder melden.
• Für Marketing-Nachrichten von einem professionellen Instagram-Konto können im Allgemeinen bis zu 10 Opt-in-Anfragen mit verschiedenen Titeln pro Nutzer*in einem Zeitraum von 7 Tagen gesendet werden. Unter Umständen gilt eine zusätzliche Einschränkung, dass einem*einer Nutzer*in pro Tag nur maximal fünf Opt-in-Anfragen gesendet werden dürfen. Du solltest jedoch vor dem Senden jeder Anfrage prüfen, ob Nutzer*innen die jeweilige Opt-in-Anfrage als relevant oder brauchbar erachten werden.

Diese Voraussetzungen und Einschränkungen können sich jederzeit ändern, da wir stets das bestmögliche Nutzer*innen- und Geschäftserlebnis anstreben.

Best Practices

Für ein qualitativ hochwertiges Nutzungserlebnis solltest du nur relevante und sinnvolle Marketing-Nachrichten senden. Dazu musst du Folgendes beachten:

• Deine Opt-in-Anfrage sollte einen Titel und ein Bild beinhalten und die Nutzer*innen darüber in Kenntnis setzen, welche Arten von Marketing-Nachrichten sie erhalten werden, z. B. Updates zu Bestellungen, Produktempfehlungen oder Infos zu bestimmten Angeboten.

• Wenn du mehr als eine Opt-in-Anfrage an eine*n Nutzer*in sendest, sollte aus jeder dieser Anfragen deutlich hervorgehen, mit welchen Arten der Marketing-Nachrichten der*die Nutzer*in rechnen kann.

Die Marketing-Nachrichten sollten relevant und auf die jeweiligen Anwendungsfälle zugeschnitten sein, damit sie einen Mehrwert für Nutzer*innen haben.

Nutzer*innen können Feedback bezüglich des Messaging-Erlebnisses geben und ggf. deine Nachrichten auch blockieren, was für dich wiederum Nutzungseinschränkungen für die Marketing-Nachrichten zur Folge haben kann. Daher solltest du deine Opt-in-Anfragen und Marketing-Nachrichten stets anhand der oben beschriebenen Best Practices prüfen.

Häufigkeit von Nachrichten

Gilt für Benachrichtigungstoken, die vor dem 2. Februar 2023 erstellt wurden.

• Nachdem eine Person eingewilligt hat, kannst du ihr im täglichen, wöchentlichen oder monatlichen Rhythmus Nachrichten senden, je nachdem, wofür sich die Person bei der Genehmigung entschieden hat.

Zustimmung zum Senden von Marketing-Nachrichten anfordern

Personen müssen per Opt-in einwilligen, um Marketing-Nachrichten von deiner Facebook-Seite oder deinem professionellen Instagram-Konto zu erhalten. Die Messenger-Plattform bietet dir mehrere Möglichkeiten, eine Zustimmung zu erhalten. Du kannst Opt-in-Anfragen in die folgenden Messaging-Erlebnisse integrieren:

• Click-to-Messenger-Werbeanzeigen – wenn eine Person deine Anzeige anklickt
• Chat-Plugin – wenn eine Person über das Chat-Plugin auf deiner Website eine Unterhaltung initiiert
• Checkbox-Plugin – wenn eine Person die Checkbox in einem Formular anklickt und das Formular sendet
• m.me-Links – wenn eine Person auf den m.me-Link auf einer Website, in denen E-Mails, in deinen Social-Media-Beiträgen und mehr klickt
• Private Antworten – wenn eine Person einen Besucherbeitrag oder Kommentar auf der Facebook-Seite deines Unternehmens veröffentlicht
• QR-Codes – wenn eine Person deinen QR-Code auf digitalen oder gedruckten Oberflächen scannt (unterstützt durch m.me-Links)
• Send-to-Messenger-Plugin – wenn eine Person eine Unterhaltung mittels einer Liste von vordefinierten CTA-Buttons oder Texten initiiert

Beispiel für Opt-in-Anfrage

Um eine Opt-in-Anfrage für Marketing-Nachrichten zu senden, sende eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt, wobei der Typ der Nachrichtenvorlage auf notification_messages festgelegt ist. Die Seiten-ID ist die ID deiner Facebook-Seite oder der Facebook-Seite, die mit deinem professionellen Instagram-Konto verknüpft ist.

Hinweis: Der title-Parameter ist erforderlich, wenn Marketing-Nachrichten ein Carousel von deiner Facebook-Seite oder deinem professionellen Instagram-Konto enthalten.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Bei Erfolg erhält deine App die folgende JSON-Antwort mit IDs für Empfänger*in und Nachricht.

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

Referenz zum Nachrichten-Anhangsobjekt

Ein messageattachment-JSON-Objekt muss in der POST-Anfrage an den /PAGE-ID/messages-Endpunkt für eine Zustimmungsanfrage für Marketing-Nachrichten enthalten sein.

Benachrichtigungstoken

Wenn eine Person zustimmt, erhält dein Unternehmen eine messaging_optin-Webhook-Benachrichtigung mit einem Benachrichtigungstoken und Informationen wie dem Nachrichtentitel und der Zeitzone der Person, die zustimmt. Mit dem Benachrichtigungstoken kannst du der Person Marketing-Nachrichten senden.

Webhook-Benachrichtigung für Opt-ins

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

Das Ablaufdatum der Token wird für Personen verlängert, die sich weiterhin für den Erhalt von Marketing-Nachrichten entscheiden. Personen können den Erhalt jederzeit deaktivieren.

Follow-up-Nachrichten für Opt-ins

Wenn eine Person dem Erhalt von Marketing-Nachrichten zugestimmt hat, kannst du bis zu drei Follow-up-Nachrichten senden. Diese Nachrichten müssen innerhalb von zwei Minuten nach der ersten Follow-up-Nachricht gesendet werden. Die zweite und die dritte Follow-up-Nachricht dürfen nicht mehr als 250 Zeichen enthalten. Diese Follow-up-Nachrichten können außerhalb des standardmäßigen 24-Stunden-Zeitfensters gesendet werden.

Sende zum Schicken einer Follow-up-Nachricht eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt mit dem recipient-Objekt, das das Benachrichtigungstoken enthält, und dem message-Objekt, das den Text der Follow-up-Nachrichten umfasst. Die Syntax für die API-Anfragen ist für alle drei Follow-up-Nachrichten gleich.

Beispielanfrage

curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

Eine Liste mit Token abrufen

Um eine Liste aller gültigen Benachrichtigungstoken zu erhalten, sende eine GET-Anfrage an den /PAGE-ID/notification_message_tokens-Endpunkt.

Beispielanfrage

curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

Standardmäßig wird eine Liste von bis zu 25 Token zurückgegeben, die nach Update-Zeitpunkt sortiert ist. Um mehr zu lesen, kannst du den limit-Parameter hinzufügen. Derzeit können maximal 100 Token zurückgegeben werden. Du kannst den after-Parameter zur Paginierung verwenden. Der before-Parameter ist allerdings nicht verfügbar.

Wenn der Vorgang erfolgreich ist, erhält deine App die folgende JSON-Antwort mit Token, Empfänger*innen-ID (entweder eine Instagram-spezifische oder eine seitenspezifische ID), Erstellungszeit des Tokens, Titel der Benachrichtigung und Zeitpunkt, an dem du die nächste Marketing-Nachricht an diese*n Empfänger*in senden kannst.

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

Tokeninformationen abrufen

Auch wenn wir die Verwendung des messaging_optin-Webhooks empfehlen, um Informationen zu Marketing-Nachrichten zu sammeln, kannst du eine GET-Anfrage an den Token-Endpunkt senden und dein Token an notification_messages_, notification_messages_NOTIFICATION-MESSAGES-TOKEN anhängen, um Token-Informationen zu erhalten.

Beispielanfrage

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

Wenn der Vorgang erfolgreich ist, erhält deine App die folgende JSON-Antwort mit Benachrichtigungstoken, ID für die Person, die die Nachricht erhält, und anderen Tokeninformationen. Du verwendest das Benachrichtigungstoken und die Empfänger-ID zum Senden von Marketing-Nachrichten.

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

Diese API-Aufrufe werden auf die Ratenbegrenzung deiner App angerechnet.

Eine Marketing-Nachricht senden

Bevor du beginnst

Voraussetzungen:

• Das Nachrichten-Token der Person, die dem Empfang von Benachrichtigungen zugestimmt hat
• Die ID der Facebook-Seite deines Unternehmens
• Einen von einer Person, die auf der Seite die Aufgabe MESSAGING ausführen kann, angeforderten Seiten-Zugriffsschlüssel
• Die Berechtigung pages_messaging bei Verwendung von Facebook Login
• Alle Assets, die in die Marketing-Nachricht einbezogen werden
• Das messaging_referrals-Webhook-Abonnement für deine App

Um eine Marketing-Nachricht zu senden, sende eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt mit dem Wert NOTIFICATION-MESSAGES-TOKEN des*der Empfänger*in und Nachrichteninformationen im Nachrichtenanhang.

Einschränkungen

• Du kannst pro Benachrichtigungstoken nur eine Nachricht pro Tag senden. Wenn du mehrere Nachrichten sendest, achte darauf, nachfolgende Nachrichten um 24 Stunden zu verzögern. Andernfalls erhältst du einen Fehler. (Gilt nicht für Follow-up-Nachrichten zu Zustimmungsanfragen.)

Empfehlungen

• Wir empfehlen dir dringend, die Zeitzone einer Person zu beachten, wenn du Marketing-Nachrichten sendest, damit die Nachrichten zu einer angemessenen Zeit bei Empfänger*innen ankommen.

Beispielanfrage

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Wenn der Vorgang erfolgreich verläuft, erhält deine App die folgende Antwort:

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

Marketing-Nachrichten testen

Du kannst deine Marketing-Nachrichten jederzeit testen.

Bevor du beginnst

Voraussetzungen:

• Eine Person (Tester*in), die die Benachrichtigung erhält. Diese Person muss eine Rolle in der App innehaben.

Opt-ins testen

Du kannst deine Marketing-Nachrichten jederzeit anhand der folgenden Schritte testen.

• Schritt 1 Sende deiner Testperson eine Nachricht mit einer Opt-in-Vorlage für Marketing-Nachrichten.
• Schritt 2: Stelle sicher, dass die Testperson in der Unterhaltung auf den Opt-in-Button klickt, etwa Erhalte 50 %Rabatt auf Verkaufsnachrichten.
• Schritt 3: Sende die erste Marketing-Nachricht an deine Testperson.
• Schritt 4: Sende sofort nach der ersten Marketing-Nachricht eine zweite, für die der Parameter developer_action auf ENABLE_FOLLOWUP_MESSAGE eingestellt ist.
• Schritt 5: Sende eine weitere Marketing-Nachricht an die Testperson. Das ist deine Testnachricht.

Beispielanfrage

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

Wenn der Vorgang erfolgreich ist, erhält deine App die folgende JSON-Antwort, in der success auf true gesetzt ist.

{ "success": true }

Um erneute Opt-ins zu testen, wiederhole die Schritte und setze dabei in Schritt 4 den Parameter developer_action auf SEND_RE_OPTIN.

Nächste Schritte

• Webhooks-Benachrichtigung zum Nachrichten-Opt-in
• Sieh dir die Nachrichtentypen-Übersicht an, um mehr über die verschiedenen Nachrichtenarten zu erfahren, die du versenden kannst.

Siehe auch

• In der Referenz zu Seitennachrichten findest du weitere Informationen über verfügbare Felder für regelmäßige Nachrichten.
• Liste verfügbarer Zeitzonen
• Fehlercodes für Messenger Platform