Autenticación de aplicaciones empresariales

Las aplicaciones empresariales disponibles en las plataformas de Facebook son el lugar al que las pequeñas empresas pueden dirigirse para descubrir aplicaciones empresariales de terceros y conectarse a ellas para empezar a utilizar fácilmente las herramientas para empresas con un coste técnico reducido a fin de crecer y lograr sus objetivos empresariales.

A diferencia del inicio sesión empresarial, dado que el proceso de las aplicaciones empresariales se inicia desde nuestras plataformas, existe un paso adicional que requiere que el usuario inicie sesión en tu plataforma a través del navegador de elementos emergentes para autenticarse y que seleccione su empresa para la conexión (identificada mediante un elemento external_business_id que has definido). Al autenticarse correctamente, el usuario se redirigirá nuevamente al proceso para completar la incorporación.

Si quieres que tu aplicación se muestre en nuestra plataforma de aplicaciones empresariales, debes crear una URL de autenticación y un extremo de webhook, y configurarlos y validarlos desde la ventana para desarrolladores.

Todas las aplicaciones deben solicitar la revisión de la integración; una vez que se apruebe la integración de FBE, tu aplicación estará disponible para los usuarios públicos.

Implementación de la URL de autenticación

Las aplicaciones empresariales inician un proceso análogo al del inicio de sesión empresarial desde una plataforma de la página de Facebook, Instagram y Facebook Business Suite. Para activar este proceso y lograr que la aplicación se muestre allí, debes proporcionar una IU de autenticación personalizada que permita al usuario seleccionar su empresa en tu sitio y, luego, le redirija al proceso de Facebook, Instagram o Facebook Business Suite.

Funcionamiento

1. Proporciona un extremo de URL personalizado (URL de autenticación) que cargue el proceso de autenticación de tu plataforma.
• Tu URL de autenticación debe dirigir al usuario (propietario de la empresa) a un proceso de inicio de sesión en tu plataforma.
• Proporciona una opción para registrar una nueva cuenta en tu plataforma. Después de registrarse, se debe redirigir al usuario a Facebook para completar la conexión de la cuenta.
• Si admites varias empresas por cuenta en tu plataforma, la URL de autenticación debería mostrar, después de un inicio de sesión correcto, una IU que permita al usuario seleccionar qué empresa de tu plataforma quiere asociar a sus activos de Facebook.
Ejemplo: URL de autenticación

https://yourwebsite.com/fbe-auth

2. Facebook carga la URL de autenticación proporcionada durante el proceso de incorporación y añade al final el parámetro de consulta redirect_uri (un URI de redireccionamiento que puede incluir parámetros de consulta adicionales):

   https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>

   Ejemplo: un URI de redireccionamiento codificado que puedes añadir al parámetro de consulta redirect_uri:

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>

   Al final de este paso, Facebook carga la URL de autenticación con el parámetro de consulta codificado redirect_uri añadido, con un aspecto similar al siguiente:

   https://yourwebsite.com/fbe-auth?redirect_uri=https%3A%2F%2Fwww.facebook.com%2Flocal%2Fdev%2Ftransaction_tool_selector%2Fredirect%3Fapp_id%3D123%26app_name%3DSample%26page_id%3D456

   Nota importante: Para asegurarte de que no estás compartiendo ningún dato de usuario con otras partes, redirígelo solo al parámetro redirect_uri si coincide con la expresión regular siguiente:

   https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?

3. Cuando el usuario complete el inicio de sesión o el registro y seleccione una empresa en tu plataforma (si corresponde), redirígelo a la URL de redirect_uri después de anexarla a un objeto extras codificado como un parámetro de consulta (como el que utilizarías para el inicio de sesión empresarial) con business_config y setup definidos (según las configuraciones de incorporación que quieras implementar):

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>&extras=<an_encoded_json_string>

Autenticación con iframe

Para ofrecer una experiencia de usuario más fluida en las aplicaciones empresariales y facilitar la creación de nuevas cuentas en tu plataforma, debes permitir que la URL de autenticación se cargue en un iframe en una plataforma de Facebook. Consulta las normas de implementación y las especificaciones de postMessage en la documentación sobre iframes.

Implementación de webhooks

Gracias a los webhooks, podrás recibir notificaciones HTTP en tiempo real sobre los cambios que se produzcan en determinados objetos de la gráfica social de Facebook. En el caso de FBE, esto significa que, si un usuario instala o desinstala FBE mediante tu aplicación (por ejemplo, a través de aplicaciones empresariales), recibirás los detalles de esa acción a través de webhooks.

Debes crear un extremo en un servidor seguro que pueda procesar solicitudes de Facebook. Esto es necesario para todos los socios de la plataforma que quieren que su aplicación esté disponible en aplicaciones empresariales. Consulta la guía de implementación de webhooks para obtener detalles sobre la creación de este extremo.

Configuración y validación de webhooks

Cuando el extremo del webhook está listo, la configuración y la validación requieren que:

1. Utilices la tarjeta de Webhooks en la sección Extensión de Facebook para empresas -> Configuración en el panel de aplicaciones para validar el extremo y te suscribas al webhook fbe_install. Consulta la guía de implementación de webhooks para obtener más información.
2. Una vez que el producto Webhooks está configurado correctamente, el círculo en la parte superior derecha de la tarjeta se pone de color verde y muestra una marca de verificación.

Configuración y validación desde la ventana para desarrolladores

La ventana para desarrolladores de la extensión de Facebook para empresas es un producto del panel de aplicaciones para desarrolladores. Una vez que se ha concedido a tus aplicaciones la función FBE, debes utilizar la ventana para desarrolladores para configurar y validar la URL de autenticación y el extremo de webhook, así como para añadir detalles sobre lo que tu aplicación puede ofrecer a las empresas.

Configuración y validación de la URL de autenticación

Cuando la URL de autenticación está lista, la configuración y la validación requieren que:

1. Te dirijas a la ventana para desarrolladores de FBE en el panel de aplicaciones. Nota: Si no la has configurado, sigue estas instrucciones para añadirla.
2. Haz clic en la pestaña Configurar y busca la tarjeta Plataforma de aplicaciones empresariales.
3. Activa la casilla Mostrar mi aplicación en la plataforma de aplicaciones empresariales.
4. En la entrada URL de autenticación, introduce tu URL de autenticación.
5. Haz clic en el botón Autenticación de prueba.
• Se abre una ventana emergente y carga tu URL para imitar la manera en que Facebook la utilizará en las plataformas de aplicaciones empresariales.
• Continúa con el inicio de sesión y la selección de empresa (si corresponde).
• Tras el redireccionamiento, la ventana emergente se cierra. Si existen errores en la implementación (por ejemplo, valores no válidos en extras), se mostrarán en la parte inferior de la tarjeta para que sepas qué debes corregir. La función Autenticación de prueba solo validará la entrada de redirect_uri, pero no instalará FBE realmente.
6. Cuando los pasos de implementación y la configuración de extras se hayan implementado según lo previsto, este paso se marcará como válido (marca de verificación verde en la esquina superior derecha de la tarjeta). Con esto se habilitará la posibilidad de probar completamente el proceso de incorporación (instalación de FBE) directamente desde Facebook (consulta la sección siguiente).

Pruebas integrales

Una vez que la URL de autenticación y el extremo de webhooks están correctamente configurados y validados en la ventana para desarrolladores, puedes realizar pruebas integrales del proceso de incorporación desarrollado por tu aplicación antes de su publicación. Puedes hacerlo directamente desde Facebook Business Suite o la plataforma de la página de Facebook de la siguiente manera:

Mediante Facebook Business Suite

1. Ve a Facebook Business Suite.
2. En el lado izquierdo de la página, haz clic en Más herramientas y, luego, en Aplicaciones empresariales.
3. Todas las aplicaciones disponibles se muestran aquí. Las tuyas se mostrarán en la categoría que has seleccionado como Sectores en la pestaña Configuración de la ventana para desarrolladores.
4. La aplicación presentará una etiqueta Solo para pruebas (no pública). Esto significa que está disponible para pruebas y solo para los usuarios que tengan un rol en tu aplicación, pero no todavía para los usuarios públicos.
5. Haz clic en Conectar y comienza a probar la experiencia desarrollada por tu URL de autenticación:
   • El proceso de incorporación instala FBE realmente y activará las notificaciones de webhooks.

Mediante la plataforma de la página de Facebook

1. Dirígete a una página de Facebook para la que tengas acceso de administrador.
2. En el lado izquierdo de la página de Facebook, haz clic en Aplicaciones empresariales.
3. Todas las aplicaciones disponibles se muestran aquí. Las tuyas se mostrarán en la categoría que has seleccionado como Sectores en la pestaña Configuración de la ventana para desarrolladores.
4. La aplicación presentará una etiqueta Solo para pruebas (no pública). Esto significa que está disponible para pruebas y solo para los usuarios que tengan un rol en tu aplicación, pero no todavía para los usuarios públicos.
5. Haz clic en Conectar y comienza a probar la experiencia desarrollada por tu URL de autenticación:
   • El proceso de incorporación instala FBE realmente y activará las notificaciones de webhooks.

Más información

• Cómo utilizar el inicio de sesión empresarial para FBE
• extras
• business_config
• setup
• Cómo desinstalar FBE