Plugin Enviar a 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 |
|---|---|---|
| Enumeración | Nombre del evento. Valores posibles: |
| Cadena | Contiene el valor establecido en el parámetro |
| Booleano | Indica si un evento se ha producido una vez confirmada la ventana emergente de confirmación. |
| 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_MESSENGERRECEIVE_THIS_IN_MESSENGERSEND_THIS_TO_MEGET_CUSTOMER_ASSISTANCEGET_CUSTOMER_SERVICEGET_SUPPORTLET_US_CHATSEND_ME_MESSAGESALERT_ME_IN_MESSENGERSEND_ME_UPDATESMESSAGE_MELET_ME_KNOWKEEP_ME_UPDATEDTELL_ME_MORESUBSCRIBE_IN_MESSENGERSUBSCRIBE_TO_UPDATESGET_MESSAGESSUBSCRIBEGET_STARTED_IN_MESSENGERLEARN_MORE_IN_MESSENGERGET_STARTED