Instagram 用户 ID:IG_ID、IGSID 与应用范围 ID
Instagram 的 API 使用三类用户 ID。IG_ID 是专业账户的 ID:使用 Instagram Login 时,GET /me 以 user_id 返回它,Webhook 以 entry.id 携带它,/<IG_ID>/media 等路径也使用它。IGSID(即 Instagram 范围 ID)代表在该账户下留言或发送私信的人。应用范围 ID 是 /me 返回的 id 字段。
easyCoexistence 为每个已连接的 Instagram 账户提供一个供其工具使用的 account_id,与 IG_ID 并存,并转发携带 IGSID 的 Meta 事件,让 Claude、ChatGPT 或您自己的代码能够通过 Meta 官方 API 回复留言和私信。
/me 中保存 Instagram 专业账户 ID 的字段,即该账户 Webhook 通知中的 id。
使用 Instagram Login 调用 /me 时,返回应用用户的应用范围 ID。
IGSID 与具体的人以及其互动的 Instagram 账户相关。
收到私信时,Webhook 携带此人的 IGSID;recipient.id 为账户的 ID。
用户资料 API 所需的同意,当此人向账户发送消息,或点击破冰问题或持久菜单项时,由 Meta 设置。
什么是 IG_ID?
IG_ID 是 Instagram 专业账户的 ID,也是大多数调用所针对的对象。使用 Instagram Login 时,GET /me?fields=user_id,username 以 user_id 返回它,Meta 指南称其等于账户 Webhook 通知中的 id,即 entry.id。使用 Facebook Login 时,主页在其 instagram_business_account 字段中返回它。/<IG_ID>/media、/<IG_ID>/conversations 和 /<IG_ID>/insights 等路径都使用它。
什么是 IGSID?
Instagram 范围 ID,当某人在账户的帖子、Reel 或 Story 下留言,或向其发送消息时生成。Meta 将其限定在此人及其互动的账户范围内,因此同一个人在每个专业账户下的 IGSID 各不相同;但在不同应用之间保持一致。Meta 表示,它让企业能够跨多个应用关联同一个人的互动。它是用于回复、查找会话及查询用户的 ID。
什么是应用范围 ID?
Instagram Login 下 GET /me 的 id 字段。Meta 指南将其称为应用用户的应用范围 ID;其示例调用在后续路径中使用的是 user_id,而非 id。登录时的代码交换也会返回一个 user_id,登录指南称其为应用用户的 Instagram 范围用户 ID。由于入门指南将 /me 的 user_id 与 Webhook 通知相关联,因此应将该值存储为 IG_ID。
每个 ID 出现在哪里?
Meta 的参考文档和 Webhook 示例按下列方式放置它们。无论此人是留言还是发送私信,都以 IGSID 显示;账户则以其 IG_ID 显示:收到的私信中为接收方,发出的私信中为发送方:
如何根据 IGSID 查询用户?
使用用户资料 API:在 graph.instagram.com 上调用 GET /<IGSID>,并需要 instagram_business_basic 和 instagram_business_manage_messages 权限。该调用需要此人的同意,Meta 仅在此人向账户发送消息或点击破冰问题或持久菜单项时设置该同意。profile_pic URL 会在几天内失效,屏蔽了该账户的用户则无法被查询。
GET https://graph.instagram.com/<IGSID>
?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
&access_token=<ACCESS_TOKEN>一种 ID 能否转换为另一种?
Meta 记录的途径都是查询。通过 IGSID,用户资料 API 可获取此人的用户名。通过用户名,在使用 Facebook Login 或统一登录时,Business Discovery 会返回另一个企业或创作者账户的 id。通过访问令牌,GET /me 可获得 IG_ID。IGSID 属于某一个专业账户,因此另一个账户所见的同一人的 IGSID 与此不同。
easyCoexistence 使用哪些 ID?
使用 Meta 的 ID,外加 easyCoexistence 自有的一个 ID。list_social_accounts 返回 account_id(即其他工具所使用的 easyCoexistence 连接 ID)和 external_id(即 IG_ID);get_social_credentials 将 IG_ID 作为 account_id_on_meta 返回。转发的事件以原样包含 platform、account_id、external_id 以及 Meta 的 entry。send_social_dm 则以此人的 IGSID 作为 recipient_id。
常见错误
- 将代码交换返回的 user_id 存为账户 ID。应从 GET /me 读取 user_id,Meta 将其与 Webhook 通知中的 id 关联。
- 在不同专业账户之间复用同一 IGSID。它只限于一个账户,因此同一人在其他账户下的 IGSID 不同。
- 查询只留过言、从未发送消息的人。Meta 仅在此人向账户发送消息或点击破冰问题或菜单项时设置同意。
- 保存 profile_pic URL。Meta 表示这些 URL 会在几天内失效,因此需要时应重新请求。
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,首 3 天免费试用。
常见问题
IGSID 与 Instagram 用户 ID 相同吗?
不相同。IGSID 用于标识某人与某个专业账户的关系,而 IG_ID 标识的是专业账户本身。
为什么我的 Webhook ID 与登录时的 ID 不一致?
代码交换返回的 user_id 被 Meta 称为 Instagram 范围的,而 Webhook 通知携带的是 GET /me 返回的 user_id。请存储 /me 返回的那个值。
能否通过 IGSID 获取某人的 Instagram 用户名?
可以,通过用户资料 API 实现,前提是此人已向账户发送消息,或点击了破冰问题或持久菜单项。
IGSID 在不同应用之间会改变吗?
不会。Meta 表示,它让企业能够跨多个应用映射同一个人的互动,但在不同专业账户之间会有所不同。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间