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
相关产品推荐
相关产品推荐

