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

商家可以分享重新導向至網站或其他貼文串的連結，某些連結可能包含預先填寫的文字。

當用戶點擊「開始使用」按鈕並與商家開始對話時，系統會傳送 messaging_postbacks Webhook 通知到您的 Webhook 伺服器。這則 Webhook 通知包含 postback 物件，這個物件會包含一個 referral 物件和 ref 參數。

用戶點擊 m.me 連結，且貴公司與對方曾經有過對話，這個連結會將用戶導向現有對話。這項操作會重設 24 小時標準傳訊時限，讓您的傳訊應用程式能夠回覆該用戶，同時會傳送一則 messaging_referrals Webhook 通知到您的 Webhook 伺服器。這則 Webhook 通知會包含一個 ref 參數，這個參數的來源是 m.me 連結。

轉介參數

m.me 連結可以包含 ref 參數，當用戶點擊連結時，這個參數會提供更多與對話相關的背景資訊給貴公司，例如網站上的連結相較於門市連結。這幾個類型的連結也可以將用戶導向至 Messenger 體驗所提供的特定內容或功能。


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

QR 碼

包含 ref 參數的代碼m.me 連結可以內嵌於 QR 碼中。您可以使用手機的原生相機掃描 QR 相容條碼。掃描條碼後會開啟 Messenger 應用程式，以及與貴公司之間的訊息對話。

QR 碼範例

QR 碼範例採用 http://m.me/OriginalCoastClothing?ref=summer_coupon 編碼，會觸發與 Messenger 折扣券相關的流程範例。

Webhook 通知

當您收到 Webhook 通知時，通知內容會包含與貴公司開始對話之用戶的資訊，或是包含曾與貴公司開始對話之用戶的資訊。

開始對話

當用戶點擊「開始使用」按鈕並與貴公司開始對話時，我們會在 messaging_postbacks Webhook 通知中傳送 ref 參數。

{
  "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 粉絲專頁連結之應用程式的 Advanced Access
開始使用按鈕，用於 Messenger 體驗的新對話
連結至貴公司 Facebook 粉絲專頁的應用程式必須訂閱 messaging_postbacks 和 messaging_referrals Webhook 欄位

限制

應用程式若具有「標準存取權限」，只能取得具傳訊應用程式開發人員、測試人員或管理員角色之用戶的資訊

行銷訊息同意要求

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：請務必點擊對話中的同意按鈕。我們會傳送同意通知給您。至此您就完成主題登記，可以公開使用了。

用戶點擊 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"