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.“
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.
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.
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.
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:
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",
}
Feldwert | Beschreibung |
---|---|
| Die beliebigen Daten, die ursprünglich im an den m.me-Link angehängten |
| Die Quelle dieser Weiterleitung. Bei m.me-Links ist der Wert von „source“ |
| Die ID für die Weiterleitung. Bei Weiterleitungen von m.me-Links lautet dieser Wert immer |
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",
}
}