網址按鈕參考

網址按鈕會在 Messenger 網頁檢視中開啟網頁。這個按鈕可用於按鈕範本和一般型範本。

如果網站包含應用程式連結，按鈕將點擊進入原生應用程式。如果您剛剛進行了變更，則可以使用分享偵錯工具要求重新抓取網站。

若要進一步瞭解如何使用網址按鈕，請參閱網址按鈕。

網址按鈕語法

Messenger 擴充功能 SDK - 必須將網域列入許可清單

若要使用在 Messenger Webview 中啟用的 Messenger 擴充功能 SDK 來顯示網頁，您必須在 Bot 的 Messenger 個人檔案 whitelisted_domains 屬性中將網域（包括子網域）列入允許清單。如此可確保只有受信任的網域才能透過 SDK 功能存取可用的用戶資訊。

有關將網域列入允許清單的詳細資訊，請參閱 whitelisted_domains 參考資料。

{
  "type":"web_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>"

網址回應範例

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

網址屬性

屬性	類型	說明
`type`	字串	按鈕類型。必須為 `web_url`。
`title`	字串	按鈕標題。限 20 個字元。
`url`	字串	點按按鈕時，此網址將在行動瀏覽器中開啟。如果 `messenger_extensions` 為 true，則必須使用 HTTPS 通訊協定。
`webview_height_ratio`	字串	*選用項目。*網頁檢視的高度。有效值：`compact`、`tall`、`full`。預設為 `full`。
`messenger_extensions`	布林值	*選用項目。*如果使用 Messenger 擴充功能，必須為 `true`。
`fallback_url`	字串	對於不支援 Messenger 擴充套件的用戶端，要在用戶端上使用的網址。如果未定義這個屬性，將會退而使用 `url`。只有在 `messenger_extensions` 為 true 的情況下，才可指定這個屬性。
`webview_share_button`	字串	*選用項目。*設定為 `hide` 可停用網頁檢視的分享按鈕（針對敏感資料）。這不會影響開發人員使用擴充功能起始的任何分享。