m.me 链接

本文档将介绍如何创建 m.me 链接，以为您打造 Messenger 体验。

m.me 是由 Meta 提供的网址服务，可将用户重定向至 Messenger 中的用户、公共主页或对话。您可将 m.me 链接用于您的网站、邮件简报等地方。

运作方式

m.me 链接的格式如下所示，其中 PAGE-NAME 是与您的消息应用关联的 Facebook 公共主页。

http://m.me/PAGE-NAME

如果用户点击 m.me 链接，系统会将该用户重定向至与商家的新对话；如果该用户曾向商家发送过消息，则系统会重定向到已有对话。对话中将显示一条默认消息：“您已通过链接进入此对话。我们已通知 PAGE-NAME 您的到访。”

您可以添加 text 参数，以便再加入一条自定义消息。

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

商家可以分享可重定向到网站或其他对话的链接，其中一些链接可能包含已预填的文本。

当用户点击“立即开始”按钮向您的商家发起对话时，系统会向您的 Webhooks 服务器发送 messaging_postbacks Webhooks 通知。在该 Webhooks 通知中，postback 对象将包含带有 ref 参数的 referral 对象。

当用户与您的商家已在对话中时，用户点击 m.me 链接会将其带入已有对话中。此操作会重置 24 小时标准消息时间范围，让消息应用回复用户，而且系统将向您的 Webhooks 服务器发送 messaging_referrals Webhooks 通知。该 Webhooks 通知将包含来自 m.me 链接的 ref 参数。

转介参数

m.me 链接可能包含 ref 参数。当用户点击此链接时，该参数将为您的商家提供更多有关此对话的背景信息，例如您的网站中的链接与店铺中的链接。m.me 链接还可将用户定向到 Messenger 体验中可用的特定内容或功能。


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

二维码

可在二维码中嵌入带有 ref 参数的 m.me 链接。您可以使用手机的原生相机扫描兼容的二维码。扫描后，Messenger 应用及与您商家的消息对话即会打开。

二维码示例

该二维码示例对 http://m.me/OriginalCoastClothing?ref=summer_coupon 进行了编码，会触发 Messenger 中某个折扣优惠券的流程示例。

Webhooks 通知

您收到的 Webhooks 通知中将包含正向商家发起对话或已与商家在对话中的用户所提供的信息。

发起对话

用户点击“立即开始”按钮向商家发起对话时，我们将发送 ref 参数作为 messaging_postbacks Webhooks 通知的一部分。

{
  "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",
    }
  }
}

在已有对话中继续

如果点击 m.me 链接的用户已与商家在对话中，系统将发送 messaging_referrals Webhooks 通知。

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

准备工作

本指南假设您已经查看 Messenger 开放平台概览，并且已经实现发送和接收消息和通知所需的组件。

您将需要：

对已与您商家 Facebook 公共主页相关联的应用的高级访问级别
“立即开始”按钮，用以在 Messenger 上开启新对话
与商家 Facebook 公共主页关联的应用必须订阅 messaging_postbacks 和 messaging_referrals Webhooks 字段

限制

具有标准访问级别的应用只能从在您的消息应用中拥有开发者、测试者或管理员身份的用户处获取信息

营销消息订阅请求

m.me/rn 网址允许您通过 m.me 链接创建定期通知订阅请求。m.me/rn 链接的格式中必须包含定期通知的主题。您可以设置定期通知的频次，否则系统将默认为 daily。

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

限制

必须使用 iOS 383 版本，m.me/rn 链接才能正常运行。系统会将点击您链接的用户重定向至基本的 m.me 网址，即 http://m.me/PAGE-NAME 网址

营销信息示例链接

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

注册主题

您必须先注册新主题，才能使用包含新主题的 m.me/rn 网址。

如果您使用之前的 m.me/rn 网址中用过的主题，且用户已订阅接收定期通知，则无需再次注册该主题。

您可以按照以下步骤注册新主题：

第 1 步：向在您的应用中拥有身份的用户发送包含该主题的定期通知订阅请求。建议添加负载，以表明此举目的是注册您的主题。

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"

若请求成功，应用会收到以下 JSON 响应：

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

第 2 步：确保点击对话中的订阅按钮。我们将向您发送有关订阅 Webhooks 通知。现在，您的主题已注册完毕，可以公开使用。

如果用户点击包含未注册主题的 m.me/rn 链接，系统会将该用户重定向至基本的定期通知网址，即 http://m.me/rn/PAGE-NAME 网址。

注册主题时，如果您向自己发送一个订阅请求，但未点击订阅按钮，则不会注册该主题。

请求示例

为方便阅读，示例格式已经过调整。

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"

成功后，应用会收到以下 JSON 响应：

{ "success": true }

`messaging_optins` Webhooks 通知