Messenger 個人檔案 API

您可以在專頁的 Messenger 個人檔案中設定屬性，透過這些屬性來定義下列 Messenger 平台功能的各個方面。請參閱下表 Messenger 個人檔案屬性以了解詳情。

• 開始使用按鈕
• 歡迎畫面
• 開場白
• 常駐選單
• 網域允許清單
• 帳戶連結
• 指令
• 探索分頁（已停用）

透過 Messenger 個人檔案 API，您可以設定、更新、檢索和刪除專頁 Messenger 個人檔案內的屬性。

權限

專頁存取憑證必須擁有 pages_messaging 權限，才可與此端點互動。

應用程式處於開發模式時，只有在應用程式上擁有角色的用戶可以看到 Messenger 個人檔案設定。

要求獲取 URI

https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>

Messenger 個人檔案屬性

您的專頁 Messenger 個人檔案可包含下列屬性。請見下表，了解各項屬性的類型與目的說明。

檢索屬性

按名稱檢索一個或多個 Messenger 個人檔案屬性的目前值。

要求參數

下列參數包含在要求的查詢字串內：

範例要求

curl -X GET "https://graph.facebook.com/v21.0/me/messenger_profile?fields=whitelisted_domains,greeting&access_token=<PAGE_ACCESS_TOKEN>"

範例回應

data 陣列會傳回您要求獲取的屬性之目前值：

{
   "data": [
        {
          "whitelisted_domains": [
            "https://facebook.com/"
          ],
          "greeting": [
            {
               "locale": "default",
               "text": "Hello!"
            },
            {
               "locale": "en_US",
               "text": "Timeless apparel for the masses."
            }
         ]
      }
   ]
}

設定／更新屬性

設定一個或多個 Messenger 個人檔案屬性值。只有在要求內文內設定的屬性才會被覆寫。

範例要求

curl -X POST -H "Content-Type: application/json" -d '{
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  ...
}' "https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

範例回應

{
    "result": "success"
}

刪除屬性

刪除一個或多個 Messenger 個人檔案屬性。只有 fields 陣列內指定的屬性才會被刪除。

範例要求

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    ...
  ]
}' "https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

範例回應

{
    "result": "success"
}