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
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.
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.
Botón de reserva
El botón de reserva permite enviar una invitación de reserva a los usuarios. Antes de enviar una invitación de reserva a un usuario, debes configurar un calendario y un horario comercial en tu página. Al hacer clic en el botón se abrirá la IU nativa de reservas.
Consulta una lista completa de las propiedades en la referencia del botón de reserva.
Formato del botón
{
"type": "booking"
}Prácticas recomendadas
Utiliza botones para solicitar el seguimiento de un mensaje concreto o una mayor interacción con él.
Comienza con un verbo para ayudar a los usuarios a comprender la acción que están llevando a cabo.
Utiliza botones de URL para las tareas que quieras completar en tu sitio web (p. ej., compras, vinculación de cuentas, etc.). Deja claro que envías a los usuarios a fuera de Messenger.
Envía una respuesta cuando un usuario toque un botón de devolución de llamada. De esta forma, se confirma que has procesado o completado su acción (p. ej., cancelar una reserva o responder a una pregunta).
No utilices botones cuando su acción dependa del estado actual del bot, ya que estarán disponibles de manera permanente en la conversación.
Utiliza como máximo de una a tres palabras o añade puntuación. Intenta que el texto tenga menos de 20 caracteres (espacios incluidos).
No bases todos los botones en direcciones URL. Cuantas más interacciones puedas crear en Messenger, más fluida será la experiencia.
No utilices un único botón de devolución de llamada. Si solo existe un botón para elegir, los usuarios suelen pensar que es una continuación del texto del mensaje y no comprenden que se trata de una acción que quieres que lleven a cabo.