Plugin "Enviar a Messenger"

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

Cuando la app de Facebook esté en modo de desarrollo, solo podrán usar el plugin y la funcionalidad de la API los administradores, desarrolladores y evaluadores de la app que tengan una sesión válida. Una vez que la app se apruebe y publique, podrá usarla el público en general.

El plugin "Enviar a Messenger" se usa para activar un evento de autenticación para tu webhook. Puedes enviar datos para conocer qué usuario y qué transacción estaban asociados al evento de autenticación, y vincular al usuario con tu back-end.

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

Requisitos

SDK de Facebook para JavaScript

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

Si quieres obtener instrucciones sobre cómo incluir el SDK, consulta Inicio rápido: 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>

Para ver una descripción completa de los atributos disponibles, consulta la referencia del plugin "Enviar a Messenger".

Suscripción a eventos

Suscríbete a los eventos del plugin.

<script>

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

      });

      </script>

Campos de los eventos

Nombre del campo Tipo Descripción

event

Enumeración

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

ref

Cadena

Contiene el valor configurado en el parámetro data-ref del plugin. Solo se admiten caracteres alfanuméricos, además de -, _ y =.

is_after_optin

Booleano

Indica si el evento se produjo 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 de webhook messaging_optins.

Personalizar el comportamiento de inicio de sesión

Si no hay un usuario de Facebook que haya iniciado sesión, el plugin se mostrará sin identidad de usuario. Al hacer clic en el botón, se le pedirá al usuario que inicie sesión.

Si configuras allow_login en "falso", el plugin no aparecerá si los usuarios no iniciaron sesión.

Ten en cuenta que el plugin se mostrará sin una sesión de Facebook solo si la app está aprobada y disponible para el público.

Opciones de texto de llamada a la acción

El plugin "Enviar a Messenger" también admite el atributo cta_text. Por lo tanto, puedes elegir el texto del botón del plugin de una lista de cadenas predefinidas. Cuando se usa el atributo cta_text, la mayoría de los usuarios que iniciaron sesión solo tienen que hacer clic en el botón del plugin para aceptar, sin necesidad de volver a confirmar la ventana emergente, y el evento messaging_optins se envía de inmediato.

Se admiten los siguientes valores en 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