2018 年 6 月 29 日

  • 消息 ID 格式:对于来自发送 API 的响应,其 message_id 属性中返回的消息 ID 格式已更改。

2018 年 5 月 30 日

  • 应用提交流程:现在,需要在提交前把新应用提交案设置为“开发”模式。

2018 年 5 月 23 日

  • 应用提交流程:智能助手的应用审核不再要求开发者添加测试用户。

2018 年 5 月 22 日

  • 内置 NLP:为默认 NLP 新增 sentiment 实体。

2018 年 5 月 11 日

Messenger 平台 2.4

  • 顾客聊天 SDK 现已包含在 Facebook JavaScript SDK 中,并支持编程控制顾客聊天插件的功能,例如隐藏/显示插件、隐藏/显示问候对话框等。
  • 顾客聊天插件现已支持发送者操作、用户数据快速回复,并支持用户发送附件。
  • 群发 API 引入了使用标签谓词的高级定位功能,还支持通过排期实现更简单的群发管理。
  • 发送到 Messenger 插件现在提供了 20 多种预定义的字符串,显示为插件的按钮文本。
  • 移交协议让使用线程所有者 API 管理线程状态变得更加容易。该 API 将返回当前具有线程控制权的应用的编号。
  • 消息功能成效分析 API 添加了 page_messages_total_messaging_connections 参数。这将替代已经停用的 page_messages_open_conversations_unique 参数。
  • 发送 API 会自动为发送的未包含messaging_type 属性的消息追加默认值。开发人员应尽快继续实施 messaging_type

2018 年 5 月 1 日

2018 年 4 月 4 日

  • 通过“发送 API”进行客户匹配的功能现在处于封测阶段,不再接受新主页的申请。之前获批通过“发送 API”和“客户匹配 API”使用客户匹配的主页仍可继续使用该功能。

2018 年 3 月 19 日

  • 顾客聊天插件(公测版)现在支持 greeting_dialog_displaygreeting_dialog_delay 属性。minimized 属性现已停用;开发者应尽快迁移,改为使用 greeting_dialog_display

2018 年 2 月 26 日

Messenger 平台 2.3

  • 现在,邮箱和手机号快速回复启用了一种简单的方式来要求用户提供邮箱或手机号码。快速回复的内容将根据用户的 Facebook 个人主页信息自动填充。如果用户的帐户关联了多个邮箱或手机号码,系统将针对每个邮箱或手机号码显示单独的快速回复。

  • 顾客聊天插件(公测版)引入了额外的增强功能,这些功能将于本周推出,包括易于使用的设置工具、浏览器内通知和固定菜单支持。

  • 消息功能成效分析 API 经过更新,加入了两项新指标:打开对话和新对话。

  • 有关请求对话控制权的主页收件箱支持现在包含在交接协议中。现在,将对话从“完成”移动到“收件箱”会自动触发 messaging_handovers Webhook 事件。

  • 消息标签根据用户建议进行更新,可用于三种新用途:COMMUNITY_ALERTCONFIRMED_EVENT_REMINDERNON_PROMOTIONAL_SUBSCRIPTION

  • 复选框插件现在支持自定义,包括插件内容的浅色和深色主题、透明背景和居中对齐。

  • 群发 API 通过公测,正式发布。感谢所有积极参与的开发者们为我们提供反馈。

即将发生的重大变更

  • 主页层级订阅消息功能:订阅消息发送功能的使用权限现在应用于主页层级。2018 年 12 月 31 日之前,智能助手可能会继续通过应用层级权限发送订阅消息,但如果主页管理员想要继续发送订阅消息,应该尽快申请新的主页层级访问权限。主页管理员可以在其主页设置的“Messenger 平台”选项卡申请订阅消息发送权限。

  • NON_PROMOTIONAL_SUBSCRIPTION 消息标签:现在,发送订阅消息的主页必须使用 NON_PROMOTIONAL_SUBSCRIPTION 作为消息标签,而非使用消息类型。从 2018 年 5 月 7 日起,所有主页都必须添加此消息标签,以标记根据订阅消息功能的相关政策发送的所有消息。

2018 年 2 月 13 日

2018 年 2 月 1 日

2017 年 12 月 5 日

  • 分享到 Messenger:Facebook 分享 SDK 已更新为支持通过原生 iOS 和 Android 应用直接分享到 Messenger 对话。

2017 年 11 月 22 日

2017 年 11 月 20 日

  • 发送 API:文本消息的字符数限制已从 640 个增加到 2000 个。

重大变更通知

下列关于复选框插件通过发送 API 进行客户匹配的重大变更将自 2018 年 2 月 19 日起生效。

  • 如果发送 API 请求使用来自复选框插件user_ref 或来自客户匹配phone_number 来指定消息收件人,它将不再向您的 Webhook 传递 message_readsmessage_deliveriesmessage_echoes 事件。

  • 如果发送 API 请求使用来自复选框插件user_ref 或来自客户匹配phone_number 来指定消息收件人,则发送 API 的响应将不再包含 recipient_id 属性。

2017 年 11 月 7 日

Messenger 平台 v2.2

  • 群发 API 目前为公测版,它允许拥有 pages_messaging_subscriptions 权限的智能助手通过一次 API 调用向多位接收人发送订阅消息。您可以使用自定义标签向所有开放对话或一组 PSID 发送消息。您还可以在消息发送前预估群发的覆盖量,以及在消息发送后获取实际的覆盖数据

  • 顾客聊天插件(公测版)目前处于封测阶段,它允许您在自己的网站上集成 Messenger 聊天窗口。借助这一插件,新用户可以在您的网站上发起与智能助手的对话,而再次使用的用户则会看到最近与您的所有聊天记录。该插件同时面向移动网站优化。

  • 媒体模板是新推出的结构化消息模板,用于发送图片和视频。该模板支持使用 attachment_id 发送图片、视频和 Gif 动图,同时支持使用 Facebook 网址发送已上传至 Facebook 的任何媒体,这意味着在发送视频时无需再考虑时长限制。另外,媒体模板还允许添加非必选的按钮

  • 发送赞助消息现在可以通过 Messenger 平台来完成,只需向 /sponsored_message_ads 端点发送一个 API 请求即可。该 API 充当一个轻量的多方请求协调器,可接收较少数量的请求,然后以您的名义调用现有市场营销 API。当前许多开发者已经可以使用该 API,下个月它将面向所有开发者开放。

  • 主页层级反馈是主页设置中的新增功能,位于“Messenger 点评”选项卡下面,用于提供主页层级的评分与点评汇总。在 v2.2 之前版本的平台中,用户反馈仅在应用层级汇总。

  • 移交协议当前已正式完成公测,它增加支持向当前和之前版本主页收件箱传递对话控制权。对之前版本收件箱的支持预计在 11 月中旬前全面实现。

  • 消息成效分析 API 现在新增了以下指标:page_messages_blocked_conversations_uniquepage_messages_reported_conversations_uniquepage_messages_reported_conversations_by_report_type_unique。这些指标将替代 page_messages_feedback_by_action_unique,后者现已停用并将在图谱 API v2.12 中移除。

  • 内置 NLP 现在支持 11 种语言(默认模型)以及日期/时间实体的默认本地化,同时新增了高级设置

  • 用于要求在 24 小时标准消息发送时间窗之后发送消息的非推广使用场景的消息标签现在包含 PAIRING_UPDATEAPPLICATION_UPDATE

即将发生的重大变更

  • 自本版本起,所有消息发送都应在请求正文中包含 messaging_type 属性从 2018 年 5 月 7 日起,所有消息必须包含 messaging_type 属性,没有该属性的消息将不能发送。 详情请参阅发送消息 — 消息类型

  • 消息功能成效分析 API 中的 page_messages_feedback_by_action_unique 指标现已停用,并将在图谱 API v2.12 中移除。详情请参阅分析数据

2017 年 8 月 31 日

3 个全新的消息标签

三款全新的消息标签可用于在标准的 24 小时消息窗口期之后发送非营销性质的消息

  • ACCOUNT UPDATE:用于确认用户帐户设置的更新。例如,当帐户设置和用户个人主页的首选项设置有更改,以及收到密码变更或会员到期通知时。
  • PAYMENT_UPDATE:用于提供当前交易的支付更新。例如,可用于发送收据、库存短缺、竞拍结束、退款或当前购买交易的状态变更等信息。
  • PERSONAL_FINANCE_UPDATE:用于确认用户的财务活动。例如,可用于发送关于账单支付提醒、排期支付、支付收据、转账,或涉及金融服务的其他交易活动的通知。

如需获取完整的详细信息,请参阅消息标签

2017 年 7 月 27 日

Messenger 平台 v2.1

  • 内置 NLP 是开发者在智能助手中加入自然语言处理的一种简便方法。内置 NLP 会在消息传送给智能助手之前,自动测定消息文本中的含义和信息。

  • 移交协议实现了在单一 Messenger 体验中的跨应用协作。商家可借助移交协议在单个智能助手中创建多种体验。

  • 增强功能:

    • 新版支付 SDK 让 Messenger 网页视图的支付流程更加快捷高效。客户现可在 Messenger 网页视图中一步付款。Messenger 平台 v1.2 - 2.0 中的网页支付 SDK 现已停用 — 对这些版本的支持将持续到 2018 年 2 月 1 日。
    • 添加一组扩展的 Facebook 主页按钮:去逛逛、获取支持、立即更新、现在就玩和立即开始。
    • 增加对 Messenger 功能插件 SDK 的桌面支持,实现跨移动和网页平台提供功能。用户编号和分享等功能现可在桌面使用。
    • 更新客户匹配 API,允许在发送消息前通过 API 匹配电话号码,也可以选择匹配姓名。
    • 添加全球主页聊天功能插件。实现使用网页视图和聊天功能插件进行跨地区对话分享。
    • 添加政策执行通知,当智能助手被禁用或出现政策问题时发送通知。
    • 添加新消息标签,更方便回应客户问题和提供更新:APPOINTMENT_UPDATE、GAME_EVENT、TRANSPORTATION_UPDATE、FEATURE_FUNCTIONALITY_UPDATE、TICKET_UPDATE。

2017 年 4 月 18 日

Messenger 平台 v2.0

  • Messenger 新增发现选项卡,以便展示我们生态系统中的热门智能助手、用户可以向其发消息的周边地点,以及提供支持或答疑解惑的商家。

  • 聊天功能插件:让智能助手可提供交互式社交功能,方便用户通过编辑框在对话中直接调用这些功能。

  • 参数化 Messenger 印章:让智能助手能够动态生成多个 Messenger 印章,在用户扫描各个印章时提供不同的功能。现在,用户还可以通过长按 Messenger 中的主摄像头界面来扫描印章。

  • 增强功能:

    • 用户编号匹配 API,实现同一商家的应用和智能助手之间的应用范围用户编号 (ASID) 和主页范围用户编号 (PSID) 配对

    • 开放图谱模板,方便智能助手直接向对话发送开放图谱内容。目前仅支持音乐网址的内嵌播放。

    • 现在,当用户通过 Messenger 广告进入时,智能助手可以获得广告推荐来源信息。

    • 发布平台设计工具包,其中包含用于设计智能助手的组件库。

2017 年 4 月 5 日

2017 年 3 月 2 日

Messenger 平台 v1.4

2016 年 11 月 8 日

Messenger 平台 v1.3

2016 年 9 月 12 日

Messenger 平台 v1.2

此外:

2016 年 8 月 30 日

2016 年 8 月 15 日

  • 添加了新文档:Messenger 平台政策概览。请查阅,因为政策更改可能会影响您的集成。
  • 重新添加了完整指南,该指南现已拆分为多个版块。
  • 文档导航更改。

2016 年 7 月 1 日

发送 API

接收 API

  • 新事件:message_echoes。允许开发者接收主页发送的所有消息。
  • 新事件:message_reads。通知开发者/主页:消息已被读取。
  • 新字段:app_id,用于确定智能助手消息的来源。
  • 新字段:metadata,从发送 API 传递,并发送至 message_echoes 回调,用于提高多个智能助手之间的互操作性。

用户体验

  • 重大变更“马上开始”按钮。触发回传接收回调,而不是自动发送消息。
  • 新的输入类型:快速回复。通过上一条消息附加的即时按钮让智能助手接收输入信息的新方法
  • 新的按钮类型:电话号码,用于调用本机拨号程序
  • 新的对话设置:固定菜单。支持带有最多五个元素的回传和网址
  • 新的对话设置:欢迎语。向首次使用者介绍智能助手的功能。
  • 浏览器关闭。允许在自定义网页 UI 流程结束时自动关闭浏览器窗口。
  • 帐户绑定和解绑:让商家可以从 Messenger 中检索主页范围用户编号的安全协议
  • 智能助手反馈:用户可以留下最高 5 星的点评并为开发者提供反馈。

2016 年 4 月 12 日

  • Messenger 平台发布。