Messenger 平台

用戶個人檔案 API

用戶個人檔案 API 可讓您使用 Instagram 範圍編號 (IGSID) 以檢索顧客個人檔案資訊。您可以使用此資訊，為與您企業互動的用戶提供個人化體驗。

用戶同意

需要用戶同意才能存取用戶個人檔案。只有當用戶向企業傳送訊息或點擊開場白或常駐選單時，才需要設定用戶同意。如果某位用戶對帖子或回應發表回應，但尚未向企業傳送訊息，您的應用程式將收到錯誤，顯示「需要用戶同意才能存取用戶個人檔案」。

必要條件

您需要下列項目：

  • instagram_basic 權限
  • instagram_manage_messages 權限
  • pages_manage_metadata 權限
  • pages_read_engagement 權限
  • pages_show_list 權限
  • 專頁存取憑證，由可以在專頁上執行 MODERATE 任務的用戶所要求

限制

如果顧客封鎖了您的企業，您將無法查看其資訊。

用戶個人檔案欄位

以下個人檔案欄位適用於所有 Graph API 版本。

欄位名稱 說明

name

字串

顧客姓名（如果未設定姓名，可為 null）

profile_pic

url

顧客個人資料相片的網址（如果未設定個人資料相片，可為 null）。此網址將在數天後過期。

以下個人檔案欄位適用於 Graph API v12.0 及以上版本。

欄位名稱 說明

is_verified_user

布林值

顧客的驗證狀態

follower_count

整數

顧客的追蹤者人數

is_user_follow_business

布林值

指明顧客有否追蹤企業

is_business_follow_user

布林值

指明企業有否追蹤顧客

以下欄位適用於 Graph API v14.0 及以上版本。

欄位說明

username

字串

顧客 Instagram 帳戶的用戶名稱

範例

如要取得顧客的個人檔案資訊，請向顧客的 Instagram 範圍編號節點傳送 GET 要求，並加入您想查看的欄位。

要求範例

我們已設定格式以便閱讀。
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,
}

開發人員支援