Instructivo para la configuración de Facebook-Instagram en Lynn

Se presenta los pasos necesarios para integrar los canales de Facebook a Lynn con el siguiente alcance:

• Facebook
  • Direct Messages Administración de las respuestas a los mensajes privados de usuarios de Facebook.
  • Facebook Comments Administración de los mensajes que se observan en el muro de la página asociada a la aplicación, en primera instancia solo se va a manejar las respuestas a los comentarios.
• Instagram
  • Instagram Comments Administración de los mensajes que provienen de comentarios y menciones en Instagram.
  • Direct Messages Administración de las respuestas a los mensajes privados de usuarios de Instagram.

Requisitos

Requisitos necesarios para hacer la integracion.

• Facebook

  • Cuenta de Facebook Developer.
  • Aplicación en Facebook Developer.
  • Página de Facebook (con rol administrador).
  • Perfil comercial.
  • Aprobación de permisos por parte de Facebook.
  • Firma de contrato comercial.

• Instagram

  • Página de Facebook (con rol administrador).
  • Perfil comercial.
  • Cuenta de Facebook Developer.
  • Aplicación en Facebook Developer.
  • Cuenta empresarial/profesional Instagram.
  • Aprobación de permisos por parte de Facebook.
  • Firma de contrato comercial.

Crear una página de Facebook

La página de Facebook es el enlace entre la aplicación que se creó anteriormente y la cuenta de Facebook y/o de Instagram. Se describirán los pasos para generar una cuenta de Facebook y asociarla a una cuenta del administrador comercial para su gestión.

1. Primeramente, ir a la cuenta de Facebook que está asociada a su aplicación, y seleccionar el botón Crear , tal como se muestra en la imagen.

   

2. Ahora podrá ver todas las cosas que se pueden crear en Facebook, para crear una nueva página debe darle al botón .

3. Posteriormente rellenar con la información de la página.

   

4. Incluya un nombre representativo para la página, una categoría (para el caso de Lynn usamos “comunidad”) y una descripción (opcional).

   

Integrar la pagina de Facebook a Lynn

Solo Facebook Page

Integrar la cuenta de Instagram. a Lynn

1. En los permisos que se muestra en la imagen deben estar habilitados. Luego de revisarlos darle al botón “Listo”.

   

2. Parametros necesarios para hacer la integración de forma manual.

Estos parametros son recuperados automaticamente en el paso anterior. Si usted es un usuario avanzado o tiene amplios conocimentos sobre la plataforma de Facebook, puede configurar los parametros de forma manual y para eso les damos una descripción de cada uno de los campos necesarios para la integración.

• FACEBOOK_APP_IDENTIFIER / INSTAGRAM_APP_IDENTIFIER

Identificador de la aplicación de Facebook, se encuentra en la configuración => básica.

• FACEBOOK_APP_SECRET / INSTAGRAM_APP_SECRET

Clave asignada a la aplicación de Facebook, se encuentra en la configuración => básica.

• FACEBOOK_ISENABLED_COMMENTS_REPLY

Los posibles valores para este parámetro son “true” o “false” y le indica a Lynn si la respuesta al comentario se va a realizar al nivel de la publicación o como respuesta interna en el mismo comentario.

• FACEBOOK_PAGE_IDENTIFIER / INSTAGRAM_PAGE_IDENTIFIER

Identificador de la página de Facebook desde donde se van a recibir los comentarios realizados. Se obtiene entrando a la página de Facebook en la sección información, tal como se observa en la imagen.

• FACEBOOK_PERMANENT_TOKEN / INSTAGRAM_PERMANENT_TOKEN

Token de acceso a página que no tiene fecha de caducidad y se va a utilizar en todas las peticiones asociadas de la aplicación. Para la generación observar Generar Token de Acceso a Pagina Permanente, y para validar si el token aún se encuentra activo y es permanente, abrir la url https://developers.facebook.com/tools/debug/accesstoken/, colocar el token y darle al botón “Depurar”, en el campo caducidad debería decir “nunca”.

En la misma página deberá encontrar una sección que se llame ámbitos específicos, donde debe validar que la lista de permisos sean los mismos que los aprobados para la aplicación y a que página aplica.

• FACEBOOK_TOKEN_VERIFICATION_WEBHOOK / INSTAGRAM_TOKEN_VERIFICATION_WEBHOOK

Este token es parte de la validación de participantes en las notificaciones del webhook, este token es un GUID que se genera manualmente y se coloca tanto en esta variable como al momento de configurar el webhook.

Para configurarlo debe ir a la lista de productos de la aplicación, seleccionar WebHooks, posteriormente seleccionar la opción Page (para la integración de Facebook) o Instagram (para la integración de Instagram), por último, darle al botón “Edit Subscription” al levantar el formulario llenar el campo Token de verificación con el GUID creado.

• INSTAGRAM_BUSINESS_ACCOUNT

Código de usuario de la cuenta de Instagram, este parámetro se obtiene consultando la url https://graph.facebook.com/v8.0/\<pagina de facebook asociada a la cuenta instagram>?fields=instagram_business_account&access_token=\<token de acceso a pagina>

INSTAGRAM_BUSINESS_ACCOUNT_USERNAME

Colocar el nombre de usuario de la cuenta de Instagram sin incluir el @.

Integraciones con Facebook

Direct Messages

Esta integración está hecha con la finalidad de poder enviar mensajes directos a los clientes a través del Messenger de Facebook. Para ello debe completar todos los pasos descritos en las secciones siguientes.

Generar un token de acceso

1. Ir a las configuraciones del Messenger.
2. Seguir las siguientes imágenes.

1. Copiar y guardar el token de acceso.

   

WebHook de Messenger y obtención en Lynn

Para configurar el webhook, solicite a un aliado comercial de e-contact que le presta servicio.

Solicitud de aprobación de aplicación de FB para Messenger

Para la aprobación de una aplicación en FB es necesario solicitar los permisos involucrados en el accionar de la integración, para la gestión de esta solicitud es necesario tener nuestra aplicación correctamente configurada y vinculada a una verificación de negocios de Facebook aprobada.

Verificación de Negocio en Facebook

La verificación de negocio solicita a Facebook la revisión de la identidad del negocio configurado asociado a la aplicación, ejemplo el negocio: el negocio responsable de la página web, o el negocio que presta servicio de integración.

Se deberá crear un perfil “https://business.facebook.com/” y asociar las páginas en su dominio, que instauraran la aplicación de Facebook. Junto con la aprobación del perfil, usted podrá solicitar la verificación de su negocio.

Debe pulsar el botón de verificación y quedar en estado “verificado” como se muestra a continuación, este proceso puede tardar unos días según, sea la disponibilidad y claridad de los datos suministrados a Facebook.

Delegado de protección de datos

Para la prestación de servicios de Facebook y sus aplicaciones en la Unión Europea es necesario definir un delegado de protección de datos, en la pantalla de configuración básica proporcione, nombre, correo electrónico, dirección, código postal.

Permisos Necesarios

Para la implementación de canal Facebook Messenger debe solicitar los permisos siguientes en FB:

• Messaging_postbacks
• Messaging_optins
• Message_deliveries
• Messages

Nota: Los permisos solicitados están sujetos a los cambios de política de Facebook.

Pasos para solicitud de permisos

Para ello, seleccione el menú de Productos > Messenger > Configuración > Permisos y funciones, agregar a la solicitud y comience un ciclo de revisión agregando a la solicitud “pages_messaging”

Al comenzar el proceso de verificación se solicitará que detalle el propósito y características que sustenten la aprobación, como se ve en la imagen siguiente, debe llenar los campos y seleccionar su página de Facebook asociada a la solicitud.

Facebook Comments

Esta funcionalidad tiene como finalidad obtener los comentarios desde el muro de Facebook, esto a través una aplicación asociada a la página. Se generará una sesión en Lynn y podrá ser respondida en el hilo de la publicación desde donde se generó el comentario.

Permisos Necesarios

Para que la aplicación puede funcionar correctamente en ambiente productivo es necesario solicitar y obtener aprobación por parte de Facebook de los siguientes permisos:

• Public_profile: Permiso necesario para que los usuarios asociados a la página de Facebook (administradores, supervisores) puedan obtener información de la aplicación y sus páginas asociadas.
• Page_read_engagement: Habilita a la aplicación a leer el contenido de la página (publicaciones, fotos, videos y eventos).
• Page_manage_metadata: Habilita a la aplicación a recibir eventos del webhook de las actividades de la página (depende de cual tipo de actividades configure para recibir).
• Page_manage_engagement: Permite a la aplicación responder los comentarios que se generan en la página. Adicionalmente también permite editar y eliminar.
• Page_read_user_content: Habilita a la aplicación a leer el contenido publicado asociado a la página como publicaciones, comentarios.

Indistintamente que estén o no aprobados los permisos, se puede realizar demo (ver Crear aplicación en facebook developer) con el acceso estándar de los permisos antes mencionados, con la particularidad que solo funcionara con aquellas cuentas que tengan Roles asociados a la aplicación de Facebook como administradores, desarrolladores, evaluadores.

Luego de esto debe crear una Crear una página de Facebook y ya este habilitado para recibir y responder los mensajes que llegan al muro de Facebook en la página configurada.

Configurar Webhooks

Para poder recibir los eventos se deben tener los permisos necesarios por parte de Facebook, pero adicionalmente debe suscribir a los eventos que se desean recibir en la sección Page, para este caso en particular solo se suscribe los eventos feed y message_mention, y posteriormente darle a botón “subscribe” o en caso de que sea la primera vez y/o el webhook este deshabilitado el botón se llamará “susbcribe to this object”.

También debe configurar url del servicio que va a recibir el evento, y el token de verificación del webhook (Solicite la estructura de webhook autorizada para el tenant destino a nuestro canal de soporte o directamente con un asesor comercial), esto se hace en la ventana del producto y se oprime el botón “Edit subscription”, al levantar la ventana debe configurar los parámetros y darle al botón “Verificar y guardar”.

Suscribir eventos de Webhooks

Una vez que se hayan habilitados los eventos de la aplicación, también se debe suscribir la página que va a recibir esos eventos, para ello es necesario ejecutar el siguiente curl.

curl --location --request POST 'https://graph.facebook.com/v6.0/\<\<identificador de la pagina>>/subscribed_apps?subscribed_fields=feed&access_token=\<\<token de acceso a la pagina>>'

Integraciones con Instagram

Instagram Comments

El objetivo de la integración con Instagram es poder procesar los comentarios que realizan los usuarios de Instagram en una publicación de la cuenta empresarial. Para poder lograr esto es necesario conectar el aplicativo, la página de Facebook y la cuenta de Instagram.

Permisos Necesarios

Para que la aplicación puede funcionar correctamente en ambiente productivo es necesario solicitar y obtener aprobación por parte de Facebook de los siguientes permisos:

• Public_profile: Permiso necesario para que los usuarios asociados a la página de Facebook (administradores, supervisores) puedan obtener información de la aplicación y sus páginas asociadas.
• Page_show_list: Permite a la aplicación acceder a la lista de páginas que administra un usuario, este permiso es necesario para obtener información de la cuenta empresarial de Instagram asociada a la página de Facebook.
• Page_manage_metadata: Habilita a la aplicación a recibir eventos del webhook de las actividades de la página (depende de cual tipo de actividades configure para recibir).
• Page_read_engagement: Habilita a la aplicación a leer el contenido de la página (publicaciones, fotos, videos y eventos).
• Instagram_manage_comment: Permite que la aplicación cree, elimine y oculte comentarios en nombre de la cuenta de Instagram vinculada a la página de Facebook.
• Instagram_basic: Esta función permite a la aplicación a leer información y contenido multimedia del perfil de una cuenta de Instagram. Se usa principalmente para obtener la información de la cuenta empresarial.

Configurar Webhooks

Para poder recibir los eventos se deben tener los permisos necesarios por parte de Facebook, pero adicionalmente debe suscribir a la aplicación los eventos que se desean recibir los eventos en la sección Instagram, para este caso en particular solo se suscribe los eventos Comments y Mentions, y posteriormente darle a botón “subscribe”.

Suscribir eventos de Webhooks

Una vez que se hayan habilitados los eventos de la aplicación, también se debe suscribir la página que va a recibir esos eventos, para ello es necesario ejecutar el siguiente curl.

curl --location --request POST 'https://graph.facebook.com/v6.0/\<\<identificador de la pagina>>/subscribed_apps?subscribed_fields=feed&access_token=\<\<token de acceso a la pagina>>'

Relacionar todos los componentes de la integración

Ahora debe realizar la conexión de todos los elementos y así completar la integración, para ello:

1. El primer paso para realizar la integración es Crear una página de Facebook, posteriormente asociar la cuenta de Instagram.

   1. En la pantalla principal de la página de Facebook seleccionar la opción “Configuración”.

      

   2. Una vez en la página de configuración, seleccionar la opción “Instagram” tal como se observa en la imagen.

      

   3. Haga login con la cuenta de Instagram comercial que definió y está asociada a la cuenta business.

      

2. Suscribir los eventos de webhook como se indica en Configurar Webhooks.

3. Generar el token de página asociado a una cuenta administrador de la página de Facebook, puede usar el procedimiento descrito en Generar token de acceso permanente.
4. Configurar todos los parámetros del tenant para el uso de Instagram, tal como se ve en Configurar el tenant en Lynn.

Seguimiento de la solicitud

En la pantalla Messenger > Configuración podrá observar el detalle de la solicitud actual.

También puede validar el progreso de la solicitud y otros en la sección de inicio “Revisión de la app”.

Facebook App ID, Facebook App Secret, Page ID y Page Access Token, son los valores que se deben proporcionar para lograr la configuración a través en Lynn.

Recordar

Facebook requiere una URL de política de privacidad y una URL de términos de servicio en su página de configuración básica de la aplicación. La página del Código de conducta contiene enlaces de recursos de terceros para ayudar a crear una política de privacidad. La página de Términos de uso contiene ejemplos de términos para ayudar a crear un documento de Términos de servicio apropiado.