登录开始免费试用
easyCoexistence 官方 API

Messenger Profile API:问候语、Get Started 按钮、破冰问题和固定菜单

Facebook 专页的 Messenger 资料通过 /{page-id}/messenger_profile 设置,使用带 pages_messaging 权限的专页访问令牌:POST 写入 get_started、greeting、ice_breakers、persistent_menu 和 commands 等属性,GET 通过 fields 读取,DELETE 删除 fields 数组中指定的属性。Meta 允许每个专页每 10 分钟最多 10 次调用,且只覆盖所发送的属性。

easyCoexistence 可让 Claude、ChatGPT 或您自己的代码使用 send_social_dm 在 24 小时窗口内回复 Facebook 专页的 Messenger 对话,新消息到达后会即时转发至您的 Webhook 端点。

10 per 10 min

每个专页在每个 10 分钟间隔内可进行的 Messenger Profile API 调用次数上限。

4 questions

API 可设置的破冰问题数量上限;两者都设置时,API 破冰问题优先于 Get Started 按钮。

20 items

固定菜单顶层项目数量上限;每个项目的标题限制为 30 个字符。

24 hours

专页级固定菜单更新可能需要的最长时间;为单个用户设置的菜单实时更新。

Deprecated

问候语文本。Meta 的问候语参考文档称,该功能已不再适用于 Android 和 iOS 上的 Messenger。

Messenger 资料包含哪些内容?

Facebook 专页的 Messenger 体验从这些设置开始。Meta 的 Messenger Profile API 列出了以下属性,均通过同一端点设置和读取;对于处于开发模式的应用,这些设置仅对在应用中拥有角色的人员可见:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

如何读取、设置和删除属性?

通过同一端点上的三种方法,使用专页的访问令牌调用。POST 接收 JSON 负载形式的属性,仅覆盖其中指定的属性;GET 以逗号分隔的列表形式接收 fields;DELETE 接收 JSON 负载,其中 fields 数组指定要删除的内容。POST 和 DELETE 均返回 result success。以下示例在一次调用中设置 Get Started 按钮和菜单:

Get Started and a persistent menu in one POST
POST /{page-id}/messenger_profile
{
  "get_started": { "payload": "GET_STARTED" },
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        { "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
        { "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
      ]
    }
  ]
}

{ "result": "success" }

Get Started 按钮如何运作?

该按钮位于欢迎界面上,界面会显示专页名称、头像和封面照片,以及企业通常需要的回复时间。用户点击后,会将 Get Started 发送至对话中,以 messaging_postbacks 事件的形式把 get_started.payload 发送给应用,并打开标准消息窗口。Meta 指出,当 Messenger 在 Facebook 应用内置浏览器中运行时不支持该按钮,而设置固定菜单前需要先设置该按钮。

问候语文本仍然有效吗?

在手机上已不再生效。Meta 的参考文档现已标题为 [Deprecated] Greeting Text:该功能已不再适用于 Android 和 iOS 上的 Messenger。虽然 API 可能仍接受 greeting 属性,但客户不会看到它,因此 Meta 要求开发者避免使用。按照文档说明,greeting 每个语言区域包含一段文本,default 为必填项,最多 160 个字符,可使用 {{user_first_name}}、{{user_last_name}} 或 {{user_full_name}} 进行个性化,设置它需要专页的管理员角色。

破冰问题如何运作?

它们列出最多 4 个问题,用户可点击这些问题以开始对话。该问题会如同用户自己提出一样发布到会话中,其负载会以 postback 事件的形式返回。自 2022 年 4 月起,破冰问题支持本地化:ice_breakers 中的每个对象包含 call_to_actions 和 locale,必须提供默认语言区域,对 ice_breakers 执行 DELETE 会删除全部破冰问题。Meta 按以下顺序排列争夺新对话的各项内容:

  • 两者都设置时,API 破冰问题优先于 Get Started 按钮。
  • 两者都排在专页收件箱中设置的自定义问题之前;设置 API 破冰问题后,收件箱中自定义问题的编辑功能将被禁用。

固定菜单如何构建?

菜单以数组形式呈现,每个语言区域一个,且必须设置默认语言区域。每个菜单最多包含 20 个 call_to_actions,类型为 web_url 或 postback。标题最多 30 个字符,postback 负载最多 1,000 个字符;将 composer_input_disabled 设为 true 时,菜单、按钮和 webview 将成为用户唯一的互动方式。Meta 在菜单显示前的要求如下:

  • 已设置 Get Started 按钮,并拥有 pages_messaging 权限。
  • 专页已发布,且应用设为公开。
  • 为设置菜单的人员分配专页的管理员角色。
  • 在 iOS 或 Android 上使用 Messenger v106 或更高版本,且不在 Facebook 应用的内置浏览器中。
  • 专页级别的更改最多可能需要 24 小时;针对单个用户的菜单(通过 custom_user_settings 结合 PSID 设置)可实时更新。

什么是命令?

用户可随时调用的关键词,入口包括输入框旁的命令菜单、输入斜杠或 @ 符号,或在输入匹配的词语时弹出的浮层。每个语言区域包含 1 至 100 个命令,名称长度为 1 至 32 个字符且不带前导斜杠,描述长度为 1 至 64 个字符;设置命令后,命令优先于固定菜单。被调用的命令会在 messages 事件的 message.commands 中传递给应用。

whitelisted_domains 和 account_linking_url 有什么作用?

两者都服务于对话本身之外的体验。whitelisted_domains 列出 Messenger webview 可打开的最多 50 个域名,供 Messenger Extensions SDK 和复选框插件使用。每个域名必须通过 HTTPS 提供并使用完整限定域名,不能是 IP 地址或 localhost;设置它需要专页的管理员角色。account_linking_url 是 HTTPS 回调地址,用于将用户的 Messenger 账户与其在企业中的账户关联起来。

easyCoexistence 如何设置专页的 Messenger 资料?

不能:没有任何工具调用 {page-id}/messenger_profile,也不会提供专页令牌,因此设置该资料不在此连接的范围之内。用户调用的命令会以 messages 事件的形式到达,easyCoexistence 会转发该事件,供您的自动化流程读取。Meta 报告为 messaging_postbacks 事件的点击操作(来自 Get Started、postback 菜单项和破冰问题)不会被转发,因为专页订阅的字段为 feed、messages 和 mention。

常见错误

  • 在设置固定菜单之前未先设置 Get Started。Meta 的要求包括 Get Started 按钮,因此应先设置 get_started。
  • 遗漏默认语言区域。破冰问题、菜单和命令各自都需要一个 locale 设为 default 的对象作为回退。
  • 在循环中调用 Messenger Profile API。Meta 允许每个专页每 10 分钟最多 10 次调用,因此应将多个属性合并到一次 POST 中。
  • 期望菜单变更立即生效。专页级菜单更新最多可能需要 24 小时才能送达用户。
使用 EasyCoexistence 完成这些操作

设置 Messenger 资料不在其工具之列。每个连接每月 US$ 9 至 US$ 0.75,连接越多价格越低,前 3 天免费。

常见问题

固定菜单可以针对不同用户设置吗?

可以。使用用户 PSID 的 custom_user_settings 会为该用户覆盖专页菜单,实时更新,并允许每位用户每 10 分钟最多 10 次调用。

Messenger 资料支持哪些语言区域?

Meta 列出的支持语言区域,例如 en_GB、pt_BR 或 ja_JP,另加 default,即无法匹配用户语言区域时使用的回退值。

谁可以更改专页的 Messenger 资料?

持有带 pages_messaging 权限的专页访问令牌的应用。固定菜单、问候语和域名列表还需要专页的管理员角色。

easyCoexistence 对 Facebook 专页收费多少?

每个专页算作一个连接:每个连接每月 US$ 9 至 US$ 0.75,价格随连接数量增加而下降,前 3 天免费。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间