Integración de la incorporación

La incorporación a tiendas es un paso necesario para que los vendedores puedan realizar la integración en Meta Commerce. Una incorporación fluida garantiza que los productos de los vendedores estén actualizados, que la información del pedido esté sincronizada correctamente y sea fácil de obtener de forma trimestral o anual, y que la información bancaria y de pago esté configurada correctamente para realizar los pagos y los informes de forma oportuna.

Requisitos

Debes realizar la integración con la extensión de Facebook para empresas (FBE) para cumplir nuestra barra de calidad de integración de tiendas al permitir que los vendedores puedan hacer lo siguiente:

• Descubrir la integración de Meta fácilmente en la plataforma.
• Conectar su cuenta de terceros a recursos de Meta (Business Manager, un catálogo existente cuando sea necesario, un píxel existente cuando sea necesario, páginas o identificadores de Instagram).
• Configurar y editar las opciones de la tienda en el sitio (configuración de las devoluciones, información legal, información de la cuenta bancaria o información fiscal).
• Vincular recursos adicionales (páginas o identificadores de Instagram) a la tienda.
• Editar su configuración.
• Realizar el proceso de cancelación.

Antes de empezar

1. Integra tu empresa verificada a FBE.
2. Añade FBE a tu aplicación y obtén acceso al panel para desarrolladores de FBE. Consulta este diagrama para comprender el flujo de FBE para Commerce.
3. Sigue los pasos de configuración de FBE y, a continuación, envía la integración para la revisión de la integración de FBE. Esto incluye la activación de la experiencia de administración de funciones de FBE dentro de la plataforma para que las empresas puedan cambiar sus funciones o incluso desinstalar su configuración de FBE.

Requisito 1: Realizar la integración con la extensión de Facebook para empresas

La extensión de Facebook para empresas (FBE) es una interfaz propiedad de Meta basada en ventanas emergentes que se encuentra en los sitios de terceros en forma de plugin y que simplifica el proceso de integración general con Meta. La extensión de Facebook para empresas permite a los negocios configurar fácilmente las tiendas, el catálogo y el píxel de Meta. Los ayuda a conectar sus productos y servicios con los canales de Facebook e Instagram en tu plataforma. Una vez establecida la conexión, puedes ayudarlos a usar una amplia variedad de funciones eficaces.

En resumen, la separación de responsabilidades en una integración basada en la extensión de Facebook para empresas es como se describe a continuación:

• Propiedad de Meta: interfaz, autenticación, conexión y una superficie [(vista de administración de FBE)](vista de administración de funciones de FBE) para ver los recursos conectados, administrar las funciones instaladas y el estado de las integraciones de Commerce.
• Propiedad del socio: configuración del píxel, subida del inventario al catálogo de Facebook mediante la API.

Una vez configurada, los negocios pueden iniciar un flujo de incorporación de FBE mediante los recursos existentes o la opción de crear recursos nuevos, o una combinación de ambas opciones.

Paso 1: Añadir puntos de entrada a la extensión de Facebook para empresas a la aplicación

Crea puntos de entrada a FBE en los que el usuario selecciona, administra o crea sus recursos (p. ej., la empresa, el catálogo, las tiendas, el píxel, etc.). Estos puntos de entrada pueden presentar una de estas formas:

• Inicio de sesión empresarial (conocido habitualmente como inicio de sesión con Facebook): permite a las empresas iniciar su conexión desde tu plataforma con un botón colocado en tu sitio.
• Aplicaciones empresariales: permite a las empresas iniciar su conexión desde una interfaz de Meta. A fin de activar este flujo y que tu aplicación aparezca en la lista de aplicaciones empresariales de Meta, debes proporcionar una IU de autenticación personalizada en tu sitio. Esta IU debe permitir al usuario seleccionar su empresa y, a continuación, redirigirlo al flujo de Meta con la información seleccionada.

Ejemplo

https://facebook.com/dialog/oauth?
client_id=<FB_APP_ID>
&display=page
&redirect_uri="https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension
//   additionally use catalog_management or ads_management
//   &scope=manage_business_extension,catalog_management,ads_management
&extras={
  "setup": {
    "external_business_id": "foo-123",
    "timezone": "America/Los_Angeles",
    "currency": "USD",
    "domain": "https://example-shop.partner-site.com/",
    "channel": "ECOMMERCE",
    "business_vertical": "ECOMMERCE"
  },
  "business_config": {
    "business": {
      "name": "Foo Business"
    },
    "catalog_feed_scheduled": {
      "enabled": true,
      "feed_url": "https://partner-site.com/feed-url"
    },
    "page_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business",
      "below_button_text": "Powered by FBE Partner"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    },
    "messenger_menu": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    }
  },
  "repeat": false
}

En función de la configuración que elijas, puedes obtener el identificador de acceso de la empresa para los pasos posteriores de diferentes maneras:

• Inicio de sesión empresarial: igual que con un inicio de sesión con Facebook normal, al finalizar el proceso se devuelve un elemento access_token, que se utiliza para obtener más recursos (p. ej., el identificador del píxel, el identificador de la página y el identificador de Instagram para empresas).
• Aplicaciones empresariales: mediante webhooks.

Paso 2: Configurar los webhooks de FBE_install

Los webhooks son necesarios para todos los socios que quieran aparecer en la App Store. Si no tienes previsto que tu aplicación esté en la App Store, puedes ignorar esta sección o consultarla más adelante. Meta activa eventos de webhooks cada vez que una de tus empresas instala, modifica o desinstala la extensión de Facebook para empresas. Cada vez que se recibe un evento de webhooks, se espera que tu aplicación use este evento y comprenda los recursos que la empresa ha modificado, añadido o eliminado de su conexión con tu aplicación. El comportamiento de la aplicación debe actualizarse según los recursos conectados más recientes. Te recomendamos encarecidamente que implementes y pruebes tu suscripción a nuestro webhook.

Para configurar un webhook:

1. Crea un extremo en un servidor seguro que pueda procesar correctamente solicitudes de Meta.
2. En el panel de aplicaciones, configura la descripción de los webhooks de la extensión de Facebook para empresas:
1. En la sección FBE > pestaña Webhooks, añade la URL de devolución de llamada de la aplicación.
2. Introduce un identificador de verificación y, a continuación, valida el extremo.

Después de la configuración, el webhook fbe_install se suscribe automáticamente.

Para ver los pasos más detallados, consulta Webhook.

Notificaciones

Cuando recibas una notificación de webhook de una instalación, debes hacer lo siguiente:

1. Almacena el identificador de acceso (y el tipo) y registra los recursos a los que se ha concedido acceso a tu aplicación.
2. Activa un conjunto de funciones a partir de estos recursos.
3. Si falta un recurso necesario para una función específica, desactiva únicamente esa función. Por ejemplo, si a la aplicación se le ha concedido acceso a un catálogo, pero no a un píxel, implementa únicamente la función con el catálogo, no la función con el píxel.
4. Informa al usuario del comportamiento de la aplicación con una actualización en función de los recursos a los que tiene acceso.

Cuando recibas una actualización de una instalación existente, debes hacer lo siguiente:

1. Actualiza el identificador de acceso y el registro de los recursos a los que se te ha concedido acceso.
2. Actualiza el conjunto de funciones que se activarán en tu aplicación para el vendedor en función de los recursos a los que se ha concedido acceso en la plataforma.
3. Informa al usuario del comportamiento de la aplicación con una actualización en función de los recursos a los que tiene acceso.

Cuando recibas una notificación de desinstalación, debes hacer lo siguiente:

1. Desactiva las funciones que tu aplicación implementa para el vendedor.
2. Informa al vendedor sobre el cambio en su configuración.

Paso 3: Recuperar los detalles de los recursos con el identificador devuelto

Puedes obtener información sobre las empresas conectadas a tu plataforma mediante la extensión de Facebook para empresas siguiendo uno de los dos métodos siguientes (o ambos):

• Webhook: necesario para todos los socios que quieran aparecer en la App Store. Con un webhook configurado, los detalles de las empresas que incorporen o editen con la extensión de Facebook para empresas se recibirán a través de la carga útil del webhook configurado en el paso 2.
• Extremo de la API de instalaciones de FBE: recomendada para las empresas autohospedadas. Para cualquier negocio que haya instalado la extensión de Facebook para empresas, puedes consultar su información de instalación básica con el extremo fbe_installs. Con el identificador de acceso de una empresa y el identificador del negocio externo, puedes llamar al extremo de la API de instalaciones de FBE para obtener información detallada sobre su configuración.

Ejemplo: llamada a la API de instalaciones de FBE

curl -i -X GET \   "https://graph.facebook.com/<version>/fbe_business/fbe_installs?fbe_external_business_id=<external business id>&access_token=<access token sanitized>"

Paso 4: Recuperar el identificador de usuario del sistema

Cuando un usuario instala FBE, la extensión genera un usuario del sistema de empleado en la cuenta de Business Manager del cliente. Ten en cuenta que este usuario del sistema ya no es visible en Business Manager, pero existe en el back-end. La nomenclatura de este nuevo usuario del sistema sigue el esquema {App Name} System User (FBE).

Para ello, haz la llamada a la API siguiente:

curl -X POST \
  -F 'app_id={app_id}' \
  -F 'scope=ads_management,catalog_management,manage_business_extension' \ 
  -F 'access_token={user_access_token}' \
  -F 'fbe_external_business_id={fbe_external_business_id}' \ 
https://graph.facebook.com/<API_VERSION>/<client_business_manager_id>/access_token

En el campo scope, usa el permiso manage_business_extension. En función de tu caso de uso (consulta el paso 5), es probable que los permisos ads_management, catalog_management, pages_read_engagement, business_management, instagram_basic y manage_business_extension también sean necesarios.

• Si tu aplicación necesita leer y administrar la cuenta publicitaria de una empresa, solicita el permiso ads_management. Con este permiso, puedes crear campañas publicitarias, recuperar métricas de anuncios, crear herramientas de administración de anuncios, etc.
• Si tu aplicación necesita crear, leer, actualizar o eliminar catálogos de productos propiedad de la empresa de los que la empresa sea administrador, debes solicitar el permiso catalog_management. Recomendamos este permiso para todas las aplicaciones. De esta forma, tu aplicación puede crear anuncios dinámicos relacionados con el comercio y soluciones de administración de inventario.

Paso 5: Configurar la vista de administración

Para permitir a las empresas configurar más funciones (además de las que se especifican en la instalación), puedes dirigirlas a nuestra vista de administración de funciones de FBE desde tu plataforma. Puedes usar la URL o el SDK de JavaScript para añadir un punto de entrada a fin de iniciar la vista de administración de FBE. Los dos métodos deben mostrar un botón en el que se pueda hacer clic que inicie la ventana de la vista de administración de FBE.

Paso 6: Añadir un punto de entrada para desinstalar la extensión de Facebook para empresas

La plataforma debe añadir un punto de entrada (p. ej., un botón) para que las empresas desinstalen FBE. Te recomendamos que para ello realices una solicitud DELETE al extremo correspondiente.

Ejemplo: llamada a nuestro extremo de eliminación

curl -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/fbe_business/fbe_installs?fbe_external_business_id=<FBE_EXTERNAL_BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

Si has implementado un webhook fbe_install, recibirás eventos cuando el usuario desinstale FBE.

Más información

• Extensión de Facebook para empresas (FBE)
• Pasos de configuración de FBE
• Panel de FBE para desarrolladores
• Desinstalar FBE
• Webhooks