Intégration de la messagerie FBE

Facebook Business Extension (FBE) permet aux entreprises de mettre en place et de gérer facilement des conversations avec leurs clients à grande échelle sur Facebook et Instagram. Le processus d’intégration de la messagerie FBE permet aux entreprises de configurer ou d’intégrer les éléments suivants :

Compte Business Manager
Page Facebook
Compte Instagram (si déjà connecté à une Page Facebook)
Compte publicitaire
Conversation Messenger (facultatif)

Ce document présente les principales conditions requises pour le processus de la messagerie FBE, ainsi qu’une présentation détaillée des étapes nécessaires à sa réalisation. Veuillez consulter le guide Facebook Business Extension pour obtenir des détails spécifiques sur les intégrations en général.

Exemple — Processus d’intégration de la plateforme Facebook (Apps d’entreprise)

Avant de commencer

Votre application doit appartenir à un compte Business Manager qui est une entreprise vérifiée. Obtenez plus d’informations sur la procédure de vérification de votre entreprise.
Une application Facebook est nécessaire pour la fonctionnalité, les autorisations et le niveau d’accès suivants :
- Niveau d’accès : accès Avancé.
- Fonctionnalité : accès standard au Gestionnaire de publicités.
- Autorisations publiques : ads_management, ads_read, business_management, pages_manage_ads, pages_manage_metadata, pages_messaging, pages_show_list, page_events.
- Autorisations privées : manage_business_extension – Il s’agit d’une autorisation privée qui requiert l’ajout de votre application à la liste d’éléments autorisés par votre représentant Facebook.
Configurez l’authentification avec les configurations requises et lancez le processus d’intégration FBE à l’aide de Business Login (sur la plateforme du partenaire) ou les apps d’entreprise (sur Facebook).

Configurations requises

Extras

Champ Type Description

Champ	Type	Description
`setup`	configuration	Obligatoire Paramètres de configuration Facebook du vendeur, tels que son identifiant unique (`external_business_id`) ou la devise de son catalogue (`currency`). Voir Détails sur l’objet de configuration.
`business_config`	business_config	Obligatoire Objet de configuration utilisé par Facebook Business Extension pour configurer le flux de travail de Facebook Business Extension. Voir Détails sur l’objet `business_config`.
`repeat`	booléen	Obligatoire Définir cette valeur sur `false`.

setup

configuration

Obligatoire

Paramètres de configuration Facebook du vendeur, tels que son identifiant unique (external_business_id) ou la devise de son catalogue (currency). Voir Détails sur l’objet de configuration.

business_config

business_config

Obligatoire

Objet de configuration utilisé par Facebook Business Extension pour configurer le flux de travail de Facebook Business Extension. Voir Détails sur l’objet business_config.

repeat

booléen

Obligatoire

Définir cette valeur sur false.

Configuration

Utilisez cet objet pour définir les paramètres de présence Facebook de l’utilisateur ou l’utilisatrice final·e.

Champ	Description
`external_business_id` Type : chaîne	Obligatoire. ID d’entreprise unique pour représenter votre entreprise cliente. Nous l’utilisons en tant qu’identifiant unique. Par exemple, si l’entreprise du vendeur s’appelle « Fubar », « fubar-123 » pourrait être son `external_business_id`.
`timezone` Type : chaîne	Obligatoire. Fuseau horaire dans lequel l’entreprise se trouve. Voir les valeurs de fuseau horaire possibles.
`currency` Type : chaîne	Obligatoire. Code ISO à trois lettres de la devise par défaut utilisée par les articles du catalogue de l’entreprise. Voir Codes de devise pris en charge.
`business_vertical` Type : énumération	Obligatoire. Segment vertical associé à l’entreprise. Valeurs : `MESSAGING`
`channel` Type : énumération	Obligatoire. Permet au partenaire de configurer le flux Facebook Business Extension. Pour le processus de la messagerie, cette valeur devrait être `MESSAGING`. `MESSAGING` : processus qui permet aux utilisateur·ices de créer ou de sélectionner Business Manager, un compte publicitaire, une Page Facebook et un compte Instagram. La mise en place de ces éléments permet à l’utilisateur·ice de gérer les conversations avec ses client·es à grande échelle.
`business_manager_id` Type : chaîne	Facultatif. ID Business Manager existant qu’un partenaire peut fournir comme présélection pour l’utilisateur·ice dans le processus de configuration.
`ad_account_id` Type : chaîne	Facultatif. ID de compte publicitaire existant qu’un partenaire peut fournir comme présélection pour l’utilisateur·ice dans le processus de configuration.
`page_id` Type : chaîne	Facultatif. ID de Page Facebook existante qu’un·e partenaire peut saisir pour présélectionner l’utilisateur·ice dans le processus de configuration.
`ig_profile_id` Type : chaîne	Facultatif. ID de profil professionnel Instagram existant qu’un·e partenaire peut fournir comme présélection pour l’utilisateur·ice dans le processus de configuration.

Configuration professionnelle

Utilisez cet objet pour configurer les paramètres professionnels d’un utilisateur ou d’une utilisatrice final·e. Il comprend les CTA, la carte de services, etc. Chaque champ comprend un « type » lié aux tableaux respectifs ci-dessous.

Champ	Description
`business` Type : FBEBusinessPropertiesConfigData	Obligatoire. Information pour l’entreprise de l’utilisateur ou l’utilisatrice final·e
`messenger_chat` Type : FBEMessengerChatConfigData	Facultatif. Fonctionnalités de discussion Messenger sur la Page Facebook de l’utilisateur ou l’utilisatrice final·e, telles que `enabled` et `domains`.
`messenger_menu` Type : FBEMessengerMenuConfigData	Facultatif. Caractéristiques de la fonctionnalité du menu fixe Messenger, telles que `cta_button-text` et `cta_button_url`

Étapes suivantes

Obtenez des notifications Webhook sur l’installation des entreprises et la désinstallation de FBE.
Déclenchez des évènements de pixel pour chaque entreprise intégrée dans la FBE sur votre plateforme.
Ajoutez un point d’entrée vers notre vue Gestion des fonctionnalités à partir de votre plateforme.
Autorisez les entreprises à désinstaller FBE.
Soumettez votre intégration FBE pour vérification. Une fois votre intégration approuvée, votre application sera disponible au grand public.