Messenger 开放平台

Messenger 开放平台的 Instagram 消息

On July 23, 2024 we launched the new Instagram API with Instagram Login. An Instagram professional account – Business or Creator account – will no longer need to be linked to a Facebook Page in order to have conversations with customers, followers, or Instagram users interested in their business or Instagram account, manage comments, or publish media. Learn more about this new version in our blog post.

See our Instagram API with Instagram Login to learn more.

通过 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 专业账户中拥有身份

后续步骤

另请参阅