主页权限和令牌

AFP 使用该主页管理员授予的访问权限在已连接主页上执行操作。在 Facebook 上，这意味着该主页的管理员角色，以及管理它的社交账号的同意；在 Instagram Business Login 上，这意味着三项权限，涵盖账户的商业信息、评论和消息。每种授权都会按主页存储为一个访问令牌，活动的每个操作都会使用它。

概览

授权	你在哪里批准它	它启用什么	没有它会发生什么故障
Facebook 主页上的管理员角色	在 Facebook 上，该主页的设置中	AFP 向 Facebook 请求该主页自己的访问令牌，主页上的每个操作都会使用它	Facebook 不返回主页令牌，AFP 拒绝链接该主页，并报告没有管理员权限
主页管理，以 pages_manage_metadata 请求	Facebook 的同意屏幕，附加社交账号时	注册和移除主页的事件订阅	评论和消息永远不会到达 AFP，所以该主页上不会触发任何内容
Instagram 访问权限，以 instagram_basic 请求	Facebook 的同意屏幕	通过该主页的令牌，触达附加在一个已链接 Facebook 主页上的 Instagram 商业账户	附加在该主页上的 Instagram 账户无法被读取或操作
instagram_business_basic	Instagram 的同意屏幕，在 Instagram Business Login 期间	读取账户的 id、用户名、姓名和头像，这是 AFP 识别所连接内容的方式	Business Login 无法完成，也不会连接任何账户
instagram_business_manage_comments	Instagram 的同意屏幕	接收该账户上的评论事件，并对其执行评论操作	该账户上的评论触发器和评论操作会失败
instagram_business_manage_messages	Instagram 的同意屏幕	接收该账户上的私信并发送私信	私信触发器永远不会触发，也不会送达任何私信

Facebook 主页访问权限

• 授予方： 管理该主页的 Facebook 社交账号
• 存储形式： 每个已连接主页一个访问令牌
• 续期方式： 调用被拒绝时由 AFP 自己续期，或通过重新授权社交账号

AFP 通过向 Facebook 询问每个已附加社交账号管理哪些主页，来构建你可以链接的主页列表。链接时会请求该主页自己的访问令牌，Facebook 没有为其返回令牌的主页会被跳过而不是链接，并报告该社交账号对它没有管理员权限。

一个主页的令牌是发布该主页上每个操作的凭证：公开评论回复、隐藏或删除的评论、私信，以及屏蔽评论者。附加在一个已链接 Facebook 主页上的 Instagram 商业账户，使用同一个 Facebook 主页令牌运作，而不是自己的令牌。

当针对某个主页帖子的调用被拒绝时，AFP 会根据拥有该主页的社交账号当前的访问权限重写该主页的令牌，重新注册该主页的事件订阅，并重试该调用。经过这次重试仍然被拒绝，才会显现为访问权限已过期。

Instagram Business Login 访问权限

• 授予方： Instagram 商业账户自身
• 存储形式： 每个已连接账户一个长期 Instagram 令牌，有效期 60 天
• 续期方式： 每日刷新，或再次运行 Business Login

Instagram Business Login 连接一个不涉及任何 Facebook 主页的商业账户。AFP 会在 Instagram 的同意屏幕上请求三项权限——基本商业信息、管理评论和管理消息——并将由此产生的长期令牌存储在该账户上。

AFP 创建的同意链接只能使用一次，并在签发后十分钟内过期。在 Instagram 屏幕上取消、打开同一链接两次，或在过期后返回，都会以没有任何连接告终。

每个 Instagram 账户只使用一种路线。AFP 已经通过已链接 Facebook 主页触达的账户，会被 Business Login 拒绝；通过 Business Login 连接的账户，在其 Facebook 主页之后被链接时不会被再次附加。

为什么访问权限会过期，你会看到什么

症状	含义
Accounts 上的一个主页显示为已过期	为该主页存储的访问权限不再有效
一个 Facebook 社交账号分组显示为已过期	该社交账号自己的 Facebook 访问权限不再有效，所以其下的每个主页都受影响
一个社交账号的主页从可用列表中消失	AFP 向 Facebook 请求了该社交账号的主页，被拒绝，并标记了该社交账号
一条说明 Instagram 账户访问权限已过期的通知	该账户长期令牌的一次计划刷新永久失败

Instagram Business Login 令牌按设计会过期：它们是长期的而不是永久的，所以一个刷新持续失败的账户最终会停止工作。Facebook 访问权限没有 AFP 可以监控的到期日期——一个主页或社交账号会在 Facebook 第一次拒绝用它发起的调用时被标记。

主页类型	如何恢复访问权限
一个 Facebook 主页，或通过它触达的 Instagram 账户	刷新拥有该主页的社交账号的访问权限。AFP 会让你前往 Facebook 再次同意，并在你返回时清除已过期标记；该请求会保留五分钟
一个独立的 Instagram 商业账户	刷新该账户的访问权限。AFP 会让你重新走一遍 Instagram Business Login，从而存储一个新的长期令牌

自动续期

AFP 每天会刷新每个未来七天内到期的已连接 Instagram 账户的长期令牌，每次处理几个账户。因授权已失效而失败的刷新会将该账户的访问权限标记为已过期并发送通知；因其他原因失败的刷新则保持该账户不变，留待下一轮重试。

Facebook 主页令牌是按需续期的，而不是按计划续期：一次调用被拒绝，才会促使 AFP 从拥有该主页的社交账号重新推导出主页令牌。

通知目录 列出了 Instagram 令牌过期时发送的通知，以及它到达哪些渠道。

主页事件订阅

只有当一个主页的事件订阅已在平台注册并通过验证时，事件才会到达 AFP。验证是一次握手：平台用一个质询值和一个验证令牌调用 AFP，AFP 将该质询值原样返回，事件才开始流动。一次令牌无法被 AFP 识别的握手会被拒绝，平台会将该订阅视为未注册。

注册与活动相关联，而不是与链接相关联。在一个主页上创建第一个活动会注册该主页的订阅，将一个活动重新绑定到另一个主页也会注册新主页，删除一个主页上的最后一个活动会再次移除该订阅。

一个订阅覆盖了活动在该主页上可以响应的一切：其帖子上的评论活动、传入消息，以及这些消息内的按钮点击。

说明

• 为主页存储的访问权限永远不会发送到浏览器。AFP 会在它返回的每个主页列表中去除 Facebook 主页令牌和 Instagram 令牌。
• 访问权限按主页计算，而不是按账户计算。一个已过期的主页不会阻止同一账户上的其他主页，不过一个 Facebook 社交账号分组会显示其主页中最差的状态。
• Facebook 访问权限已过期的社交账号会保留其已链接的主页。这些主页会留在 Accounts 上，被标记，并在该社交账号重新授权后再次开始工作。
• 拒绝一个同意屏幕不会改变任何内容。该主页或社交账号会保持原样，仍带有标记。

相关

• 连接主页 — 附加社交账号、链接其主页，以及运行 Instagram Business Login 的流程。
• 触发事件 — 主页订阅传递的四种事件，以及每种事件为活动带入了什么。
• 通知目录 — AFP 发送的主页和令牌通知，以及每种通知发往何处。
• 为什么我的活动没有回复？ — 已过期的访问权限在活动的执行记录历史中是什么样子。