Messenger 플랫폼

사용자 프로필 API

사용자 프로필 API를 사용하면 Instagram 범위 ID(IGSID)를 통해 고객 프로필 정보를 가져올 수 있습니다. 이 정보로 비즈니스와 상호작용하는 사용자를 위한 개인화된 경험을 만들 수 있습니다.

사용자 동의

사용자 프로필에 액세스하려면 사용자 동의가 필수입니다. 사용자 동의는 누군가가 비즈니스에 메시지를 보내거나 아이스 브레이커 또는 고정 메뉴를 클릭할 때만 설정됩니다. 누군가가 게시물이나 댓글에 댓글을 남기지만 비즈니스에 메시지를 보내지 않은 경우 앱이 사용자 프로필에 액세스하려면 사용자 동의가 필수입니다라는 오류 메시지를 받게 됩니다.

요구 사항

다음과 같은 항목이 필요합니다.

  • instagram_basic 권한
  • instagram_manage_messages 권한
  • pages_manage_metadata 권한
  • pages_read_engagement 권한
  • pages_show_list 권한
  • 페이지에서 MODERATE 작업을 수행할 수 있는 사용자가 요청한 페이지 액세스 토큰

제한 사항

고객이 비즈니스를 차단한 경우 고객의 정보를 볼 수 없습니다.

사용자 프로필 필드

다음 프로필 필드는 모든 그래프 API 버전에 제공됩니다.

필드 이름 설명

name

문자열

고객 이름(이름을 설정하지 않은 경우 null일 수 있음)

profile_pic

url

고객 프로필 사진의 URL(프로필 사진을 설정하지 않은 경우 null일 수 있음). 이 URL은 며칠 이내로 만료됩니다.

다음 프로필 필드는 그래프 API v12.0 이상에 제공됩니다.

필드 이름 설명

is_verified_user

부울

고객의 인증 상태

follower_count

정수

고객의 팔로워 수

is_user_follow_business

부울

고객이 비즈니스를 팔로우하는지 여부

is_business_follow_user

부울

비즈니스가 고객을 팔로우하는지 여부

다음 필드는 그래프 API v14.0 이상에 제공됩니다.

필드설명

username

문자열

고객 Instagram 계정의 사용자 이름

예

고객의 프로필 정보를 가져오려면 고객의 Instagram 범위 ID 노드에 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,
}

개발자 지원