Raccorder la connexion Facebook

Pour que vos clients s'inscrivent avec un compte Facebook, vous enregistrez d'abord votre service auprès de Facebook et vous récupérez deux valeurs. Ce sont les valeurs App ID et App secret.

Cette page indique l'ordre dans lequel récupérer ces deux valeurs. La manière de placer les valeurs récupérées dans WEEGLOO se trouve dans Placer les valeurs récupérées dans WEEGLOO.

L'adresse à copier en premier

Lorsqu'un client termine sa connexion chez Facebook, Facebook renvoie le résultat vers une adresse déterminée. Vous devez enregistrer cette adresse auprès de Facebook, copiez-la donc dès maintenant. Vous la collerez à l'étape 3.

Choisissez votre Space ci-dessous pour obtenir l'adresse avec l'identifiant déjà rempli.

Space
https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/facebook

Si vous préférez la remplir vous-même, mettez l'identifiant de votre Space à la place de {spaceId}. Ouvrez ce Space dans le studio de contenu et regardez la barre d'adresse du navigateur : la valeur qui suit /spaces/ est l'identifiant.

Cette adresse n'est pas celle de votre site : c'est l'endroit où WEEGLOO reçoit le résultat de la connexion. Elle est donc déjà fixée même si vous n'avez pas encore construit votre site. Si vous avez activé Facebook dans le studio de contenu, la même adresse apparaît à l'étape Step 1, vous pouvez donc la copier depuis là.

Récupérer les deux valeurs chez Facebook

Connectez-vous avec votre compte Facebook, puis suivez dans l'ordre les quatre étapes ci-dessous. Ce que vous faites ici n'entraîne aucun coût.

1

Créer l'application

Vous passez tour à tour par cinq écrans : App details, Use cases, Business, Requirements et Overview.

  1. Ouvrez l'écran de la liste des applications (https://developers.facebook.com/apps).

  2. Cliquez sur Create App.

    L'écran Apps sans aucune application. Au centre figurent l'indication No apps yet et le bouton Create App

  3. Dans App name, saisissez un nom que vous reconnaîtrez plus tard (par exemple Le Dressing Douillet).

  4. Dans App contact email, saisissez l'adresse qui recevra les demandes.

  5. Cliquez sur Next.

    L'étape App details de l'écran que l'on remplit étape par étape. Les champs App name et App contact email sont présents, et le bouton Next se trouve en bas à droite

  6. Cochez Authenticate and request data from users with Facebook Login.

  7. Cliquez sur Next.

    L'étape Use cases de l'écran que l'on remplit étape par étape. Parmi les six éléments, Authenticate and request data from users with Facebook Login est coché

  8. Choisissez l'option I don’t want to connect a business portfolio yet.

  9. Cliquez sur Next.

    L'étape Business de l'écran que l'on remplit étape par étape. L'option I don’t want to connect a business portfolio yet. et l'indication qu'il n'y a aucune entreprise sont visibles

  10. Lisez le contenu de l'écran Requirements, puis cliquez sur Next. Vous n'avez rien à saisir.

    L'étape Requirements de l'écran que l'on remplit étape par étape. Business verification et App Review sont listés sous Publishing requirements

  11. Sur le dernier écran, Overview, vérifiez ce que vous avez choisi jusque-là et créez l'application.

App contact email est l'adresse que Facebook utilise pour vous contacter au sujet de l'application. Le portefeuille d'entreprise peut être ajouté plus tard, comme l'indique l'explication à l'écran.

2

Ajouter l'autorisation e-mail

Lorsqu'un client se connecte avec Facebook, WEEGLOO récupère aussi son adresse e-mail et l'enregistre sur le membre. Si vous n'ajoutez pas l'autorisation email, Facebook ne transmet pas l'adresse e-mail : ne sautez donc pas cette étape.

  1. Dans le menu de gauche, cliquez sur Use cases.

  2. Cliquez sur Customize, sur la ligne Facebook Login.

  3. À gauche, cliquez sur Permissions and features.

  4. Cliquez sur + Add, sur la ligne email.

    La liste Permissions and features. Sur la ligne email, Status ne porte aucune mention et Action contient le bouton + Add, tandis que la ligne public_profile affiche Ready for testing

  5. Vérifiez que le Status des deux lignes email et public_profile affiche bien Ready for testing.

    La même liste. Sur les deux lignes email et public_profile, Status affiche Ready for testing

Dans un même Space, une adresse e-mail ne permet de s'inscrire qu'une seule fois.

3

Enregistrer l'adresse de connexion

L'OAuth qui apparaît sur les écrans est le nom de la méthode qui permet de se connecter avec un compte Facebook.

  1. À gauche, cliquez sur Settings.

  2. Dans le champ Valid OAuth Redirect URIs, collez l'adresse copiée dans L'adresse à copier en premier.

  3. Cliquez sur Save Changes.

    L'écran Settings. Redirect URI Validator figure en haut, et le champ Valid OAuth Redirect URIs se trouve en bas, dans Client OAuth settings

Vous n'y mettez que la seule adresse copiée plus haut. Dans Redirect URI Validator, en haut du même écran, vous pouvez saisir une adresse dans Redirect URI to check et cliquer sur Check URI pour la contrôler.

4

Copier l'App ID et l'App secret

Les deux valeurs se trouvent sur l'écran des paramètres de base de l'application.

  1. Dans le menu de gauche, cliquez sur App settings.

  2. Cliquez sur Basic.

  3. Copiez la valeur inscrite dans App ID.

  4. Cliquez sur Show, placé à droite du champ App secret.

  5. Copiez la valeur qui apparaît.

    L'écran Basic, dans App settings. La valeur App ID est visible, App secret est masqué par des points et le bouton Show se trouve à droite

App ID reste tel quel sur cet écran, et vous pouvez revoir App secret chaque fois que vous cliquez sur Show. Même si vous quittez l'écran sans avoir noté les valeurs, vous n'avez pas besoin d'en créer de nouvelles. App secret est toutefois une valeur secrète : ne la communiquez à personne et ne l'inscrivez nulle part en public.

Un bandeau rouge Currently ineligible for submission peut apparaître en haut de cet écran. Il signale que les champs App icon, Privacy policy URL et Category sont vides. Ces trois éléments sont nécessaires au moment de soumettre la demande de validation, et non pour raccorder la connexion maintenant.

La connexion de tous vos clients exige la validation

L'application que vous venez de créer n'a pas encore été validée. Tant que la validation n'est pas obtenue, seul le compte qui a créé l'application peut se connecter.

Le raccordement à WEEGLOO n'a pas à attendre la validation. Dès que vous placez les deux valeurs, la connexion fonctionne immédiatement.

Pour faire un essai du point de vue d'un client, dépliez App roles dans le menu de gauche, cliquez sur Test users, puis créez un compte d'essai avec Create test users.

L'écran Test users. Le bouton Create test users se trouve à côté du nombre de comptes Facebook Accounts

Lorsque vous êtes prêt à ouvrir la connexion à tous vos clients, soumettez la demande dans App Review, sous Review. Sur cet écran, email et public_profile, traités plus haut, figurent en Not submitted.

L'écran App Review, sous Review. email et public_profile figurent dans la liste Not submitted

Les documents nécessaires et les critères d'examen figurent dans la Documentation Meta.

Placer les valeurs récupérées dans WEEGLOO

Vous avez maintenant les deux valeurs en main. Voici dans quel champ du studio de contenu chacune de ces deux valeurs se place.

Écran de FacebookStudio de contenu
App IDApp ID
App secretApp secret

À partir d'ici, le chemin diffère selon la manière dont vous avez travaillé jusqu'à présent.

Si vous configuriez directement dans le studio de contenu, procédez ainsi.

  1. Revenez à l'activation d'une connexion sociale dans Connexion des membres du service.
  2. Activez Facebook.
  3. Saisissez l'App ID dans le champ App ID de l'étape Step 2.
  4. Saisissez l'App secret dans le champ App secret.
  5. Cliquez sur Enregistrer.

Si vous avez confié le raccordement à un agent IA et qu'il vous a demandé d'aller chercher les valeurs, collez telles quelles les deux valeurs récupérées dans la fenêtre de conversation et poursuivez ce que vous faisiez. L'agent prend en charge la suite de la configuration.

Et ensuite

  • Connexion des membres du service : placez les valeurs récupérées dans le studio de contenu et terminez le reste de la configuration de la connexion des membres.
  • Rôles et autorisations des membres : créez le ServiceUserRole qui définit ce qu'un membre inscrit peut voir et écrire.
  • Auth API : traite les spécifications techniques comme le format des requêtes, nécessaires pour rattacher la connexion au code de votre site.