URL 버튼 참조

URL 버튼은 Messenger 웹 보기에서 웹페이지를 엽니다. 이 버튼은 버튼 템플릿 및 일반 템플릿과 함께 사용할 수 있습니다.

사이트에 앱 링크가 있을 경우 버튼을 누르면 네이티브 앱이 시작됩니다. 방금 전 변경 사항을 적용한 경우 공유 디버거를 사용하여 사이트의 새로운 스크래핑을 요청할 수 있습니다.

URL 버튼 사용에 대한 자세한 내용은 URL 버튼을 참조하세요.

URL 버튼 구문

Messenger 확장 기능 SDK - 필수 도메인 화이트리스트

Messenger 웹 보기에서 Messenger Extensions SDK를 활성화하고 웹페이지를 표시하려면 반드시whitelisted_domains봇의 Messenger 프로필 속성에서 도메인(하위 도메인 포함)을 화이트리스트에 추가해야 합니다. 그러면 신뢰하는 도메인만 SDK 함수를 통해 제공되는 사용자 정보에 액세스할 수 있습니다.

도메인을 화이트리스트에 추가하는 방법에 대한 자세한 내용은 whitelisted_domains 참고 자료를 참조하세요.

{
  "type":"web_url",
  "url":"

URL 사용 예시

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"Try the URL button!",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com/",
            "title":"URL Button",
            "webview_height_ratio": "full"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

URL 응답 예시

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

URL 속성

속성 유형 설명

type

문자열

버튼의 유형입니다. web_url이어야 합니다.

title

문자열

버튼 제목입니다. 20자로 제한됩니다.

url

문자열

이 URL은 버튼을 탭하면 모바일 브라우저에서 열립니다. messenger_extensions가 true일 경우 HTTPS 프로토콜을 사용해야 합니다.

webview_height_ratio

문자열

선택 사항. 웹 보기의 높이입니다. 유효한 값: compact, tall, full. 기본값은 full입니다.

messenger_extensions

부울

선택 사항. Messenger 확장 기능을 사용할 경우 true여야 합니다.

fallback_url

문자열

Messenger 확장 기능을 지원하지 않는 클라이언트에서 사용할 URL입니다. 이 URL이 정의되지 않은 경우 url을 폴백으로 사용합니다. 이는 messenger_extensions가 true일 경우에만 지정할 수 있습니다.

webview_share_button

문자열

선택 사항.hide로 설정하면 웹 보기에서 공유 버튼이 비활성화됩니다(민감한 정보에 사용). 이는 확장 기능을 사용하는 개발자가 시작한 공유에는 영향을 미치지 않습니다.