Plugin „An Messenger senden“

Wenn sich deine Facebook-App im Entwicklungsmodus befindet, funktionieren Plug-in- und API-Funktionen nur für Administratoren, Entwickler und Tester der App mit einer gültigen Sitzung. Wenn deine App genehmigt wurde und öffentlich ist, funktioniert sie auch für öffentliche Nutzer*innen.

Mit dem Plugin „An Messenger senden“ wird ein Authentifizierungs-Event an deinen Webhook ausgelöst. Du kannst Daten übergeben, um zu erfahren, welche*r Nutzer*in und welche Transaktion mit dem Authentifizierungs-Event verknüpft waren, und den*die Nutzer*in in deinem Backend verknüpfen.

Wenn eine Person zum ersten Mal auf diesen Button klickt, wird ein Bestätigungs-Popup angezeigt.

Anforderungen

Facebook JavaScript-SDK

Um das Plugin „An Messenger senden“ zu verwenden, musst du das Facebook-SDK für JavaScript in die Seite aufnehmen, auf der das Plugin gerendert wird.

Eine Anleitung zum Aufnehmen des SDK findest du im Schnellstart für das Facebook-SDK für JavaScript.

Setup

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

Eine vollständige Beschreibung der verfügbaren Attribute findest du in der Referenz zum Plugin „An Messenger senden“.

Event-Abonnement

Abonniere Plugin-Events.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

Event-Felder

Name des Feldes	Typ	Beschreibung
`event`	Enum	Name des Events. Mögliche Werte: `rendered`, `clicked`, `not_you`,`opt_in`.
`ref`	String	Enthält den Wert, der am `data-ref`-Parameter für das Plugin festgelegt wurde. Nur alphanumerische Zeichen sowie „-“, „_“ und „=“ werden unterstützt.
`is_after_optin`	Boolescher Wert	Gibt an, ob das Event stattgefunden hat, nachdem das Bestätigungs-Popup bestätigt wurde.
`pluginID`	nicht definiert	Dieses Feld wird nicht verwendet.

Webhook-Event

Das „An Messenger senden“-Plugin löst das messaging_optins-Webhook-Event aus.

Anpassen des Anmeldeverhaltens

Wenn kein*e angemeldete*r Facebook-Nutzer*in vorhanden ist, wird das Plugin ohne angezeigte Nutzer*innen-Identität dargestellt. Bei Klick auf den Button wird der*die Nutzer*in dazu aufgefordert, sich anzumelden.

Wenn du allow_login auf „false“ setzt, wird das Plugin nicht für Nutzer*innen angezeigt, die nicht angemeldet sind.

Beachte, dass das Plugin nur dann ohne Facebook-Sitzung angezeigt wird, wenn die App genehmigt wurde und öffentlich ist.

CTA-Textoptionen

Das Plugin „An Messenger senden“ unterstützt auch das Attribut cta_text. Damit kannst du den Button-Text für das Plugin aus einer vordefinierte Liste von Strings auswählen. Wenn das Attribut cta_text verwendet wird, müssen die meisten angemeldeten Nutzer*innen nur auf den Plugin-Button selbst klicken, um zuzustimmen, ohne das Popup erneut bestätigen zu müssen, und das Event messaging_optins wird sofort ausgeliefert.

Die folgenden Werte werden für das Attribut cta_text unterstützt:

GET_THIS_IN_MESSENGER
RECEIVE_THIS_IN_MESSENGER
SEND_THIS_TO_ME
GET_CUSTOMER_ASSISTANCE
GET_CUSTOMER_SERVICE
GET_SUPPORT
LET_US_CHAT
SEND_ME_MESSAGES
ALERT_ME_IN_MESSENGER
SEND_ME_UPDATES
MESSAGE_ME
LET_ME_KNOW
KEEP_ME_UPDATED
TELL_ME_MORE
SUBSCRIBE_IN_MESSENGER
SUBSCRIBE_TO_UPDATES
GET_MESSAGES
SUBSCRIBE
GET_STARTED_IN_MESSENGER
LEARN_MORE_IN_MESSENGER
GET_STARTED