Messenger 开放平台

Messenger 开放平台的 Instagram 消息

2024 年 7 月 23 日，我们发布了包含 Instagram 登录的全新 Instagram API。Instagram 专业账户（即业务账户或创作者账户）将不再需要与 Facebook 公共主页绑定，即可与客户、粉丝或对该 Instagram 账户或其企业感兴趣的 Instagram 用户对话、管理评论或发布影音内容。请参阅我们的博文，详细了解此新版本。

有关详情，请参阅我们的“包含 Instagram 登录的 Instagram API”一文。

通过 Messenger 开放平台，您可以构建大规模的 Instagram 专业帐户消息解决方案。

Instagram 消息可用于以下账户：

  • 商家使用的任何 Instagram 专业账户
  • 创作者使用的任何 Instagram 专业账户

您可以使用对话 API 查看所管理账户的资格。如果消息功能尚不可用，系统将返回 36103 错误代码。

常见用途

  • 获取客户发送到您 Instagram 专业收件箱中的消息
  • 接收和回复包含文本、媒体和快拍等内容的客户消息
  • 向在您的 Instagram 上发布公开帖的用户发送私信回复
  • 向对您的 Instagram 帖子发布评论的用户发送私信回复

运作方式

通过 Messenger 开放平台，您可以与对您的业务或作品感兴趣的用户对话。与您的 Instagram 专业账户绑定的 Facebook 公共主页可以通过 Messenger 开放平台促进这些对话。当用户向您的 Instagram 发送消息时，系统会将此消息发送到您的 Instagram 收件箱，并向您的服务器发送 Webhooks 通知。您的消息应用需要在 24 小时 内回复此消息。如果需要更多时间让人工客服回复消息，您可以为回复添加标签，在 24 小时标准消息时间范围过后发送消息。

Instagram 消息提供了各种对话接入点，以便用户开启对话，还提供了各种消息类型，供您的消息应用在回复消息时使用。

Instagram 收件箱

Instagram 专业账户拥有消息收件箱，便于您控制通知及管理消息。通知默认设置为关闭。您可以在收件箱设置中开启通知。系统将收件箱中的消息整理为不同类别，包括重要、一般及陌生消息。来自粉丝的新对话默认显示在“重要”文件夹中。如果对话在您实现 Instagram 消息功能前已经存在，则这些对话将位于您之前为其选择的文件夹中。

如果未关注您帐户的用户向您发送消息，则这些消息将显示在“陌生消息”文件夹中。您可以选择接受或拒绝这些陌生消息，但只有当您选择接受后，这些陌生消息才会标记为已读。接受陌生消息后，您可以将对话移动至“重要”或“一般”文件夹。如果您使用第三方应用回复陌生消息，系统会一律将这些消息移动至“一般”文件夹。

收件箱限制

  • 如果您使用第三方应用回复消息，无论您如何配置设置，系统都会将该对话移动至一般文件夹
  • 不支持收件箱文件夹，而且通过 Messenger 开放平台送达的消息不包括 Instagram from Meta 应用收件箱文件夹中显示的文件夹信息
  • 在 Instagram 应用收件箱中，系统不会将通过 API 发送的 Webhooks 通知或消息视为已读。只有在您发送回复后，系统才会将消息视为已读。

面向 Instagram 的业务账户关联登录

自 2022 年 11 月 9 日起，我们推出面向 Instagram 的业务账户关联登录。使用此登录流程，用户可在登录流程中将其 Instagram 账户转换为 Instagram 专业账户，为其商家创建 Facebook 公共主页，以及将该公共主页与其 Instagram 专业账户绑定。

要求

本指南假设您已经查看 Messenger 平台概览，并且已经设置收发消息和通知所需的组件。

  • Instagram 图谱 API – 通过此 API，商家和创作者可以使用您的应用在 Instagram 上管理形象
  • 以下权限：
    • instagram_basic
    • instagram_manage_messages
    • pages_manage_metadata
    • pages_showlist
    • business_management
  • 在您收到要求删除消息的 Webhooks 通知时，将相关消息删除

自动化体验

您可以使用以下其中一种方式为自动化消息体验提供上报途径：

  • 单个应用 – 创建自定义收件箱，用于接收或回复用户消息。此自定义收件箱由提供自动化体验的消息应用提供支持
  • 多个应用 – 通过移交协议 ，您可以将对话从一个应用或收件箱传递到另一个应用或收件箱。例如，一个应用通过自动化体验处理对话，并根据需要将此对话传递至另一个应用，以便用户继续与人工客服对话。

告知用户关于自动化体验的相关信息

根据适用法律规定，在出现以下情况时，自动化聊天体验需向用户告知是在与自动化服务互动：

  • 开始任意对话或消息对话时；
  • 互动暂停很长一段时间后；
  • 当聊天由真人互动转换至自动化体验时。

为以下群体服务的自动聊天体验应特别注意此要求：

  • 加州市场或加州用户
  • 德国市场或德国用户

披露内容可能包括但不限于：“我是 [公共主页名称] 智能助手”、“您正在与自动体验互动”、“您正在与智能助手交流”或者“我是自动智能聊天助手”。

即使没有法律要求，我们也建议遵循最佳实践，在用户与自动聊天体验互动时告知实情，这样有助于管理用户在与消息体验互动时抱有的期望。

浏览我们的开发者政策，了解更多信息。

只提供人工客服服务

通过自定义收件箱，您可以提供仅包括上报人工客服途径的消息体验。消息应用必须能够执行以下操作：

  • 接收用户发送的消息并在自定义收件箱中正确呈现这些消息
  • 通过自定义收件箱回复消息，并确保用户可以成功接收回复

限制

  • Instagram 专业账户在一次对话中只能与一位客户交流。不支持群聊消息功能
  • 如果对话在“陌生消息”文件夹中持续 30 天处于不活跃状态，系统不会在 API 调用中返回该对话
  • 当客户发送包含分享内容的消息时，Webhooks 通知中仅包含所分享的媒体或帖子的网址
  • 创作者的 Instagram 专业账户必须使用 Instagram 对话 API 发送 API 请求，账户才能接收 Webhooks

测试限制

  • 具有标准访问级别的应用只能与在应用中拥有身份的用户互动
  • 在应用被授予高级访问级别之前，某些功能可能无法正常使用
  • 如果用户要测试您的应用，必须在应用中拥有身份、授予全部所需权限的访问权限，并且在 Instagram 专业账户中拥有身份

后续步骤

另请参阅