Facebook Messenger
Facebook Messenger ist eine der beliebtesten Instant-Messaging-Plattformen der Welt, die von fast einer Milliarde monatlich aktiver Nutzer:innen genutzt wird. Über diese Plattform können Marken ansprechende Chatbots erstellen, die intelligent und automatisch mit ihren Kund:innen interagieren.
Die Braze- und Facebook-Integration nutzt Braze-Webhooks, Segmentierung, Personalisierung und Triggering-Features, um Ihren Nutzer:innen im Facebook Messenger über die Messenger Platform API Nachrichten zu senden. Ein angepasstes Facebook Messenger Webhook-Template ist in unserer Plattform unter Content > Webhook enthalten.
Die Facebook Messenger-Plattform ist für „nicht werbliche Nachrichten gedacht, die eine bereits bestehende Transaktion erleichtern, andere Aktionen zur Kundenbetreuung anbieten oder von einer Person angefragte Inhalte liefern.“ Weitere Informationen finden Sie in den Richtlinien der Facebook-Plattform und in den Beispielen für akzeptable Anwendungsfälle.
Voraussetzungen
Bestätigen Sie die folgenden Punkte, bevor Sie mit der Integration fortfahren:
- Facebook lässt die Nutzung der Messenger-Plattform zum Versenden von Marketing-Nachrichten nicht zu.
- Sie benötigen die ausdrückliche Zustimmung der Nutzer:innen für Nachrichten von Ihrer Seite.
- Um Nachrichten an Nutzer:innen zu senden, die keine Testnutzer:innen Ihrer Facebook App sind, muss Ihre App die App-Prüfung von Facebook bestehen.
| Anforderung | Herkunft | Zugang | Beschreibung |
|---|---|---|---|
| Facebook Messenger-Seite | https://www.facebook.com/pages/create | Eine Facebook-Seite wird als Identität für Ihren Bot verwendet. Wenn Nutzer:innen mit Ihrer App chatten, sehen sie den Seitennamen und das Profilbild. | |
| Facebook Messenger App | https://developers.facebook.com/apps | Die Facebook App enthält die Einstellungen für Ihren Messenger-Bot, einschließlich der Zugriffstoken. | |
| App-Bot-Überprüfung und -Genehmigung | https://developers.facebook.com/docs/messenger-platform/app-review | Wenn Sie bereit sind, Ihren Bot für die Öffentlichkeit freizugeben, müssen Sie ihn bei Facebook zur Überprüfung und Genehmigung einreichen. Mit diesem Überprüfungsprozess stellen wir sicher, dass Ihr Messenger-Bot unsere Richtlinien einhält und wie erwartet funktioniert, bevor er für alle Nutzer:innen im Messenger verfügbar gemacht wird. | |
| Seitenbereichs-IDs (PSIDs) | https://developers.facebook.com/docs/messenger-platform/reference/webhook-events/messages | Sie benötigen die PSIDs der Nutzer:innen, um Nachrichten im Facebook Messenger zu versenden. Wenn Nutzer:innen über Messenger mit Ihrer App interagieren, erstellt Facebook eine PSID. Diese PSID kann als angepasstes Attribut in Form eines Strings an Braze gesendet werden. | |
| Token für den Seitenzugriff | https://developers.facebook.com/docs/messenger-platform/getting-started/app-setup#page_access_token | Diese Token ähneln den Nutzerzugriffstoken, mit dem Unterschied, dass sie APIs die Erlaubnis erteilen, die Daten einer Facebook-Seite zu lesen, zu schreiben oder zu ändern. Um ein Token für den Seitenzugriff zu erhalten, müssen Sie ein Nutzerzugriffstoken anfordern und die Berechtigung manage_pages anfragen. Nachdem Sie das Nutzerzugriffstoken haben, erhalten Sie das Seitenzugriffstoken über die Graph API. |
Integration
Im Folgenden wird gezeigt, wie Sie einen Braze Facebook Messenger Webhook einrichten. Wenn Sie zusätzliche Hilfe bei der Einrichtung Ihres Bots benötigen, finden Sie im GitHub-Repository von Braze ein vollständiges Tutorial zum Messenger-Bot und Beispielcode!
1. Schritt: Sammeln Sie Ihre PSIDs
Um Nachrichten im Facebook Messenger zu versenden, müssen Sie die seitenbezogenen IDs (PSIDs) Ihrer Nutzer:innen erfassen, um sie zu identifizieren und einheitlich mit ihnen zu interagieren. PSIDs sind nicht dasselbe wie die Facebook-ID der Nutzer:innen. Facebook erstellt diesen Bezeichner jedes Mal, wenn Sie einer Kund:in eine Nachricht senden oder wenn eine Kund:in Ihnen eine Nachricht sendet.
PSIDs können über einen der verschiedenen Eingänge, die Facebook bietet, gefunden werden. Nachdem Nutzer:innen eine Nachricht an Ihre App geschickt oder eine Aktion in einer Konversation durchgeführt haben, wie z. B. das Antippen eines Buttons oder das Senden einer Nachricht, wird ihre PSID in die Eigenschaft sender.id des Webhook-Ereignisses aufgenommen, sodass Ihr Bot erkennen kann, wer die Aktion durchgeführt hat.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"sender":{
"id":"<PSID>"
},
"recipient":{
"id":"<PAGE_ID>"
},
"timestamp":1458692752478,
"message":{
"mid":"mid.1457764197618:41d102a3e1ae206a38",
"text":"hello, world!",
"quick_reply": {
"payload": "<DEVELOPER_DEFINED_PAYLOAD>"
}
}
}
Wann immer Sie eine Nachricht senden, wird die PSID in die Eigenschaft recipient.id der Anfrage aufgenommen, um zu identifizieren, wer die Nachricht erhalten soll.
2. Schritt: An Braze als angepasstes Attribut senden
Sobald Sie sicher sind, dass Sie PSIDs erhalten, koordinieren Sie dies mit Ihren Entwickler:innen, um die PSIDs als angepasstes Attribut an Braze zu senden. PSIDs sind Strings, auf die durch einen API-Aufruf zugegriffen werden kann.
3. Schritt: Richten Sie Ihr Webhook-Template ein
So erstellen Sie ein Facebook Messenger Webhook-Template:
- Gehen Sie zu Content > Webhook und wählen Sie Create webhook template.
- Wählen Sie Templates > Braze templates.
- Suchen und wählen Sie das Template „Facebook Messenger“.
-
Wählen Sie Template auswählen.
- Geben Sie einen Template-Namen an und fügen Sie Teams und Tags hinzu, falls erforderlich.
- Geben Sie Ihre Nachricht ein oder wählen Sie ein Nachrichten-Template aus den von Facebook zur Verfügung gestellten. Sie können auch die Art Ihrer Nachricht oder Ihren Tag auswählen.
- Fügen Sie die PSID als angepasstes Attribut ein. Verwenden Sie dazu den blau-weißen Button + in der Ecke des Feldes Request Body.
- Fügen Sie Ihr Token für den Seitenzugriff in die Webhook-URL ein, indem Sie
FACEBOOK_PAGE_ACCESS_TOKENdurch Ihr Token ersetzen.
Vorschau und Test Ihres Webhooks
Bevor Sie Ihre Nachricht versenden, testen Sie Ihren Webhook. Vergewissern Sie sich, dass Ihre Messenger-ID in Braze gespeichert ist (oder suchen Sie sie und testen Sie als angepasste:r Nutzer:in), und verwenden Sie die Vorschau, um die Testnachricht zu versenden:

Wenn Sie die Nachricht erfolgreich empfangen haben, können Sie die Einstellungen für die Zustellung konfigurieren.
Verwendung dieser Integration
Sobald Sie diese Integration eingerichtet haben, können Sie sie nutzen, um Nutzer:innen des Facebook Messenger gezielt anzusprechen. Wenn Sie Nachrichten nicht über die Telefonnummern der Nutzer:innen versenden und planen, Messenger-Nachrichten wiederholt zu versenden, sollten Sie für alle Nutzer:innen, für die die Messenger-ID als angepasstes Attribut existiert, ein Segment erstellen und das Analytics-Tracking aktivieren, um Ihre Messenger-Abo-Raten im Laufe der Zeit zu verfolgen.

Wenn Sie sich dafür entscheiden, kein spezielles Segment für Messenger-Abonnent:innen zu erstellen, stellen Sie sicher, dass Sie einen Filter für die vorhandene Messenger-ID einfügen, um Fehler zu vermeiden.
Sie können auch andere Segmentierungen für das Targeting Ihrer Messenger-Campaigns verwenden, und der Rest des Erstellungsprozesses funktioniert wie bei jeder anderen Campaign.