Intégration des Rendez-vous de Meta Business Extension

Le flux Rendez-vous de Meta Business Extension (MBE) permet aux vendeurs et vendeuses sur votre plateforme d’accéder à un large éventail d’outils professionnels comme les boutons call-to-action Réserver sur leur page Facebook, dans leur compte Instagram et dans leurs discussions Messenger avec des client·es.

Exemple : Processus d’intégration de la plateforme du partenaire (connexion entreprise)

Avant de commencer

  1. Inscrivez-vous en tant que développeur·se Meta pour accéder aux outils de développement et créer des applications Facebook.
  2. Si vous ne l’avez pas encore fait, créez une application Meta, en sélectionnant le type Entreprise.
  3. À partir de votre application en ligne/de production, créez une application test qui vous permettra de réaliser tous vos nouveaux développements et vos tests.
  4. Vos applications (en ligne/de production et de test) doivent être des applications de type Entreprise et appartenir au compte Business Manager d’une entreprise vérifiée. Découvrez comment vérifier votre entreprise et y ajouter vos applications.
  5. Ajoutez le produit MBE Developer Panel à votre application.
  6. Si vous souhaitez activer la fonctionnalité Carte des services de la page, votre application doit être approuvée pour l’autorisation de catalogue (catalog_management) via Contrôle app avant d’être mise en ligne. catalog_management autorise votre application à créer, lire, mettre à jour et supprimer des catalogues appartenant à l’entreprise (inventaire des services). Soumettez votre demande au Contrôle app dès que vous disposez d’une version de démonstration fonctionnelle vous permettant de montrer par capture vidéo :
    • comment l’autorisation de catalogue est demandée dans le processus d’intégration ;
    • comment l’inventaire des services est transmis au catalogue connecté ;
    • et enfin comment la carte des services est activée sur la page connectée.

Étapes d’intégration et points d’entrée

Les propriétaires d’entreprises (client·es) ont besoin d’un mécanisme leur permettant de connecter leur entreprise sur une plateforme partenaire à leurs profils Facebook ou Instagram, et inversement. Cette tâche peut être réalisée à l’aide du processus d’intégration. Le flux Rendez-vous inclut les éléments suivants :

  • Création/sélection d’éléments
  • Octroi d’autorisations
    • Gestion de l’extension d’entreprise
    • Gestion des catalogues (facultatif)
  • Configuration de l’entreprise et fonctionnalités

Pour permettre la connexion, vous devez prendre en charge deux flux d’authentification, en fonction de l’endroit où l’utilisateur (propriétaire de l’entreprise) lance la connexion :

  • Plateforme partenaire (communément appelée Business Login) — Permet aux entreprises de lancer la connexion à partir de votre plateforme, à l’aide d’un bouton que vous avez placé sur votre site.
  • Applications d’entreprise — Permet aux entreprises de lancer la connexion à partir de Facebook/Instagram. Pour activer ce flux et faire en sorte que votre application apparaisse dans les Apps d’entreprise, vous devez fournir une interface d’authentification personnalisée permettant à l’utilisateur de sélectionner son entreprise sur votre site, puis le rediriger vers le flux Facebook ou Instagram.

Configurations requises

extras

ChampTypeDescription

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

Utilisez cet objet pour définir les paramètres de présence Facebook du client final.

ChampDescription

external_business_id
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.

Consultez la liste des codes de devise pris en charge.

business_vertical
Type : énumération {APPOINTMENTS}

Obligatoire.
Secteur associé à l’entreprise.

Utilisez APPOINTMENTS comme secteur associé à l’entreprise.

business_config

Utilisez cet objet pour configurer les paramètres de l’entreprise 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.

ChampDescription

business
Type : FBEBusinessPropertiesConfigData

Obligatoire.
Information pour l’entreprise de l’utilisateur ou l’utilisatrice final·e.

ig_cta
Type : FBEIGCtaConfigData

Obligatoire.
Caractéristiques du bouton call-to-action (CTA) d’Instagram, telles que enabled, cta_button_text, cta_button_url, etc.


Texte CTA pris en charge : Book Now

page_cta
Type : FBEPageCtaConfigData

Obligatoire.
Caractéristiques du bouton call-to-action (CTA) de la page Facebook, telles que cta_button_text, cta_button_url, etc.


Texte CTA pris en charge : Book Now

page_card
Type : FBEPageCardConfigData

Facultatif.
Active la carte des services proposés par l’entreprise (jusqu’à trois) sur sa page Facebook.

Requiert la mise en place d’un catalogue.

messenger_menu
Type : FBEMessengerMenuConfigData

Facultatif.
Caractéristiques du bouton call-to-action (CTA) de Messenger lorsqu’un utilisateur ou une utilisatrice discute avec l’entreprise, telles que cta_button_text et cta_button_url.


Texte CTA pris en charge : Book Now

thread_intent
Type : FBEThreadIntentConfigData

Facultatif.
Suggestion Messenger permettant aux admins de l’entreprise d’envoyer facilement à un utilisateur ou une utilisatrice leur disponibilité pour les rendez-vous au cours d’une discussion.

Exemple d’extras pour Rendez-vous

{
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>",
        "timezone": "<BUSINESS_TIMEZONE>",
        "currency": "<BUSINESS_CURRENCY>",
        "business_vertical": "APPOINTMENTS"
    },
    "business_config": {
        "business": {
            "name": "<BUSINESS_NAME>"
        },
        "page_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>",
            "below_button_text": "Powered by <YOU>"
        },
        "page_card": {
            "enabled": true,
            "see_all_text": "See All",
            "see_all_url": "<BUSINESS_URL_FOR_CTA>",
            "cta_button_text": "Book"
        },
        "ig_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "messenger_menu": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "thread_intent": {
            "enabled": true,
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        }
    },
    "repeat": false
}

En savoir plus sur les configurations d’entreprise.

Étapes suivantes