Messenger 開放平台

用戶個人檔案 API

用戶個人檔案 API 可讓您使用 Instagram 範圍編號（IGSID）擷取顧客個人檔案資訊。您可以利用此資訊，針對與商家互動的用戶，打造個人化體驗。

用戶同意

需要用戶同意才能存取用戶個人檔案。只有當用戶傳送訊息給商家，或者點擊 Icebreaker 或常駐功能表時，系統才會設定用戶同意。如果用戶在貼文或留言上留言，但尚未傳送訊息給商家，應用程式將收到錯誤訊息：「需要用戶同意才能存取用戶個人檔案」。

必備條件

必備項目：

  • instagram_basic 權限
  • instagram_manage_messages 權限
  • pages_manage_metadata 權限
  • pages_read_engagement 權限
  • pages_show_list 權限
  • 可在粉絲專頁執行 MODERATE 任務之用戶所要求的粉絲專頁存取權杖

限制

如果顧客已封鎖您的商家，您將無法檢視其資訊。

用戶個人檔案欄位

下列個人檔案欄位適用於所有圖形 API 版本。

欄位名稱 說明

name

字串

顧客名稱（若未設定名稱，可為空值）

profile_pic

網址

顧客的大頭貼照網址（若未設定大頭貼照，可為空值）。網址將在幾天後過期。

下列個人檔案欄位適用於圖形 API 12.0 和以上版本。

欄位名稱 說明

is_verified_user

布林值

顧客的驗證狀態

follower_count

整數

顧客的粉絲人數

is_user_follow_business

布林值

指出顧客是否追蹤商家

is_business_follow_user

布林值

指出商家是否追蹤顧客

下列欄位適用於圖形 API 14.0 和以上版本。

欄位說明

username

字串

顧客的 Instagram 帳號用戶名稱

範例

若要取得顧客的個人檔案資訊，請傳送 GET 要求至顧客的 Instagram 範圍編號節點，並包含您想要檢視的欄位。

要求範例

格式化以方便讀取。
curl -X GET "https://graph.facebook.com/v19.0/instagram-scoped-user-id
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=page-access-token"

成功時，應用程式會收到下列 JSON 回應：

{
  "name": "Peter Chang",
  "username": "peter_chang_live",
  "profile_pic": "https://fbcdn-profile-...",
  "follower_count": 1234
  "is_user_follow_business": false,
  "is_business_follow_user": true,
}

開發人員支援