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