Messenger 프로필 API

페이지의 Messenger 프로필은 다음 Messenger 플랫폼 기능의 여러 가지 측면을 정의하는 속성을 설정하는 곳입니다. 자세한 내용은 아래의 Messenger 프로필 속성 표를 참조하세요.

• 시작하기 버튼
• 환영 페이지
• 아이스 브레이커
• 고정 메뉴
• 도메인 화이트리스트
• 계정 연결
• 명령
• 둘러보기 탭(사용 중단)

Messenger 프로필 API를 사용하면 페이지 Messenger 프로필에서 속성을 설정, 업데이트, 검색, 삭제할 수 있습니다.

권한

이 엔드포인트와 상호작용하려면 pages_messaging 권한이 있는 페이지 액세스 토큰이 필요합니다.

개발 모드의 앱에서 Messenger 프로필 설정은 앱에서 역할이 부여된 사용자에게만 표시됩니다.

목차

• 요청 URI
• Messenger 프로필 속성
• 속성 가져오기
• 속성 설정/업데이트
• 속성 삭제
• 사용 제한

요청 URI

https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>

Messenger 프로필 속성

페이지의 Messenger 프로필은 다음 속성을 포함할 수 있습니다. 아래의 표에서 각 속성의 유형과 목적에 대한 설명을 참조하세요.

속성 가져오기

이름별로 Messenger 프로필 속성 한 개 이상의 현재 값을 가져옵니다.

요청 매개변수

다음 매개변수가 요청의 쿼리 문자열에 포함됩니다.

요청 예시

curl -X GET "https://graph.facebook.com/v21.0/me/messenger_profile?fields=whitelisted_domains,greeting&access_token=<PAGE_ACCESS_TOKEN>"

응답 예시

요청된 속성의 현재 값은 data 배열로 반환됩니다.

{
   "data": [
        {
          "whitelisted_domains": [
            "https://facebook.com/"
          ],
          "greeting": [
            {
               "locale": "default",
               "text": "Hello!"
            },
            {
               "locale": "en_US",
               "text": "Timeless apparel for the masses."
            }
         ]
      }
   ]
}

속성 설정/업데이트

Messenger 프로필 속성 한 개 이상의 값을 설정합니다. 요청 본문에 설정된 속성만 덮어씁니다.

요청 예시

curl -X POST -H "Content-Type: application/json" -d '{
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  ...
}' "https://graph.facebook.com/v18.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

응답 예시

{
    "result": "success"
}

속성 삭제

Messenger 프로필 속성 한 개 이상을 삭제합니다. fields 배열에 지정된 속성만 삭제됩니다.

요청 예시

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    ...
  ]
}' "https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

응답 예시

{
    "result": "success"
}