Botones

La mayoría de las plantillas de mensajes, así como el menú persistente, admiten botones que invocan diferentes tipos de acciones. Estos botones permiten ofrecer fácilmente al destinatario del mensaje acciones que puede realizar en respuesta a la plantilla, como abrir una vista web de Messenger, iniciar un proceso de pago, enviar un mensaje de postback a tu webhook, etc.

En el caso de las plantillas de mensajes, los botones se definen mediante objetos en la matriz buttons. En el caso del menú persistente, los botones se definen mediante objetos en la matriz call_to_actions.

Botón de URL

El botón de URL abre una página web en la vista web de Messenger. Esto permite enriquecer la conversación con una experiencia basada en la web, en la que disfrutarás de toda la flexibilidad de desarrollo que ofrece la web. Por ejemplo, puedes mostrar un resumen del producto en la conversación y, a continuación, utilizar el botón de URL para abrir la página del producto completa en tu sitio web.

App Links

Si el sitio contiene App Links, el botón lanzará la aplicación nativa especificada.

El rastreador de Facebook tiene que leer las metaetiquetas de los enlaces de la aplicación para que el redireccionamiento funcione. Ten en cuenta que, si solo has implementado las etiquetas en tu sitio web, puedes solicitar una nueva extracción con la herramienta de depuración de contenido compartido. Una vez que el rastreador haya extraído el sitio, los nuevos botones de URL enviados deben seguir el comportamiento de redireccionamiento.

Uso admitido

El botón de URL se puede utilizar con los elementos siguientes:

• Menú persistente
• Plantilla genérica
• Plantilla de lista
• Plantilla de botones
• Plantilla de contenido multimedia

SDK de extensiones de Messenger: lista de dominios autorizados requerida

Formato del botón

Consulta una lista completa de las propiedades del botón en la referencia del botón de URL.

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

Botón de postback

El botón de postback envía un evento messaging_postbacks a tu webhook con la cadena establecida en la propiedad payload. De este modo, puedes realizar una acción arbitraria al tocar el botón. Por ejemplo, puedes mostrar una lista de productos y, a continuación, enviar el identificador del producto del postback a tu webhook, donde se podrá utilizar para consultar la base de datos y devolver los detalles del producto en forma de mensaje estructurado.

Uso admitido

El botón de postback se puede utilizar con los elementos siguientes:

• Menú persistente
• Plantilla genérica
• Plantilla de lista
• Plantilla de botones
• Plantilla de contenido multimedia

Formato del botón

Consulta una lista completa de las propiedades del botón en la referencia del botón de postback.

{
  "type": "postback",
  "title": "

Botón “Llamar”

Al tocar el botón “Llamar”, se marca un número de teléfono. El número de teléfono debe tener el formato +<COUNTRY_CODE><PHONE_NUMBER> (es decir, +15105559999).

Uso admitido

El botón “Llamar” se puede utilizar con los elementos siguientes:

• Plantilla genérica
• Plantilla de lista
• Plantilla de botones
• Plantilla de contenido multimedia

Formato del botón

Consulta una lista completa de las propiedades del botón en la referencia del botón “Llamar”.

{
  "type":"phone_number",
  "title":"

Botón “Iniciar sesión”

El botón “Iniciar sesión” se utiliza en el proceso de vinculación de cuentas, que te permite vincular la identidad del destinatario del mensaje en Messenger con su cuenta en tu sitio; para ello, se le dirige a tu proceso de inicio de sesión basado en la web para que se autentique.

A fin de obtener más información sobre el uso del botón “Iniciar sesión” para la vinculación de cuentas, consulta Vinculación de cuentas.

Uso admitido

El botón “Iniciar sesión” se puede utilizar con los elementos siguientes:

• Plantilla genérica
• Plantilla de lista
• Plantilla de botones
• Plantilla de contenido multimedia

Formato del botón

Consulta una lista completa de las propiedades del botón en la referencia del botón “Iniciar sesión”.

{
  "type": "account_link",
  "url": "

Botón “Cerrar sesión”

El botón “Cerrar sesión” se utiliza en el proceso de vinculación de cuentas para desvincular la identidad del destinatario del mensaje en Messenger de su cuenta en tu sitio.

Para obtener más información sobre el uso del botón “Cerrar sesión” para la desvinculación de cuentas, consulta Vinculación de cuentas.

Uso admitido

El botón “Cerrar sesión” se puede utilizar con los elementos siguientes:

• Plantilla genérica
• Plantilla de lista
• Plantilla de botones
• Plantilla de contenido multimedia

Formato del botón

Consulta una lista completa de las propiedades del botón en la referencia del botón “Cerrar sesión”.

{
  "type": "account_unlink"
}

Botón “Jugar”

El botón “Jugar” lanza un Juego instantáneo asociado a tu página de Facebook. Para personalizar la forma en que se abre el juego, puedes establecer una propiedad payload en la solicitud que se enviará al juego al lanzarse, así como una propiedad game_metadata.player_id o game_metadata.context_id opcional, que permite al bot iniciar el juego en un contexto concreto con un único jugador o un grupo existente.

Formato del botón

La propiedad payload sebe ser un JSON serializado. Se deserializa mediante el SDK de Juegos instantáneos.

Consulta una lista completa de las propiedades del botón en la referencia del botón “Jugar”.

{
  "type":"game_play",
  "title":"Play",
  "payload":"{<SERIALIZED_JSON_PAYLOAD>}",
  "game_metadata": { // Only one of the below
    "player_id": "<PLAYER_ID>",
    "context_id": "<CONTEXT_ID>"
  }
}

Consulta el evento de webhook de “Jugar” correspondiente al evento que se enviará al bot cuando un usuario termine una ronda de partidas.

Prácticas recomendadas