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

Instagram 登录错误“Invalid platform app”:排查要点

当 Instagram 登录窗口 https://www.instagram.com/oauth/authorize 不接受 client_id 中指定的应用时,就会出现“Invalid platform app”。请先检查该值:Business Login for Instagram 需要使用应用控制台中 Instagram 下方、“API setup with Instagram login”里显示的 Instagram 应用 ID,而不是控制台顶部的 Meta 应用 ID。后者由 Facebook Login 和 Unified Login 使用。

easyCoexistence 的 Meta 应用会替您运行 Business Login for Instagram:选择“新建连接”,再选择 Instagram,使用商业或创作者账户登录并批准权限,之后 Claude、ChatGPT 或您自己的平台即可通过 Meta 官方 API 发布内容、回复评论和私信,并读取数据洞察。

client_id

在 Business Login for Instagram 中,需要使用业务登录设置里找到的 Instagram 应用 ID。

2 app IDs

Facebook Login for Business 使用 Meta 应用 ID;Business Login for Instagram 使用 Instagram 应用 ID。

Exact match

redirect_uri 必须与已保存的 OAuth 重定向 URI 完全一致;控制台可能会自动添加末尾的斜杠。

Business

应用在添加 Instagram 产品前所需的应用类型。

Meta app ID

Unified Login 的代码交换使用 Meta 应用密钥,而不是 Instagram 应用 ID 和密钥。

“Invalid platform app”是什么意思?

Instagram 授权窗口无法识别请求中的应用,即无法识别它是用于让用户登录的应用。Meta 的文档没有列出这条消息本身,但说明了该窗口(https://www.instagram.com/oauth/authorize)的使用条件:应用需要已添加 Instagram 产品并启用 API setup with Instagram login,并通过其 Instagram 应用 ID 指定。如果请求中指定的是其他应用 ID,就不符合这些条件。

client_id 应填写哪个应用 ID?

Instagram 应用 ID。使用 Instagram Login 的 Meta 应用会显示两个 ID:应用控制台顶部的 Meta 应用 ID(由 Facebook Login for Business 使用)和 Instagram 应用 ID(Business Login for Instagram 将其作为 client_id)。其应用密钥在访问令牌交换中与之配对。Meta 的登录指南给出了查找路径:

1InstagramThe product in the App Dashboard
2API setup with Instagram loginThe Instagram Login setup page
33. Set up Instagram business loginThe step that holds the login settings
4Business login settingsRedirect URIs and the app's credentials
5Instagram App IDThe value client_id takes

如何构建授权 URL?

使用四个必需参数以及可选的 state,参数定义与 Meta 参考文档一致。应用控制台中“设置 Instagram 业务登录”步骤里的 Embed URL 是现成版本,已包含 Instagram 应用 ID 和权限范围。

An authorization URL for Business Login for Instagram
https://www.instagram.com/oauth/authorize
  ?client_id=<INSTAGRAM_APP_ID>
  &redirect_uri=https://app.example.com/instagram/callback
  &response_type=code
  &scope=instagram_business_basic,instagram_business_content_publish
  &state=<CSRF_TOKEN>

请求还必须匹配哪些内容?

还有三个参数必须正确,各参数的说明见 Meta 登录指南:

  • redirect_uri:必须与“业务登录设置”中保存的 OAuth 重定向 URI 完全一致;控制台可能添加了末尾斜杠,因此请对照已保存的列表进行比对。
  • response_type:code。
  • scope:instagram_business_basic 以及应用所用的其他 instagram_business_* 权限;旧的 business_* 值已于 2025 年 1 月 27 日弃用。

Instagram 登录需要哪种应用设置?

仅适用于已完成 API setup with Instagram login 设置的应用。Meta 的迁移指南规定,新建应用无法通过 Instagram Login 设置 Instagram API,因此新应用没有可提交的 Instagram 应用 ID,而是通过 Unified Login 让用户登录,使用带有 config_id 的登录 URL。在已有应用上,业务登录在 API setup with Instagram login 的第 3 步中设置,并保存重定向 URL 和 OAuth 重定向 URI。

登录成功后会发生什么?

Instagram 会携带 code 重定向到 redirect_uri。该 code 有效期为一小时,且只能使用一次;使用前请去掉 Meta 附加在末尾的 #_。服务器需使用 Instagram 应用 ID 和密钥、相同的 redirect_uri 以及 grant_type=authorization_code,向 https://api.instagram.com/oauth/access_token 发起交换。同一 code 若发送两次,会失败并返回“Matching code was not found or was already used.”。

使用 easyCoexistence 时还需要这些吗?

不需要。easyCoexistence 的 Meta 应用已经提供 Business Login for Instagram,因此账户拥有者只需在控制台中选择“新建连接”,再选择 Instagram,然后在 Instagram 自己的窗口中批准权限;应用 ID、重定向 URI 和访问令牌交换都由系统为您处理。为客户建立连接的平台,则可以通过 Partner API 中的托管连接链接把客户引导过去。

常见错误

  • 复制了应用控制台顶部的 ID。那是 Meta 应用 ID;Business Login for Instagram 需要从其业务登录设置中取得 Instagram 应用 ID。
  • 删掉了控制台为重定向 URI 添加的末尾斜杠。Meta 要求与已保存的 OAuth 重定向 URI 完全一致。
  • 沿用旧示例中的 scope 值。business_basic 及其他 business_* 名称已于 2025 年 1 月 27 日弃用。
  • 在访问令牌交换中将 Instagram 应用 ID 与 Meta 应用密钥配对。Instagram Login 需要将 Instagram 应用 ID 与其密钥一同使用。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

常见问题

Instagram 应用 ID 与 Meta 应用 ID 相同吗?

不相同。Facebook Login for Business 和 Unified Login 使用 Meta 应用 ID,而 Business Login for Instagram 使用其自身设置中显示的 Instagram 应用 ID。

Unified Login 如何登录用户?

通过带有 config_id 的登录 URL 登录,该 config_id 来自应用控制台中的配置;代码交换使用 Meta 应用 ID 和密钥,而不是 Instagram 的应用 ID 和密钥。

error_reason=user_denied 是什么意思?

表示用户取消了登录。Instagram 会以 error=access_denied、error_reason=user_denied 和 error_description=The user denied your request 重定向,应用应妥善处理这种情况。

连接 Instagram 到 easyCoexistence 需要我自己的 Meta 应用吗?

不需要。easyCoexistence 的 Meta 应用已持有 Instagram 权限,因此账户拥有者只需使用 Instagram 登录并批准这些权限即可。

继续阅读

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

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

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

验证时间