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 回覆留言與私訊。
/me 欄位中存放 Instagram 專業帳戶 ID,即該帳戶 webhook 通知中的 id。
在使用 Instagram Login 的 /me 中,即應用程式用戶的應用程式範圍 ID。
IGSID 專屬於該用戶與其互動的 Instagram 帳戶。
收到私訊時,webhook 會帶有用戶的 IGSID;recipient.id 則為帳戶的 ID。
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 顯示:在其收到的私訊中為接收者,在其發出的私訊中為發送者:
如何從 IGSID 查詢用戶資料?
使用 User Profile API:以 GET /<IGSID> 呼叫 graph.instagram.com,並需要 instagram_business_basic 與 instagram_business_manage_messages 權限。此操作需要用戶同意,而 Meta 只會在用戶私訊帳戶,或點選破冰提問或固定選單項目時才設定同意。profile_pic 網址會在數天內失效,而已封鎖該帳戶的用戶則無法被查詢。
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 指出其會在數天內失效,因此需要時應重新請求。
每個連接每月 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 監察
驗證日期