URLボタンのリファレンス

URLボタンは、Messengerウェブビューでウェブページを開きます。このボタンは、ボタンおよび汎用テンプレートで利用できます。

サイトにアプリリンクが含まれている場合、ボタンをクリックするとネイティブアプリが起動します。変更を加えたばかりの場合は、シェアデバッガーを使ってサイトを新たにスクレイピングしたものをリクエストできます。

URLボタンの使用に関する詳細については、URLボタンをご覧ください。

URLボタンの構文

MessengerエクステンションSDK - 必須ドメインのホワイトリスト登録

MessengerウェブビューでMessengerエクステンションSDKが有効になっているウェブページを表示するには、ボットのMessengerプロフィールのwhitelisted_domainsプロパティで、ドメイン(サブドメインを含む)をホワイトリストに登録する必要があります。これにより、信頼できるドメインのみが、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

文字列

任意。ウェブビューの高さ。有効な値はcompacttallfullです。デフォルトはfullです。

messenger_extensions

ブーリアン

任意。Messengerエクステンションを使用する場合はtrueでなければなりません。

fallback_url

文字列

Messengerエクステンションをサポートしていないクライアントに使用するURL。これが定義されていない場合、urlがフォールバックとして使用されます。messenger_extensionsがtrueの場合にのみ指定できます。

webview_share_button

文字列

任意。hideに設定して、ウェブビューでの(個人情報の)共有ボタンを無効にします。これは、開発者がエクステンションを使って開始した共有には影響しません。