Plugin „An Messenger senden“

Ab dem 30. September 2024 ist diese Funktion nicht mehr verfügbar. Funktionen wie m.me-Links, die Nutzer*innen an eine Person, Seite oder Unterhaltung in Messenger weiterleiten, kannst du weiterhin nutzen.

Wenn sich deine Facebook-App im Entwicklungsmodus befindet, funktionieren Plugin- und API-Funktionen nur für Administrator*innen, Entwickler*innen und Tester*innen 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