Plugin "Enviar a 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