Facebook Messenger

Facebook Messenger es un mensajero utilizado para enviar mensajes e intercambiar fotos, vídeos, pegatinas, audio y archivos, así como para reaccionar a los mensajes de otros usuarios e interactuar con bots.

Conexión

Configuración en Facebook

1. Inicia sesión en Meta para desarrolladores.

2. Vaya a la sección para crear una aplicacion.

1. Haga clic en el botón Crear App para crear una nueva aplicación

1. A continuación, rellene los campos necesarios (nombre de la candidatura, correo electrónico) y pulse el botón Siguiente.

1. En este menú, seleccione Empresa.

1. A continuación, rellene los campos necesarios (nombre de la candidatura, correo electrónico) y pulse el botón Siguiente.

1. Se abrirá un menú con varias opciones de aplicaciones para integraciones, haga clic en Configurar en la opción Messenger.

1. En el menú Generar tokens de acceso, conecta la página de Facebook a la aplicación

1. Genera un token para acceder a la página de Facebook, haz clic en el botón Generar. Este token debe especificarse durante la configuración del Canal del Proyecto en la Plataforma.

1. Al configurar el Canal de Proyectos en la Plataforma, también es necesario especificar los valores App secret y App id, que se encuentran en el menú App settings -> Basic.

Configuración del canal del proyecto en la plataforma

Tienes que crear y configurar un canal de proyecto con un conector de Facebook Messenger.

1. Vaya a la pestaña Canales del proyecto.

1. Pulse el botón Crear canal.

1. Se abrirá el panel de selección de canal final.

1. Selecciona Facebook Messenger.

2. Se abrirá el panel de creación del Canal Proyecto.

1. Opcionalmente, introduzca un título para este Canal de Proyectos en el campo Nombre con el marcador de posición New channel.

1. Pega el token recibido en el campo token de Facebook.

1. Pega el valor del campo App ID de la configuración de la aplicación de Facebook en el campo Facebook App ID.

1. Pega el valor del campo App secret de la configuración de la aplicación de Facebook en el campo Facebook App Secret.

1. Para guardar el Canal Proyecto sin activarlo, pulse el botón CREAR.

1. Para guardar y activar el Canal Proyecto, haga clic en el botón CREAR Y ACTIVAR.

a. El Canal Proyecto se guardará y activará si:

i. Se publica el proyecto;

ii. El token del campo token de Facebook es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. El webhook del canal se ha registrado correctamente.

b. El Canal Proyecto se guardará pero no se activará si no se cumplen una o varias condiciones.

1. Para cancelar la creación del Canal Proyecto, pulse el botón CANCELAR.

Editar y eliminar el canal del proyecto

Para editar un Canal de Proyectos, haga clic en su ficha en la lista de Canales de Proyectos.

1. Para editar cualquier campo, haga clic en él e introduzca un nuevo valor.

2. Para aplicar los cambios a un Canal Proyecto activado, pulse el botón APLICAR.

a. Los cambios se aplicarán si:

i. Se publica el proyecto;

ii. El token del campo token de Facebook es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. El webhook del canal se ha registrado correctamente.

b. Los cambios no se aplicarán si no se cumplen una o varias condiciones.

1. Para desactivar el Canal Proyecto, pulse el botón DESACTIVAR.

1. Para aplicar los cambios a un Canal Proyecto no activado, pulse el botón GUARDAR.

1. Para aplicar los cambios y activar el Canal Proyecto, pulse el botón GUARDAR Y ACTIVAR.

a. Los cambios se aplicarán y el Canal Proyecto se activará si:

i. Se publica el proyecto;

ii. El token del campo token de Facebook es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. Se puede registrar el webhook del canal.

b. Los cambios se aplicarán pero el Canal Proyecto no se activará si no se cumplen una o varias condiciones.

1. Para cancelar los cambios, pulse el botón CANCELAR.

1. Para eliminar el Canal Proyecto, pulse el botón ELIMINAR.

Comunicación

Asignación de variables de canal desde Facebook messenger

Canal variable	Canal final	Variable en el cuerpo de una solicitud entrante de un canal	Peculiaridades
channel_visitor_id	Facebook Messenger	entry.messaging.sender.id (unentry.messaging.sender.id (único para cada canal)
channel_conversation_id	Facebook Messenger	no
channel_visitor_firstname	Facebook Messenger	Puede obtenerse a través de una petición HTTP
channel_visitor_lastname	Facebook Messenger	Puede obtenerse a través de una petición HTTP
channel_visitor_account	Facebook Messenger	no
channel_visitor_phone	Facebook Messenger	no
channel_visitor_email	Facebook Messenger	no
channel_visitor_source	Facebook Messenger	no
channel_visitor_auth	Facebook Messenger	no
channel_visitor_location	Facebook Messenger	no
channel_message_id	Facebook Messenger	no
channel_message_recipient	Facebook Messenger	no
channel_service_data	Facebook Messenger	no
channel_reply_to	Facebook Messenger	no
channel_visitor_token	Facebook Messenger	token de acceso a la página

Comunicación en Facebook

Funcionalidad	Canal	Disponibilidad	Descripción
channel_chat_id	Facebook Messenger
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente	Facebook Messenger	Sí
Botones	Facebook Messenger	Sí
Transferencia al operador	Facebook Messenger	No
Transferencia de archivos como archivos desde el Agente	Facebook Messenger	No
Transferencia de archivos como enlaces desde el Agente	Facebook Messenger	Sí
Recepción de un archivo del Usuario Bot en un script	Facebook Messenger	Sí
Recibir geolocalización de un usuario Bot en un script	Facebook Messenger
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot	Facebook Messenger
Uso de Markdown	Facebook Messenger	No
Envío con notificación	Facebook Messenger	No
Obtener un enlace a la fuente de información	Facebook Messenger	No