Configurer les fonctionnalités d’entreprise

Découvrez les options disponibles pour activer et configurer les fonctionnalités d’entreprise pour Facebook Business Extension.

Options de configuration

Pour activer et configurer les fonctionnalités d’entreprise pour l’utilisateur·ice, utilisez l’une des options disponibles ci-dessous :

OptionDescriptionRecommandation

Configuration des fonctionnalités via Business Login

Business Login permet désormais d’activer et de désactiver les fonctionnalités de Facebook Business Extension (FBE).

Activez cette option pour les partenaires dans le panneau des développeur·ses FBE. Lorsque cette fonctionnalité est utilisée, les partenaires doivent informer les utilisateur·ices que ces fonctionnalités sont automatiquement activées.

Option recommandée si vous disposez d’un ensemble par défaut de fonctionnalités à configurer pour l’utilisateur·ice.

Vue Gestion des fonctionnalités

Interface utilisateur Facebook en libre-service permettant à l’utilisateur·ice d’activer et de désactiver les fonctionnalités FBE.

Option recommandée si vous ne souhaitez pas créer d’interface utilisateur, ni utiliser l’interface en libre-service de Facebook ou les fonctionnalités Facebook et Instagram associées.

API Feature Configuration

Crée une vue Gestion des fonctionnalités personnalisée pour activer et désactiver les fonctionnalités FBE.

Option recommandée si vous souhaitez créer votre propre vue Gestion des fonctionnalités afin qu’elle se présente comme celle de vos utilisateur·ices.

Fonctionnalités prises en charge

Facebook Business Extension offre de nombreuses fonctionnalités que vous pouvez activer pour vos entreprises.

Les fonctionnalités ci-dessous sont regroupées en fonction du secteur auquel elles correspondent le mieux :

Fonctionnalités standard

FonctionnalitéParamètreDescription

Call-to-action à une Page Facebook

page_cta(s)

Type : FBEPageCtaConfigData

Bouton call-to-action (CTA) sur la Page Facebook d’une entreprise.

Call-to-action à Instagram

ig_cta(s)

Type : FBEIGCtaConfigData

Bouton call-to-action (CTA) sur le profil Instagram d’une entreprise.

Call-to-action à Messenger

messenger_menu

Type : FBEMessengerMenuConfigData

Bouton call-to-action (CTA) dans Messenger lorsqu’un·e utilisateur·ice échange avec l’entreprise.

Discussion Messenger

messenger_chat

Type : FBEMessengerChatConfigData

Permet l’intégration directe de Messenger sur votre site web afin que les client·es puissent interagir avec votre entreprise à tout moment.

Fonctionnalités spécifiques aux RENDEZ-VOUS

FonctionnalitéParamètreDescription

Carte de page des services

page_card

Type : FBEPageCardConfigData

Requiert un catalogue.

Carte indiquant les services proposés par l’entreprise sur sa Page Facebook.

Envoi de disponibilité via Messenger - Intention de discussion

thread_intent

Type : FBEThreadIntentConfigData

Suggestion Messenger permettant aux administrateur·ices de l’entreprise d’envoyer facilement leur disponibilité à un·e utilisateur·ice au cours d’une discussion.

Aucune implémentation supplémentaire requise

FonctionnalitéParamètreDescription

Call-to-action à une Page Facebook

page_cta

Type : FBEPageCtaConfigData

Bouton call-to-action (CTA) sur la Page Facebook d’une entreprise.

Call-to-action à Instagram

ig_cta

Type : FBEIGCtaConfigData

Bouton call-to-action (CTA) sur le profil Instagram d’une entreprise.

Call-to-action à Messenger

messenger_menu

Type : FBEMessengerMenuConfigData

Bouton call-to-action (CTA) dans Messenger lorsqu’un·e utilisateur·ice échange avec l’entreprise.

Envoi de disponibilité via Messenger - Intention de discussion

thread_intent

Type : FBEThreadIntentConfigData

Suggestion Messenger permettant aux administrateur·ices de l’entreprise d’envoyer facilement leur disponibilité à un·e utilisateur·ice au cours d’une discussion.

Implémentation supplémentaire requise

FonctionnalitéParamètreDescription

Carte de page des services

page_card

Type : FBEPageCardConfigData

Disponible pour le secteur RENDEZ-VOUS uniquement.

Requiert la mise en place d’un catalogue.

Active la carte des services d’une entreprise sur sa Page Facebook. Consultez la page Catalogue FBE pour connaître les champs et les formats obligatoires pour le secteur des SERVICES.

Discussion Messenger

messenger_chat

Type : FBEMessengerChatConfigData

Permet l’intégration directe de Messenger sur votre site web. Votre clientèle peut ainsi interagir avec votre entreprise à tout moment avec la même expérience multimédia personnalisée que dans Messenger.

Si messenger_chat renvoie la valeur enabled: true depuis l’API Feature Configuration :

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • La valeur page_id peut être obtenue via le webhook ou le guide de point de terminaison des installations FBE.
  • Facebook récupère automatiquement les personnalisations en fonction de la valeur page_id transmise. Par conséquent, aucune personnalisation n’a besoin d’être explicitement transmise.

Pour obtenir le guide complet des implémentations, consultez Plugin Customer Chat.

Configuration des fonctionnalités initiales via Business Login

Vous pouvez configurer un nombre illimité de fonctionnalités pour votre entreprise en les spécifiant dans la propriété business_config, qui est transmise via le paramètre extras dans Business Login et dans l’App Store. Cette propriété vous permet d’indiquer toutes les fonctionnalités que vous souhaitez activer pour votre entreprise dès que l’installation de FBE est terminée.

business_config est un objet JSON contenant des sous-champs permettant de décrire comment configurer les différentes fonctionnalités. Apprenez-en plus sur les sous-champs à spécifier et sur la propriété business_config. Par exemple, si vous souhaitez configurer uniquement les boutons CTA Instagram et Page Facebook de l’entreprise, votre objet business_config devrait se présenter comme suit :

{
  "business": {
    "name": "Foo Business"
  },
  "page_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business",
    "below_button_text": "Powered by FBE Partner"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

Vue Gestion des fonctionnalités FBE

Pour permettre aux entreprises d’affiner la configuration des fonctionnalités (au-delà de celles spécifiées dans la propriété business_config au moment de l’installation), vous pouvez les rediriger vers notre Vue Gestion FBE à partir de votre plateforme.

Vous pouvez ajouter un point d’entrée permettant de lancer la Vue Gestion FBE en insérant n’importe laquelle des méthodes suivantes (SDK JavaScript ou URL). Ces deux exemples fournissent un bouton permettant d’accéder à la fenêtre du mode de gestion FBE. Nous vous recommandons de masquer ce bouton de lancement jusqu’à ce qu’un·e client·e termine une configuration FBE. Prenez soin d’indiquer la valeur fbe_external_business_id pour external_business_id.

Vous pouvez spécifier l’onglet sélectionné pour la Vue Gestion FBE en transmettant le paramètre facultatif tab avec le nom de l’onglet voulu. Par exemple, il peut être défini sur Accueil ou sur Commerce. Ce paramètre peut être utilisé dans le SDK JavaScript ou avec la méthode via une URL.

SDK JavaScript Facebook

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

Méthode via une URL

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

API Feature Configuration FBE

Pour configurer et mettre à jour les fonctionnalités d'une entreprise de votre côté après leur installation initiale, vous pouvez utiliser l’API Feature Configuration FBE.

En ce qui concerne les fonctionnalités non personnalisables, seuls l’ID d’instance des fonctionnalités et un indicateur activé s’affichent. Seules les fonctionnalités personnalisables peuvent être mises à jour à l’aide d’une requête POST.

L’API Feature Configuration diffère de l’API Installation de FBE, car elle fournit des informations supplémentaires sur les fonctionnalités au-delà des éléments associés, y compris le statut activé et les personnalisations de fonctionnalités spécifiques. Après avoir appelé l’API Installation de FBE, utilisez l’API Feature Configuration si vous avez besoin de davantage d’informations sur le statut activé ou la configuration de la fonctionnalité.

Les points de terminaison d’API ci-dessous vous permettent d’activer, de désactiver et de configurer les fonctionnalités d’une entreprise spécifique sur votre plateforme qui a installé FBE. La valeur access_token utilisée pour ces points de terminaison est celle qui vous a été renvoyée via Business Login ou le webhook.

Nous vous recommandons de ne pas stocker les configurations d’entreprise sur vos serveurs. Les configurations doivent toujours être interrogées, puis modifiées à l’aide des API définies ci-dessous. Les utilisateur·ices peuvent éventuellement modifier ces fonctionnalités sur la plateforme Facebook ou via la Vue Gestion FBE, mais votre plateforme risque de ne pas bénéficier des configurations les plus récentes.

Consultation

Vous pouvez consulter l’état actuel de la configuration des fonctionnalités d’une entreprise en exécutant la requête suivante :

CURL -X GET 'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

Réponse

Voir l’objet business_config.

Mise à jour

Pour mettre à jour toutes les fonctionnalités, envoyez la requête POST suivante :

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' \

  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Réponse

Un exemple de réponse.

    {
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

Activez et configurez le bouton call-to-action (CTA) de la page d’un·e utilisateur·ice final·e et envoyez des requêtes POST :

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

En savoir plus

Catalogue