Verwendung von m.me-Links

Bei m.me handelt es sich um einen Kurz-URL-Service von Facebook, der Nutzer an eine Person, Seite oder einen Bot im Messenger weiterleitet. Du kannst sie auf deiner Webseite, in E-Mail-Newslettern und anderen Elementen verwenden.

Wenn ein Nutzer über einen m.me-Link eine neue Unterhaltung beginnt oder eine bestehende Unterhaltung mit deinem Bot fortsetzt, erscheint die folgende Nachricht in der Unterhaltung: „Du bist über einen Link zu dieser Unterhaltung gelangt. Wir lassen [SEITENNAME] wissen, dass du hier bist.“

Inhalt

Format von m.me-Links

Das Format des Links lautet http://m.me/<PAGE_NAME>, wobei PAGE_NAME der Handle der Facebook-Seite ist, mit der der Bot verlinkt ist.

Weiterleitungsparameter

Neben der neuen Möglichkeit, deinen Bot zu verlinken, unterstützt die Messenger-Plattform auch die Weitergabe beliebiger Parameter über diese Links.

Das kann sich für viele Zwecke wie das Tracking verschiedener Links in unterschiedlichen Kanälen oder das Verbinden eines Messenger-Nutzers mit einer Sitzung oder einem Konto in einer externen App eignen. Du kannst damit sogar Nutzer zu bestimmten im Bot verfügbaren Inhalten oder Feature weiterleiten.

Ein m.me-Link mit einem angehängten Parameter sieht wie folgt aus:

http://m.me/<PAGE_NAME>?ref=<REF_PARAM>

Der Wert des ref-Parameters wird per Webhook an den Server übergeben.

Anforderungen

  • Der Weiterleitungsparameter muss ein String mit maximal 2.083 Zeichen sein.

  • Für deinen Bot muss ein „Los geht‘s“-Button festgelegt sein, damit er den Weiterleitungsparameter für neue Unterhaltungen empfängt.

  • Die Seite, mit der der Bot verbunden ist, muss veröffentlicht sein, um den Weiterleitungsparameter für alle Nutzer zu empfangen, mit Ausnahme derer mit Entwickler-, Tester- oder Administratorrolle für deinen Bot.

  • Der Weiterleitungsparameter wird im Messenger-Web-Client sowie in der Messenger-App für iOS und Android ab Version 92.0 unterstützt.

Auslesen der übergebenen Parameter

Wenn ein m.me-Link mit einem ref-Parameter deinen Messenger mit deinem Bot öffnet, gibt es zwei mögliche Szenarien, die du berücksichtigen musst:

1. Szenario bei Erstnutzern

Wenn du einen „Los geht's“-Button für deine Seite konfiguriert hast, stellen wir den übergebenen ref-Parameter als Teil des Postback-Events bereit, das normalerweise beim Antippen des Buttons gesendet wird.

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"<USER_DEFINED_PAYLOAD>",
    "referral": {
      "ref": "ref_data_in_m_dot_me_param",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

Im obigen Beispiel verweist USER_DEFINED_PAYLOAD auf die Payload, die du zuvor für das Senden im Postback konfiguriert hast.

Der referral-Teil weist immer das folgende Format auf:

"referral": {
   "ref": "ref_data_in_m_dot_me_param",
   "source": "SHORTLINK",
   "type": "OPEN_THREAD",
  }
FeldwertBeschreibung

ref

Die beliebigen Daten, die ursprünglich im an den m.me-Link angehängten ref-Parameter übergeben wurden.

source

Die Quelle dieser Weiterleitung. Bei m.me-Links ist der Wert von „source“ “SHORTLINK”. Bei Weiterleitungen aus Messenger Conversation Ads ist der Wert von „source“ "ADS".

type

Die ID für die Weiterleitung. Bei Weiterleitungen von m.me-Links lautet dieser Wert immer "OPEN_THREAD".

2. Szenario bei bestehenden Nutzern

Wenn der Nutzer bereits einen Thread mit deinem Bot begonnen hat, zeigt der Messenger nach dem Aktivieren des m.me-Links keinen „Los geht's“-Bildschirm an, sondern öffnet lediglich den Thread.

In diesem Fall erhält dein Webhook umgehend ein messaging_referrals-Event. Der Webhook muss dieses Event bereits abonniert haben, um in diesem Szenario über die Weiterleitung benachrichtigt zu werden.

Beachte bitte, dass das 24-Stunden-Zeitfenster für Standard-Messaging nicht zurückgesetzt wird, wenn ein Nutzer durch Klicken auf einen m.me-Link zu deinem Bot zurückkehrt.

Das messaging_referrals-Webhook-Event verfügt über folgendes Format:

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "ref_data_in_m_dot_me_param",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}