Messenger-Plattform

m.me-Links

In diesem Dokument wird erklärt, wie du m.me-Links für dein Messenger-Erlebnis erstellst.

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

So funktioniert's

Das Format eines m.me-Links sieht wiefolgt aus, wobei PAGE-NAME die mit deiner Messaging-App verknüpfte Facebook-Seite ist.

http://m.me/PAGE-NAME

Wenn eine Person auf einen m.me-Link klickt, wird sie entweder zu einer neuen oder einer vorhandenen Unterhaltung mit deinem Unternehmen weitergeleitet, wenn die Person deinem Unternehmen schon einmal eine Nachricht gesendet hat. In der Unterhaltung wird die folgende Nachricht angezeigt: „Du hast diese Unterhaltung geöffnet, indem du einem Link gefolgt bist. Wir lassen [SEITENNAME] wissen, dass du hier bist.“

Du kannst den text-Parameter hinzufügen, um auch eine angepasste Nachricht einzubeziehen.

http://m.me/PAGE-NAME?text=Hello%20and%20Welcome

Unternehmen können Links teilen, die zu Webseiten oder anderen Threads weiterleiten. Einige können vorformulierten Text enthalten.

Wenn eine Person auf den Button „Los geht's“ klickt, um eine Unterhaltung mit deinem Unternehmen zu beginnen, wird eine messaging_postbacks-Webhook-Benachrichtigung an deinen Webhooks-Server gesendet. Als Teil dieser Webhook-Benachrichtigung enthält das postback-Objekt ein referral-Objekt mit dem ref-Parameter.

Wenn eine Person auf einen m.me-Link klickt und eine Unterhaltung zwischen deinem Unternehmen und dieser Person bereits vorhanden ist, leitet der Link die Person zu der vorhandenen Unterhaltung. Durch diese Aktion wird das 24-stündige Zeitfenster für Standardnachrichten zurückgesetzt, sodass deine Messaging-App der Person antworten kann, und eine messaging_referrals-Webhook-Benachrichtigung wird an deinen Webhooks-Server gesendet. Als Teil dieser Webhook-Benachrichtigung ist ein ref-Parameter aus dem m.me-Link enthalten.

Weiterleitungsparameter

Ein m.me-Link kann einen ref-Parameter enthalten, der deinem Unternehmen mehr Kontext zur Unterhaltung bereitstellt, wie ein Link auf deiner Website versus ein Link in einem Shop, wenn eine Person auf den Link klickt. Diese Links können Nutzer*innen auch zu bestimmten Inhalten oder Funktionen leiten, die in deinem Messenger-Erlebnis verfügbar sind.

http://m.me/PAGE-NAME?ref=REF-PARAMETER-INFORMATION

QR-Codes

m.me-Links mit ref-Parametern können in QR-Codes eingebettet werden. QR-kompatible Codes können mit der integrierten Kamera des Telefons gescannt werden. Nach dem Scannen werden die Messenger-App und die Nachrichtenunterhaltung mit deinem Unternehmen geöffnet.

QR-Code-Beispiel

Im Beispiel-QR-Code ist http://m.me/OriginalCoastClothing?ref=summer_coupon verschlüsselt und löst einen Beispielablauf für einen Rabattcoupon im Messenger aus.

Webhook-Benachrichtigung

Wenn du eine Webhook-Benachrichtigung erhältst, enthält diese Informationen der Person, die eine Unterhaltung mit deinem Unternehmen beginnt oder mit der bereits eine Unterhaltung mit deinem Unternehmen vorhanden ist.

Eine Unterhaltung beginnen

Wenn eine Person auf den Button „Los geht's“ klickt, um eine Unterhaltung mit deinem Unternehmen zu beginnen, übermitteln wir den ref-Parameter als Teil der messaging_postbacks-Webhook-Benachrichtigung.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

Eine vorhandene Unterhaltung fortsetzen

Wenn eine Unterhaltung zwischen deinem Unternehmen und einer Person, die auf den m.me-Link klickt, bereits vorhanden ist, wird die messaging_referrals-Webhook-Benachrichtigung gesendet.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

Bevor du beginnst

Dieser Leitfaden setzt voraus, dass du die Übersicht zur Messenger-Plattform gelesen hast und die benötigten Komponenten zum Senden und Empfangen von Nachrichten und Benachrichtigungen implementiert hast.

Voraussetzungen:

  • Erweiterten Zugriff für die App, die mit der Facebook-Seite deines Unternehmens verknüpft ist
  • Ein „Los geht's“-Button für dein Messenger-Erlebnis für neue Unterhaltungen
  • Eine mit der Facebook-Seite deines Unternehmens verlinkte App muss die Webhooks-Felder messaging_postbacks und messaging_referrals abonniert haben

Einschränkungen

  • Apps mit Standardzugriff können nur Informationen von Personen abrufen, die über eine Entwickler*innen-, Tester*innen- oder Administrator*innen-Rolle in deiner Messaging-App verfügen.

Anfragen zur Zustimmung zu Marketing-Nachrichten

Anhand der URL m.me/rn kannst du eine Zustimmungsanfrage zu regelmäßigen Benachrichtigungen mit einem m.me-Link erstellen. Das Format für einen m.me/rn-Link muss das Thema für die regelmäßige Benachrichtigung enthalten. Du kannst die Frequenz für die regelmäßige Benachrichtigung festlegen, andernfalls wird standardmäßig „Täglich“ verwendet.

http://m.me/rn/PAGE-NAME?topic=TOPIC&cadence=MESSAGE-FREQUENCY

Einschränkungen

  • Damit m.me/rn-Links richtig funktionieren, ist die iOS-Version 383 erforderlich. Die Person, die auf deinen Link geklickt hat, wird zu deiner m.me-Basis-URL, http://m.me/PAGE-NAME-URL, weitergeleitet.

Beispiel-Link für Marketing-Nachrichten

https://m.me/rn/OriginalCoastClothing?topic=weekly%20deals&cadence=weekly

Registriere dein Thema

Bevor du deine m.me/rn-URL mit einem neuen Thema verwenden kann, musst du zuerst das neue Thema registrieren.

Wenn du das Thema schon einmal in einer früheren m.me/rn-URL verwendet hast und Personen dem Erhalt regelmäßiger Benachrichtigungen zugestimmt haben, musst du das Thema nicht noch einmal registrieren.

Anhand dieser Schritte kannst du ein neues Thema registrieren:

Schritt 1: Sende eine Zustimmungsanfrage für regelmäßige Benachrichtigungen mit dem Thema an eine Person, die ein Rolle in deiner App besitzt. Wir empfehlen, anhand des Payloads anzugeben, dass dein Thema damit registriert werden soll.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Wenn der Vorgang erfolgreich verläuft, erhält deine App diese JSON-Antwort:

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

Schritt 2: Klicke auf den Zustimmungs-Button in der Unterhaltung. Wir senden dir eine Webhook-Benachrichtigung zur Zustimmung. Dein Thema ist jetzt registriert und kann öffentlich verwendet werden.

Eine Person, die auf einen m.me/rn-Link mit einem Thema klickt, das nicht registriert wurde, wird zu deiner Basis-URL für regelmäßige Benachrichtigungen weitergeleitet, http://m.me/rn/PAGE-NAME-URL.

Wenn du ein Thema registrierst und dir selbst eine Zustimmungsanfrage sendest, aber nicht auf den Zustimmungs-Button klickst, wird dein Thema nicht registriert.

Beispielanfrage

Für bessere Lesbarkeit formatiert.
curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

Wenn der Vorgang erfolgreich verläuft, erhält deine App die folgende JSON-Antwort:

{ "success": true }

messaging_optins-Webhook-Benachrichtigung

Wenn du eine Webhook-Benachrichtigung erhältst, enthält diese Informationen der Person, die eine Unterhaltung mit deinem Unternehmen beginnt oder mit der bereits eine Unterhaltung mit deinem Unternehmen vorhanden ist.

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

m.me-Referenz

ParameternameBeschreibung

cadence

enum { daily, monthly, weekly }

Die Nachrichtenhäufigkeit für die Zustimmungsanfrage mit m.me/rn-Link. Standardmäßig wird daily verwendet.

ref

string

Kontext zur Unterhaltung, wie z. B. ein Link auf deiner Website im Vergleich zu einem Link in einem Store, der in einer messaging_referrals-Webhook-Benachrichtigung ausgeliefert wird. Dieser Parameter muss bei Verwendung in m.me-Links URL-kodiert sein. Dieser Wert darf nicht länger als 2.083 Zeichen sein.

text

string

Die von dir gesendete angepasste Nachricht, wenn eine Person auf deinen m.me-Link klickt, um eine Unterhaltung zu beginnen.

topic

string 		Erforderlich.

Das Thema für die m.me/rn-Link-Zustimmungsanfrage wie wöchentliche Angebote oder bevorstehende Releases. Dieser Parameter muss bei Verwendung in m.me-Links URL-kodiert sein. Alphanumerisch, keine Sonderzeichen, URL-kodiert.

Nächste Schritte

Siehe auch