Référence sur les boutons URL

Le bouton URL ouvre une page Web dans la webview Messenger. Ce bouton peut être utilisé avec le modèle de bouton et le modèle générique.

Si le site contient des App Links, l’activation du bouton lancera une application native. Si vous venez d’effectuer le changement, vous pouvez utiliser le Programme de débug du partage pour demander une nouvelle extraction du site.

Pour en savoir plus sur l’utilisation du bouton URL, consultez la page Bouton URL.

Syntaxe du bouton URL

SDK Messenger Extensions : liste blanche obligatoire de domaines

Pour afficher une page web avec le SDK Messenger Extensions activé dans la webview Messenger, vous devez mettre le domaine sur liste blanche, sous-domaine inclus, dans la propriété whitelisted_domains du profil Messenger de votre bot. Ainsi, seuls les domaines de confiance auront accès aux informations utilisateur disponibles via les fonctions du SDK.

Pour en savoir plus sur les domaines en liste blanche, consultez la référence whitelisted_domains.

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

Exemple d'utilisation du bouton 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>"

Exemple de réponse du bouton URL

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

Propriétés du bouton URL

Propriété Type Description

type

Chaîne

Type de bouton. Valeur requise : web_url.

title

Chaîne

Titre du bouton. Nombre max. de caractères : 20.

url

Chaîne

Cette URL s’ouvre dans un navigateur mobile lorsque le bouton est actionné. Protocole HTTPS requis si messenger_extensions est définie sur « true ».

webview_height_ratio

Chaîne

Facultatif. Hauteur de la webview. Valeurs valides : compact, tall et full. Valeur par défaut : full.

messenger_extensions

Booléen

Facultatif. Valeur true requise si vous utilisez Messenger Extensions.

fallback_url

Chaîne

URL à utiliser pour les clients incompatibles avec Messenger Extensions. Si cette propriété n’est pas définie, url est utilisée comme solution de repli. Elle doit être spécifiée uniquement si messenger_extensions est définie sur « true ».

webview_share_button

Chaîne

Facultatif. Définie sur hide pour désactiver le bouton de partage dans la webview (pour les informations de nature sensible). Cela n’affecte en rien les partages effectués par le développeur ou la développeuse à l’aide des extensions.