Botones

La mayoría de las plantillas de mensaje, al igual que el menú persistente, son compatibles con botones que invocan diferentes tipos de acciones. Con estos botones, puedes ofrecer al destinatario del mensaje acciones para que realice en respuesta a la plantilla como, por ejemplo, abrir la vista web de Messenger, comenzar un proceso de pago, enviar un mensaje de postback a tu webhook, etc.

Para las plantillas de mensajes, los botones que se incluyen están definidos por objetos en la matriz de buttons. Para el menú persistente, los botones se definen a partir de objetos en la matriz de call_to_actions.

Botón de URL

El botón de URL abre una página web en la vista web de Messenger. Esto te permite enriquecer la conversación con una experiencia basada en la web, donde tienes toda la flexibilidad de desarrollo de la web. Por ejemplo, puedes mostrar el resumen de un producto en la conversación y después usar el botón de URL para abrir la página completa del producto en tu sitio web.

Si el sitio contiene App Links, el botón lanzará la app nativa específica.

El rastreador de Facebook necesita leer las metaetiquetas del enlace de la app para que funcione el redireccionamiento. Nota: Si acabas de implementar las etiquetas en el sitio web, puedes solicitar una nueva extracción con el depurador de contenido compartido. Una vez que el rastreador extrajo el sitio, los nuevos botones de URL que se enviaron deberían seguir el comportamiento de redireccionamiento.

Usos admitidos

El uso del botón de la URL se admite en los siguientes casos:

  • Menú persistente
  • Plantilla genérica
  • Plantilla de lista
  • Plantilla de botón
  • Plantilla de elementos multimedia

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.

Botón "Formato"

Para ver una lista completa de las propiedades del botón, consulta la referencia del botón de URL.

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

Botón "Postback"

El botón "Postback" envía un evento de messaging_postbacks a tu webhook con la cadena definida en la propiedad payload. Te permite realizar una acción arbitraria cuando alguien toca el botón. Por ejemplo, podrías mostrar una lista de productos y después enviar el identificador del producto en el postback a tu webhook, donde se usa para enviar una consulta a tu base de datos y devolver los detalles del producto como un mensaje estructurado.

Usos admitidos

El botón "Postback" se puede usar con los siguientes elementos:

  • Menú persistente
  • Plantilla genérica
  • Plantilla de lista
  • Plantilla de botón
  • Plantilla de elementos multimedia

Botón "Formato"

Para ver una lista completa de las propiedades del botón, consulta la referencia del botón "Postback".

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

Botón “Llamar”

El botón "Llamar" marca un número de teléfono cuando alguien lo toca. El formato del número de teléfono debe ser +<COUNTRY_CODE><PHONE_NUMBER>, por ejemplo +15105559999.

Usos admitidos

El botón "Llamar" se puede usar con los siguientes elementos:

  • Plantilla genérica
  • Plantilla de lista
  • Plantilla de botón
  • Plantilla de elementos multimedia

Botón "Formato"

Para ver una lista completa de las propiedades del botón, consulta la referencia del botón "Llamar".

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

Botón "Iniciar sesión"

El botón "Iniciar sesión" se usa 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, cuando lo diriges a tu proceso de inicio de sesión basado en web para fines de autenticación.

Si quieres obtener más información sobre el botón "Iniciar sesión" para la vinculación de cuentas, consulta Vinculación de cuentas.

Usos admitidos

El botón "Iniciar sesión" se puede usar con los siguientes elementos:

  • Plantilla genérica
  • Plantilla de lista
  • Plantilla de botón
  • Plantilla de elementos multimedia

Botón "Formato"

Para ver una lista completa de las propiedades del botón, consulta la referencia del botón "Iniciar sesión".

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

Botón "Cerrar sesión"

El botón "Cerrar sesión" se usa 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 botón "Cerrar sesión" para la desvinculación de cuentas, consulta Vinculación de cuentas.

Usos admitidos

El botón "Cerrar sesión" se puede usar con los siguientes elementos:

  • Plantilla genérica
  • Plantilla de lista
  • Plantilla de botón
  • Plantilla de elementos multimedia

Botón "Formato"

Para ver una lista completa de las propiedades del botón, consulta la referencia del botón "Cerrar sesión".

{
  "type": "account_unlink"
}

Botón "Jugar"

El botón "Jugar" inicia un juego instantáneo asociado con tu página de Facebook. Para personalizar la forma en que se abre el juego, puedes definir una propiedad payload en la solicitud que se enviará al juego en el lanzamiento, y, de manera opcional, una de las propiedades game_metadata.player_id o game_metadata.context_id. De este modo, tu bot puede iniciar el juego en un contexto específico, ya sea contra un solo jugador o contra un grupo existente.

Botón "Formato"

La propiedad payload deberá tener un formato JSON serializado, que deserializará el SDK para juegos instantáneos.

Para ver una lista completa de las propiedades del botón, consulta la referencia del botón "Jugar".

{
  "type":"game_play",
  "title":"Play",
  "payload":"{

Consulta el evento de partida de juego del webhook para saber qué evento se enviará al bot cuando un usuario termine una ronda de juego.

Botón "Reserva"

Este botón te permite enviar una invitación de reserva a tus usuarios. Antes de enviar una invitación de reserva a un usuario, debes configurar un calendario y un horario comercial. Al hacer clic en el botón, se abre la UI nativa de reservas.

Para ver una lista completa de las propiedades, consulta la referencia del botón "Reserva"

Botón "Formato"

{
  "type": "booking"
}

Prácticas recomendadas

Usa botones para solicitar una interacción de seguimiento o posterior con un mensaje concreto.

Comienza con un verbo para ayudar a las personas a comprender la acción que realizarán.

Usa los botones de URL para tareas que quieras que se completen en el sitio web (por ejemplo, compras, vinculación de cuentas, etc.). Indica claramente que las personas se dirigirán a un sitio fuera de Messenger.

Envía una respuesta después de que alguien toque un botón de devolución de llamada. Esto confirmará que procesaste o completaste la acción que realizaron (por ejemplo, cancelar una reserva, responder a una pregunta).

No uses botones cuando la acción dependa del estado actual del bot, ya que estarán disponibles de forma permanente en la conversación.

No uses más de una a tres palabras ni agregues puntuación. Intenta que tu texto no supere los 20 caracteres, contando los espacios.

No dependas de direcciones URL para todos los botones. Cuantas más interacciones puedas crear dentro de Messenger, más fluida será la experiencia.

No uses un único botón de devolución de llamada. Cuando solamente hay un botón para elegir, las personas suelen pensar que se trata de la continuación de tu mensaje de texto y no les resulta claro que se trata de una acción que tú quieres que realicen.