Plugin Enviar a Messenger

A partir del 30 de septiembre de 2024, esta función dejará de estar disponible. Puedes seguir usando funciones como los enlaces m.me, que redirigen a las personas a otra persona, una página o una conversación en Messenger.

Cuando tu aplicación de Facebook esté en modo de desarrollo, el plugin y la API solo funcionarán para los administradores, desarrolladores y evaluadores de la aplicación que tengan una sesión válida. Una vez que se apruebe y sea pública, la aplicación estará operativa para el público general.

El plugin “Enviar a Messenger” se usa para activar un evento de autenticación para el webhook. Puedes pasar datos para saber qué usuario y transacción se asociaron al evento de autenticación y vincular el usuario en tu back-end.

La primera vez que un usuario haga clic en este botón, aparecerá una ventana emergente de confirmación.

Requisitos

SDK de Facebook para JavaScript

Para utilizar el plugin Enviar a Messenger, debes incluir el SDK de Facebook para JavaScript en la página en la que se mostrará el plugin.

Consulta las instrucciones sobre cómo incluir el SDK en el inicio rápido del SDK de Facebook para JavaScript.

Configuración

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

Consulta una descripción completa de los atributos disponibles en la referencia del plugin Enviar a Messenger.

Suscripción a eventos

Suscríbete a eventos del plugin.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

Campos del evento

Nombre del campo Tipo Descripción

event

Enumeración

Nombre del evento. Valores posibles: rendered, clicked, not_you, opt_in.

ref

Cadena

Contiene el valor establecido en el parámetro data-ref del plugin. Solo se admiten caracteres alfanuméricos, “=”, “-” y “_”.

is_after_optin

Booleano

Indica si un evento se ha producido una vez confirmada la ventana emergente de confirmación.

pluginID

Sin definir

Este campo no se usa.

Evento de webhook

El plugin Enviar a Messenger activa el evento del webhook messaging_optins.

Personalización del comportamiento de inicio de sesión

Si ningún usuario tiene la sesión iniciada en Facebook, el plugin se representará sin identidad de usuario. Al hacer clic en el botón, se le pedirá al usuario que inicie sesión.

Si estableces allow_login en false, el plugin no se representará para los usuarios que no hayan iniciado sesión.

Ten en cuenta que el plugin se representará sin una sesión de Facebook solo si la aplicación está aprobada y es pública.

Opciones de texto de la llamada a la acción

El plugin Enviar a Messenger también admite el atributo cta_text. Dicho atributo te permite elegir el texto del botón para el plugin de una lista predefinida de cadenas. Cuando se usa el atributo cta_text, la mayoría de los usuarios que tengan la sesión iniciada solo tendrá que hacer clic en el botón “Iniciar sesión” para la activación, sin necesidad de volver a confirmar con la ventana emergente, y el evento messaging_optins se entregará de inmediato.

Los valores que se indican a continuación se admiten con el atributo cta_text:

  • GET_THIS_IN_MESSENGER
  • RECEIVE_THIS_IN_MESSENGER
  • SEND_THIS_TO_ME
  • GET_CUSTOMER_ASSISTANCE
  • GET_CUSTOMER_SERVICE
  • GET_SUPPORT
  • LET_US_CHAT
  • SEND_ME_MESSAGES
  • ALERT_ME_IN_MESSENGER
  • SEND_ME_UPDATES
  • MESSAGE_ME
  • LET_ME_KNOW
  • KEEP_ME_UPDATED
  • TELL_ME_MORE
  • SUBSCRIBE_IN_MESSENGER
  • SUBSCRIBE_TO_UPDATES
  • GET_MESSAGES
  • SUBSCRIBE
  • GET_STARTED_IN_MESSENGER
  • LEARN_MORE_IN_MESSENGER
  • GET_STARTED