Referencia del botón de URL

El botón de URL abre una página web en la vista web de Messenger. Este botón se puede usar con las plantillas de botones y las genéricas.

Si el sitio contiene App Links, el botón hará clic en una aplicación nativa. Si acabas de hacer el cambio, puedes usar el Depurador de contenido compartido para solicitar una extracción nueva del sitio.

Consulta Botón de URL para obtener más información sobre cómo usarlo.

Sintaxis del botón de URL

SDK de extensiones de Messenger: lista de dominios autorizados requerida

Para mostrar una página web con el SDK de extensiones de Messenger activado en la vista web de Messenger, debes autorizar el dominio, incluido el subdominio, en la propiedad whitelisted_domains del perfil de Messenger del bot. De este modo, garantizarás que solo los dominios de confianza tengan acceso a la información del usuario disponible mediante las funciones del SDK.

Para obtener más información sobre la autorización de dominios, consulta la referencia de whitelisted_domains.

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

Ejemplo de uso de la 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>"

Ejemplo de respuesta de la URL

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

Propiedades de la URL

Propiedad Tipo Descripción

type

Cadena

Tipo de botón. Debe ser web_url.

title

Cadena

Título del botón. Límite de 20 caracteres.

url

Cadena

Esta URL se abre en un navegador móvil cuando se toca el botón. Se debe usar el protocolo HTTPS si el valor de messenger_extensions es “true”.

webview_height_ratio

Cadena

Opcional. Altura de la vista web. Valores válidos: compact, tall y full. El valor predeterminado es full.

messenger_extensions

Booleano

Opcional. Debe ser true si se usan extensiones de Messenger.

fallback_url

Cadena

URL que se utiliza en los clientes que no admiten extensiones de Messenger. Si no se define esta propiedad, se utiliza el valor de url como valor alternativo. Solo se puede especificar si el valor de la propiedad messenger_extensions es “true”.

webview_share_button

Cadena

Opcional. Se establece como hide para desactivar el botón “Compartir” en la vista web (en caso de información confidencial). Esto no afecta al contenido que comparta el desarrollador mediante extensiones.