Authentification par les Applications Business

Les Applications Business, disponibles sur toutes les interfaces Facebook, permettent aux petites entreprises de découvrir des applications d’entreprise tierces et de s’y connecter afin de se doter facilement d’outils professionnels à faible coût technologique, et ainsi de se développer et d’atteindre leurs objectifs commerciaux.

Contrairement à Business Login, le processus des Applications Business est lancé depuis nos interfaces. Il comporte une étape supplémentaire au cours de laquelle l’utilisateur·ice doit se connecter à votre plateforme via un navigateur contextuel pour s’authentifier et sélectionner son entreprise à connecter (identifié par un external_business_id que vous définissez). Une fois l’authentification réussie, l’utilisateur·ice sera redirigé·e vers le processus pour terminer l’intégration.

Si vous souhaitez que votre application s’affiche sur notre interface Applications Business, vous devez créer une URL d’authentification et un point de terminaison Webhook, puis les configurer et les valider via le panneau Developer Panel.

Toutes les applications doivent faire une demande d’examen d’intégration. Une fois votre intégration FBE approuvée, votre application sera disponible au grand public.

Implémentation de l’URL d’authentification

Les Applications Business lancent un flux analogue à celui d’une connexion d’entreprise depuis une interface de page Facebook, Instagram et Facebook Business Suite. Pour activer ce processus et faire en sorte que votre application apparaisse ici, vous devez fournir une interface d’utilisation d’authentification personnalisée à partir de laquelle l’utilisateur ou l’utilisatrice sélectionne son entreprise sur votre site et la redirige vers le processus Facebook, Instagram ou Facebook Business Suite.

Fonctionnement

1. Fournissez un point de terminaison d’URL personnalisée (URL d’authentification) qui charge le processus d’authentification de votre plateforme.
• Votre URL d’authentification doit diriger l’utilisateur ou l’utilisatrice (propriétaire d’entreprise) vers un processus de connexion sur votre plateforme.
• Proposez une option permettant d’enregistrer un nouveau compte sur votre plateforme (par exemple, « S’inscrire »). Une fois son inscription faite, l'utilisateur ou l’utilisatrice doit être renvoyé·e vers Facebook pour terminer la connexion de son compte.
• Si vous prenez en charge plusieurs entreprises par compte sur votre plateforme et que la connexion a abouti, l’URL d’authentification affiche une interface d’utilisation dans laquelle l'utilisateur ou l’utilisatrice peut sélectionner l’entreprise de votre plateforme à associer à ses éléments Facebook.
Exemple — URL d'authentification

https://yourwebsite.com/fbe-auth

2. Facebook charge l’URL d'authentification fournie pendant le flux d'intégration et ajoute un paramètre de requête redirect_uri à la fin (il s'agit d'une URI de redirection qui peut inclure des paramètres de requête supplémentaires) :

   https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>

   Exemple — URI de redirection encodée qui pourrait être ajoutée dans le paramètre de requête redirect_uri :

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>

   À la fin de cette étape, Facebook charge l’URL d'authentification avec un paramètre de requête redirect_uri codé qui peut se présenter comme suit :

   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

   Remarque importante : pour vérifier que vous ne partagez pas de données utilisateur avec d’autres groupes, n’effectuez la redirection vers redirect_uri que s’il correspond à l’expression régulière suivante :

   https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?

3. Une fois que l'utilisateur ou l’utilisatrice a terminé la connexion/l’inscription et sélectionné une entreprise sur votre plateforme (le cas échéant), redirigez-le ou la vers l'URL de redirect_uri après y avoir ajouté un objet codé extras comme paramètre de requête (le même que celui que vous pourriez utiliser pour Business Login) avec business_config et setup définis dedans (selon les configurations d'intégration que vous souhaitez implémenter) :

   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>

Authentification par iframe

Pour permettre une expérience d’utilisation plus fluide dans les Applications Business et favoriser la création de nouveaux comptes sur votre plateforme, autorisez le chargement de l’URL d'authentification dans un iframe sur une plateforme Facebook. Reportez-vous aux règles d’implémentation et aux spécifications post-message dans la documentation sur les iframes.

Implémentation des webhooks

Les Webhooks vous permettent de recevoir des notifications HTTP en temps réel relatives aux modifications apportées à des objets spécifiques du graphe social Facebook. Pour FBE, cela signifie que lorsqu'un·e utilisateur·ice installe ou désinstalle FBE à l'aide de votre application (par exemple, via les Applications Business), vous recevrez les détails de cette action via des webhooks.

Vous devez construire un point de terminaison sur un serveur sécurisé capable de traiter les demandes provenant de Facebook. Cela est obligatoire pour tous les partenaires de la plateforme souhaitant proposer leur application sur les Applications Business. Consultez le guide d’implémentation des Webhooks pour découvrir comment créer ce point de terminaison.

Configuration et validation des webhooks

Une fois que votre point de terminaison Webhook est prêt, procédez comme suit pour le configurer et le valider :

1. Utilisez la carte Webhooks de la section Extension Facebook Business -> Configuration de l’Espace App pour valider le point de terminaison, et abonnez-vous au webhook fbe_install. Consultez le Guide d’implémentation des Webhooks pour plus de détails.
2. Une fois le produit Webhooks correctement configuré, le cercle en haut à droite de la carte doit devenir vert et contenir une coche.

Configuration et validation via le Developer Panel

Le produit Developer Panel de l’extension Facebook Business est disponible dans votre Espace App pour développeurs. Une fois que vos applications ont obtenu la fonctionnalité FBE, vous devez utiliser le Developer Panel pour configurer et valider votre URL d'authentification, votre point de terminaison Webhook, et pour ajouter des détails sur ce que votre application offre à une entreprise.

Configuration et validation de l'URL d'authentification

Une fois que votre URL d'authentification est prête, procédez comme suit pour la configurer et la valider :

1. Accédez au FBE Developer Panel dans le tableau de bord de votre application. Remarque : si vous ne l’avez pas configuré, suivez ces instructions pour l’ajouter.
2. Cliquez sur l'onglet Configuration et recherchez la carte Surface Business Apps.
3. Activez la case à cocher Afficher mon application sur la surface Business Apps.
4. Dans l’entrée URL d’authentification, saisissez votre URL d’authentification.
5. Cliquez sur le bouton Tester l’authentification.
• Une fenêtre pop-up s'ouvre et charge votre URL pour imiter la façon dont Facebook l'utilisera sur les interfaces Applications Business.
• Procédez à la connexion et à la sélection de l'entreprise (le cas échéant).
• Après la redirection, la fenêtre pop-up se ferme. Si votre implémentation comporte des erreurs (par exemple, des valeurs invalides sur les extras), elles s’afficheront au bas de cette carte afin que vous connaissiez les corrections à apporter. La fonctionnalité Tester l'authentification ne validera que l'entrée sur redirect_uri, et n'installe pas réellement FBE.
6. Une fois que la configuration des étapes et des extras est implémentée comme prévu, cette étape sera marquée comme valide (coche verte dans le coin supérieur droit de la carte). Cela permettra de tester de bout en bout ce processus d'intégration (installer FBE) directement depuis Facebook (voir la section ci-dessous).

Test de bout en bout

Une fois que l’URL d'authentification et le point de terminaison Webhook ont été configurés et validés dans le Developer Panel, vous pouvez tester de bout en bout le processus d'intégration, optimisé par votre application, avant de les mettre en ligne. Vous pouvez le faire directement à partir de la suite Facebook Business ou de l’interface Page Facebook comme suit :

Via la suite Facebook Business

1. Accédez à la suite Facebook Business.
2. Dans le volet de gauche, cliquez sur Autres outils, puis sur Applications Business.
3. Toutes les applications disponibles y sont répertoriées. Les vôtres seront répertoriées sous la catégorie que vous avez sélectionnée comme Secteur(s) dans l'onglet Configuration du Developer Panel.
4. Votre application présentera un libellé Test uniquement - Non publique. Cela signifie qu'elle est uniquement disponible en test pour les utilisateur·ices qui ont un rôle dans votre application, et qu’elle ne l’est pas encore pour le grand public.
5. Cliquez sur Connecter et commencez à tester l'expérience optimisée par votre URL d'authentification :
   • Le processus d'intégration effectue les installations réelles de FBE et déclenche les notifications Webhook.

Via l’interface Page Facebook

1. Accédez à une Page Facebook pour laquelle vous disposez d’un accès admin.
2. Dans le volet de gauche de votre Page Facebook, cliquez sur Applications Business.
3. Toutes les applications disponibles y sont répertoriées. Les vôtres seront répertoriées sous la catégorie que vous avez sélectionnée comme Secteur(s) dans l'onglet Configuration du Developer Panel.
4. Votre application présentera un libellé Test uniquement - Non publique. Cela signifie qu'elle est uniquement disponible en test pour les utilisateur·ices qui ont un rôle dans votre application, et qu’elle ne l’est pas encore pour le grand public.
5. Cliquez sur Connecter et commencez à tester l'expérience optimisée par votre URL d'authentification :
   • Le processus d'intégration effectue les installations réelles de FBE et déclenche les notifications Webhook.

En savoir plus

• Utilisation de Business Login pour FBE
• extras
• business_config
• setup
• Comment désinstaller FBE