You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Instagram Graph API获取conversations返回未知错误排查咨询

问题描述
  • 已完成Instagram Messaging全部入门配置步骤,开启消息控制工具,文档列明的所有前置GET请求均调用成功,仅调用Graph API拉取conversations会话列表接口时报错
  • 调用接口使用的curl命令如下:
curl -i -X GET "https://graph.facebook.com/v9.0/xxxxx/conversations?platform=instagram&access_token=EAA..."
  • 接口返回500错误,响应详情如下:
HTTP/2 500 
content-type: application/json; charset=UTF-8
access-control-allow-origin: *
facebook-api-version: v13.0
strict-transport-security: max-age=15552000; preload
pragma: no-cache
cache-control: private, no-cache, no-store, must-revalidate
expires: Sat, 01 Jan 2000 00:00:00 GMT
x-fb-request-id: AWxxxx
x-fb-trace-id: Gxxxxx
x-fb-rev: 1xxxxx
x-fb-debug: Icxxxxx
content-length: 77
date: Tue, 21 Jun 2022 04:11:42 GMT
alt-svc: h3=":443"; ma=86400, h3-29=":443"; ma=86400

{"error":{"code":1,"message":"An unknown error occurred","error_subcode":99}}
排查方案与解决步骤
  • 优先修复API版本不匹配问题:请求URL中指定的v9.0是已下线的过旧Graph API版本,从响应头可以看到平台实际生效的API版本为v13.0,跨大版本的接口兼容问题是触发这类未知错误的最常见原因。直接将URL中的版本号替换为v13.0或当前可用的稳定版本后重试,不要使用已废弃的低版本接口。
  • 校验请求ID与权限配置:
    • 确认URL路径中版本号后替换的ID为绑定了Instagram专业账户的Facebook主页ID,不能填Instagram账户ID、应用ID或其他主体ID,conversations接口的挂载主体必须是完成绑定的Facebook主页
    • 校验当前使用的access_token是否持有pages_show_list、pages_messaging、instagram_basic必要权限,权限未过期且已完成对应审核流程;测试阶段需确保使用的Instagram账户已加入应用测试人员列表
  • 补全必要请求参数:请求中额外增加user_id参数,值为绑定的Instagram专业账户ID,明确指定拉取对应账户的会话,避免平台侧做账户映射时触发内部错误;首次调试时先只保留platform=instagram和access_token两个必填参数,确认接口连通后再追加分页、字段筛选等扩展参数
  • 兜底处理方案:错误子码99属于平台侧内部服务报错,排除以上配置问题后如果仍然复现,可间隔1-2小时重试,这类临时故障通常会在短时间内自行恢复;如果报错持续超过24小时,可携带响应头中的x-fb-request-id值提交平台工单定位具体节点问题。

内容的提问来源于stack exchange,提问作者Jose Chavez

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.28 04:45:38