登入開始免費試用
easyCoexistence 官方 API

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 並存,同時轉發 Meta 事件及其所帶的 IGSID,讓 Claude、ChatGPT 或您自己的程式碼能透過 Meta 官方 API 回覆留言與私訊。

user_id

/me 欄位中存放 Instagram 專業帳戶 ID,即該帳戶 webhook 通知中的 id。

id

在使用 Instagram Login 的 /me 中,即應用程式用戶的應用程式範圍 ID。

Per account

IGSID 專屬於該用戶與其互動的 Instagram 帳戶。

sender.id

收到私訊時,webhook 會帶有用戶的 IGSID;recipient.id 則為帳戶的 ID。

Consent

User Profile API 所需;當用戶私訊帳戶,或點選破冰提問或固定選單時,Meta 便會設定同意。

什麼是 IG_ID?

Instagram 專業帳戶的 ID,也是大多數 API 呼叫所針對的對象。使用 Instagram Login 時,GET /me?fields=user_id,username 會以 user_id 回傳此 ID,而 Meta 指南說明它與帳戶 webhook 通知中的 id(entry.id)相同。使用 Facebook Login 時,Page 會在 instagram_business_account 欄位中回傳此 ID。/<IG_ID>/media、/<IG_ID>/conversations 及 /<IG_ID>/insights 等路徑都會使用它。

什麼是 IGSID?

Instagram 範圍 ID,於用戶留言在帳戶的貼文、Reel 或限時動態,或向帳戶傳送訊息時產生。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 顯示:在其收到的私訊中為接收者,在其發出的私訊中為發送者:

GET /me user_idIG_ID, the professional account
GET /me idApp-scoped ID of the app user
Webhook entry.idIG_ID of the account the event belongs to
comments value.from.idIGSID of the person who commented
messages sender.idIGSID on a received DM; the IG_ID on one the account sent
Conversations user_idIGSID that finds that person's conversation
Message from and toAn id with a username for each side
Page instagram_business_accountIG_ID, with Facebook Login

如何從 IGSID 查詢用戶資料?

使用 User Profile API:以 GET /<IGSID> 呼叫 graph.instagram.com,並需要 instagram_business_basic 與 instagram_business_manage_messages 權限。此操作需要用戶同意,而 Meta 只會在用戶私訊帳戶,或點選破冰提問或固定選單項目時才設定同意。profile_pic 網址會在數天內失效,而已封鎖該帳戶的用戶則無法被查詢。

A person's profile from their IGSID
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 可透過 User Profile API 取得用戶的 username。從 username 可透過 Business Discovery(使用 Facebook Login 或 Unified Login)取得另一個商業或創作者帳戶的 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 則以 account_id_on_meta 回傳 IG_ID。轉發的事件會以 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 限定於單一帳戶,因此同一用戶在其他帳戶的 IGSID 並不相同。
  • 查詢從未留言或私訊的用戶。Meta 只會在用戶私訊帳戶,或點選破冰提問或固定選單項目時才設定同意。
  • 儲存 profile_pic 網址。Meta 指出其會在數天內失效,因此需要時應重新請求。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,前 3 天免費。

常見問題

IGSID 與 Instagram 用戶 ID 相同嗎?

不相同。IGSID 用於識別某一用戶與某一專業帳戶的關係,而 IG_ID 則識別專業帳戶本身。

為何我的 webhook ID 與登入所得的 ID 不相符?

代碼交換所回傳的 user_id 被 Meta 稱為 Instagram 範圍 ID,而 webhook 通知所帶的則是 GET /me 回傳的 user_id。請儲存 /me 回傳的那一個。

能否從 IGSID 取得某人的 Instagram username?

可以,透過 User Profile API 即可,但前提是該用戶已私訊該帳戶,或點選破冰提問或固定選單項目。

IGSID 會在不同應用程式間改變嗎?

不會。Meta 指出,這讓企業能將同一用戶跨多個應用程式的互動對應起來,但它在不同專業帳戶之間會有所不同。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期