m.me 連結

本文件介紹如何為 Messenger 體驗建立 m.me 連結。

m.me 是由 Meta 提供的網址服務，可將用戶重新導向 Messenger 中的用戶、專頁或對話。您可以將這些連結套用在您的網站、電郵電子通訊等地方。

運作方式

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 Webhook 通知。作為此 Webhook 通知的一部分，postback 物件包含一個 referral 物件，且該物件具有 ref 參數。

當用戶點擊 m.me 連結且您的企業與該用戶之間已經開啟對話時，該連結會將該用戶導向現有對話。此操作將會重設 24 小時標準訊息時限，這就表示您的訊息應用程式可以回覆該用戶，而且系統會向您的 Webhooks 伺服器傳送一則 messaging_referrals Webhook 通知。作為此 Webhook 通知的一部分，m.me 連結中的 ref 參數也會包含在內。

轉介參數

m.me 連結可以包含 ref 參數；當用戶點擊該連結時，此參數可為企業提供與對話相關的更多背景資料，例如您網站的連結及商店的連結。此類連結亦可將用戶導向 Messenger 體驗中的特定內容或功能。


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

QR Code

載有 ref 參數的 m.me 連結可嵌入 QR Code。您可以使用手機內置的相機掃描與 QR 相容的代碼。掃描後，Messenger 應用程式及與您企業的訊息對話即會開啟。

QR Code 範例

此 QR Code 範例採用 http://m.me/OriginalCoastClothing?ref=summer_coupon 編碼，將會觸發 Messenger 上某個折扣優惠券的範例流程。

Webhook 通知

收到 Webhook 通知時，該通知將會包含正在與您企業開始對話或已經開始對話的用戶所提供的資訊。

開始對話

當用戶點擊「開始使用」按鈕以與您的企業開始對話時，我們會傳送 ref 參數作為 messaging_postbacks Webhook 通知的一部分。

{
  "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 Webhook 通知。

{
  "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 連結的格式必須包含定期通知的主題。您可以設定定期通知接收頻率，否則系統會按預設每日傳送。

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 步：務必點擊對話中的「選擇接收」按鈕。我們將會向您傳送選擇接收 Webhook 通知。您的主題現已登記，可供公開使用。

用戶如果點擊了尚未登記主題的 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` Webhook 通知