Referencia al botón de URL

El botón de URL abre una página web en la vista web de Messenger. También se puede usar con la plantilla de botón y la plantilla genérica.

Si el sitio contiene App Links, el botón hará clic en la app nativa. Si acabas de hacer el cambio, puedes usar el Depurador de contenido compartido para solicitar un nuevo scraping del sitio.

Para obtener más información sobre cómo usar el botón de URL, consulta la sección Botón de URL.

Sintaxis del botón de URL

SDK de extensiones de Messenger: Lista blanca de dominios obligatorios

Para mostrar una página web con el SDK de extensiones de Messenger activado en la vista web de Messenger, es necesario que incluyas el dominio (y el subdominio) en la lista de autorizados en la propiedad whitelisted_domains del perfil de Messenger de tu bot. Esto garantiza que solo los dominios confiables tengan acceso a la información de usuario que se encuentra disponible mediante las funciones del SDK.

Para obtener más información sobre cómo incluir dominios en la lista de autorizados, consulta la referencia whitelisted_domains.

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

Ejemplo de uso de 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 URL

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

Propiedades de URL

Propiedad	Tipo	Descripción
`type`	Cadena	Tipo de botón. El valor debe ser `web_url`.
`title`	Cadena	Título del botón. Tiene un límite de 20 caracteres.
`url`	Cadena	Esta URL se abre en navegadores del celular cuando se toca el botón. Se debe usar un protocolo HTTPS si `messenger_extensions` es verdadero.
`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.* El valor debe ser `true` si se usan las extensiones de Messenger.
`fallback_url`	Cadena	La URL para usar en clientes que no admiten las extensiones de Messenger. Si no se define, `url` se usará como alternativa. Es posible que se configure solo si `messenger_extensions` es verdadero.
`webview_share_button`	Cadena	*Opcional.* Configurado en `hide` para desactivar el botón "Compartir" en la vista web (en el caso de tratarse información confidencial). No afecta el contenido que compartió el desarrollador con las extensiones.