Conector de Facebook
Para poder utilizar Facebook como una interfaz de chat, se debe tener una cuenta de Facebook, así como también una página de Facebook que aloje a la aplicación de Alan, y que sea desde la cuál se atienda.
Para crear un conector de Facebook basta con seleccionar Facebook en el menu desplegable de Tipo de Conector.
Un botón de Login o inicio de sesión aparecerá la primera vez permitiendote ingresar con tu cuenta de Facebook. Una vez hayas ingresado, aparecerá un menu desplegable en el que podrás seleccionar una de las páginas de Facebook que tengas creadas para el conector.
Por último ingresa un nombre para el conector, el cuál solo servirá para que tu lo puedas identificar facilmente luego. Dicho nombre no será mostrado publicamente.
Mediante el conector de Facebook se puede alojar una aplicación de Alan en una página de Facebook, no una cuenta personal.
Debes tener permisos de adminsitrador sobre la página que deseas seleccionar para el conector.
Mejoras
La plataforma de Facebook contiene opciones de configuración extra, llamados Mejoras(o Enhancements).
Puedes acceder a la sección de Mejoras de un conector de Facebook una vez éste se encuentre creado. Selecciona la opción de Editar para acceder a esta sección del conector.
Estas son las mejoras disponibles actualmente:
-
Botón de "Comenzar" - Es un botón presentado al usuario y que, al presionarlo, se mandará el comando
/startal bot como primer mensaje. -
Mensaje de Bienvenida - Consiste en un mensaje personalizado a ser mostrado al usuario por primera vez antes de comenzar una conversación con el bot.
Facebook permite el uso de las siguientes variables en dicho mensaje:
{{user_first_name}}- El nombre del usuario como aparece en Facebook.{{user_last_name}}- El o los apellidos del usuario, como aparece en Facebook.{{user_full_name}}- El nombre completo del usuario, como aparece en Facebook.
Un ejemplo de un mensaje de bienvenida podría ser el siguiente:
Bienvenido a Alan, {{user_first_name}}!, lo cuál se mostraría al usuario como:Bienvenido a Alan, Mark!
En la aplicación Facebook Messenger, el mensaje de bienvenida se muestra junto al botón de comenzar.
-
Lista blanca de dominios - En algunos casos, Facebook puede rechazar mensajes de Alan si contienen ciertos enlaces en botones o cierto texto en mensajes. Cuando esto sucede, puede encontrarse el hecho en el Registro(Log) de la aplicación. En estos casos, lo que puede hacerse en agregar el o los dominos pertenecientes al enlace que se intenta enviar por mensaje, para que Alan le informe a Facebook que no los rechaze. Esta mejora cumple con ese proposito.
Ten en cuenta que los cambios realizados en las Mejoras se persisten de forma separada al conector en si, por lo que recuerda guardar los cambios en todo momento, dado que podrías perder los cambios.
La razon por la cuál se persiste de forma separada, es que cada mejora utilizada debe ser enviada a Facebook antes de que se guarde el conector.
Si encuentas algún error en esta documentación, o te gustaría enviarnos alguna sugerencia, puedes escribirnos un correo electrónico a soporte@alan.sh para que puedamos tenerlo en cuenta en futuras actualizaciones.