Autenticación de Apps de negocios

Apps de negocios, disponible en plataformas de Facebook, es el espacio en el que las pequeñas empresas pueden hallar apps empresariales de terceros y conectarse a ellas para equiparse de herramientas empresariales a un bajo costo tecnológico, a fin de crecer y alcanzar sus metas de negocios.

A diferencia del inicio de sesión de empresa, como el flujo de Apps de negocios se inicia desde nuestras plataformas, hay un paso adicional: el usuario debe iniciar sesión en tu plataforma mediante una ventana de navegador emergente para autenticarse y seleccionar la empresa a la que quiere conectarse (identificada con un external_business_id definido por ti). Cuando la autenticación sea exitosa, el usuario accederá de vuelta al flujo para completar la incorporación.

Si deseas que tu app se muestre en tu plataforma de Apps de negocios, debes crear una URL de autenticación y un punto de conexión de Webhooks, configurarlos y validarlos a través del panel para desarrolladores.

Todas las apps deben solicitar la revisión de integración. Una vez que se apruebe tu integración de FBE, tu app estará disponible para usuarios públicos.

Implementación de la URL de autenticación

Las apps de negocios inician un proceso análogo desde una plataforma de la página de Facebook e Instagram y Facebook Business Suite. Para admitir el proceso y que tu app figure allí, debes proporcionar una autenticación personalizada que permita al usuario seleccionar su empresa en tu sitio y, luego, redirigirlo al proceso de Instagram, Facebook o Facebook Business Suite.

Cómo funciona

1. Brinda un punto de conexión de URL personalizado (URL de autenticación) que cargue el flujo de autenticación de tu plataforma.
• Tu URL de autenticación deberá dirigir al usuario (propietario de empresa) a un proceso de inicio de sesión en tu plataforma.
• Proporciona una opción para registrar una nueva cuenta en la plataforma (es decir, "Registrarse"). Después de registrarse, se redirigirá al usuario a Facebook para completar la conexión de la cuenta.
• Si en la plataforma admites múltiples empresas por cuenta, después de un inicio de sesión exitoso, la URL de autenticación debería mostrar una UI para que el usuario seleccione con qué empresa de la plataforma desea asociar su perfil de Instagram o 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 registro y agrega al final un parámetro de consulta redirect_uri (este es un URI de redirección, 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 redirección codificado que puede agregarse en el 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 redirect_uri codificado, que podría tener este aspecto:

   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 garantizar que no se compartan datos del usuario con otros grupos, solo redirecciona al redirect_uri si coincide con la siguiente expresión regular:

   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 y seleccione una empresa en tu plataforma (según corresponda), redirígelo a la URL del redirect_uri después de anexarle un objeto extras como parámetro de consulta (al igual que en el inicio de sesión de empresa) en el que se definan business_config y setup (según las configuraciones de incorporación que desees 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 iframe

Para activar una experiencia de usuario más fluida dentro de las apps de negocios y mejorar la compatibilidad al crear nuevas cuentas en la plataforma, debes activar la URL de autenticación para que cargue un iframe en una superficie de Facebook. Consulta las normas de implementación y las especificaciones posmensajes en la documentación de iframes.

Implementación de webhooks

Los webhooks te permiten recibir notificaciones HTTP en tiempo real sobre cambios en objetos específicos en la gráfica social de Facebook. Para la FBE, esto significa que después de que un usuario instale o desinstale la FBE usando tu app (p. ej., a través de Apps de negocios), recibirás la información de esa acción a través de webhooks.

Debes crear un punto de conexión en un servidor seguro que pueda procesar solicitudes de Facebook. Esto es obligatorio para todos los socios de plataformas que deseen que sus apps estén disponibles en Apps de negocios. Consulta la guía de implementación de webhooks para obtener información sobre cómo crear este punto de conexión.

Configuración y validación de webhooks

Una vez que tu punto de conexión de webhooks esté listo, debes hacer lo siguiente para configurarlo y validarlo:

1. Utiliza la tarjeta Webhooks en la sección Extensión de Facebook Business -> Configuración del panel de apps para validar el punto de conexión, y suscribirte 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é correctamente configurado, el círculo en la parte superior derecha de la tarjeta debe ponerse verde y mostrar un icono de tic.

Configuración y validación a través del panel para desarrolladores

El panel para desarrolladores de la extensión de Facebook para empresas es un producto que se encuentra en tu panel de apps de desarrolladores. Una vez que se otorgue capacidad para la FBE a tus apps, mediante el panel para desarrolladores debes configurar y validar tu URL de autenticación y punto de conexión de Webhooks, y agregar detalles sobre lo que tu aplicación ofrece a un negocio.

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

Una vez que tu URL de autenticación esté lista, para su configuración y validación debes hacer lo siguiente:

1. En el panel de tu app, ve al panel para desarrolladores de la FBE. Nota: Si no la configuraste, sigue estas instrucciones para agregarla.
2. Haz clic en la pestaña Configuración y busca la tarjeta de plataforma de Apps de negocios.
3. Marca la casilla Mostrar mi app en la plataforma de Apps de negocios.
4. En URL de autenticación, ingresa tu URL de autenticación.
5. Haz clic en el botón Probar autenticación.
• Se abrirá una ventana emergente en la que se cargará tu URL para reproducir la forma en que tu Facebook la usará en plataformas de Apps de negocios.
• Procede con el inicio de sesión y la selección de negocio (si corresponde).
• Después del redireccionamiento, se cerrara la ventana emergente. Si se producen errores en tu implementación (p. ej., valores o aspectos adicionales no válidos), se mostrarán en la parte inferior de esta tarjeta para que sepas lo que debes corregir. La función de autenticación de prueba solo validará la entrada en redirect_uri y no instalará la FBE.
6. Una vez que se implementen los pasos y la configuración de aspectos adicionales, este paso se marcará como válido (marca verde en la esquina superior derecha de la tarjeta). Esto activará la posibilidad de probar este proceso de registro (instalación de la FBE) de extremo a extremo directamente desde Facebook (consulta la sección a continuación).

Pruebas de extremo a extremo

Una vez que la autenticación de URL y el punto de conexión de Webhook se configuren y se validen de forma correcta en el panel para desarrolladores, podrás hacer pruebas de extremo a extremo del proceso de registro, con ayuda de tu app, antes de que esté disponible. Esto se puede hacer de forma directa desde Facebook Business Suite o de la superficie de la página de Facebook de la siguiente manera:

Mediante Facebook Business Suite

1. Ve a Facebook Business Suite.
2. En el menú de la izquierda, haz clic en Más herramientas y, luego, haz clic en Apps de negocios.
3. Todas las apps disponibles se mencionan allí. La tuya aparecerá en la categoría que seleccionaste como Sectores en la pestaña Configuración del panel para desarrolladores.
4. La app tendrá una etiqueta Solo prueba; no público. Esto significa que está disponible únicamente para pruebas para los usuarios que tengan un rol en tu app y que aún no está disponible para usuarios públicos.
5. Haz clic en Conectar y comienza a probar la experiencia con tu URL de autenticación:
   • El proceso de registro realiza instalaciones reales de la FBE y activará las notificaciones de webhook.

Mediante la superficie de la página de Facebook

1. Dirígete a una página de Facebook a la que tengas acceso de administrador.
2. En el menú de la izquierda de tu página de Facebook, haz clic en Apps de negocios.
3. Todas las apps disponibles se mencionan allí. La tuya aparecerá en la categoría que seleccionaste como Sectores en la pestaña Configuración del panel para desarrolladores.
4. La app tendrá una etiqueta Solo prueba; no público. Esto significa que está disponible únicamente para pruebas para los usuarios que tengan un rol en tu app y que aún no está disponible para usuarios públicos.
5. Haz clic en Conectar y comienza a probar la experiencia con tu URL de autenticación:
   • El proceso de registro realiza instalaciones reales de la FBE y activará las notificaciones de webhook.

Más información

• Cómo usar el inicio de sesión de empresa para la FBE
• extras
• business_config
• setup
• Cómo desinstalar la FBE