Messenger 個人檔案 API

您可以在粉絲專頁的 Messenger 個人檔案中設定屬性，以定義下列 Messenger 開放平台功能的各個層面。如需詳細資訊，請參閱下面的 Messenger 個人檔案屬性表格。

• 「開始使用」按鈕
• 歡迎頁面
• 破冰問題
• 常駐功能表
• 網域許可清單
• 帳號連結
• 指令
• 「探索」頁籤（已停用）

Messenger 個人檔案 API 可讓您從粉絲專頁的 Messenger 個人檔案中設定、更新、擷取及刪除屬性。

權限

必須要有具備 pages_messaging 權限的粉絲專頁存取權杖，才能與此端點互動。

應用程式處於開發模式時，只有在應用程式中擔任角色的用戶才能看見 Messenger 個人檔案設定。

內容

• 要求 URI
• Messenger 個人檔案屬性
• 擷取屬性
• 設定／更新屬性
• 刪除屬性
• 速率限制

要求 URI

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

Messenger 個人檔案屬性

粉絲專頁的 Messenger 個人檔案可能包含下列屬性。請查看下表中的說明，瞭解各項屬性的類型和用途。

擷取屬性

依名稱擷取一或多個 Messenger 個人檔案屬性的目前值。

要求參數

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

要求範例

curl -X GET "https://graph.facebook.com/v19.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/v18.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/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

回應範例

{
    "result": "success"
}