Connexions par autorisation : Shopify, Meta et Google Workspace

Ces connexions servent à l’app pour lire les données de votre compte (produits et commandes de votre boutique, publications de votre page). Ne les confondez pas avec la connexion sociale, où c’est votre client qui se connecte à l’app avec son propre compte : cela se trouve dans l’onglet Authentification, voir Inscription et connexion dans votre app.

Avant de commencer

• Plan : Builder. Le plan est vérifié à chaque utilisation : si le compte quitte le Builder, l’app cesse de lire ces données ;
• Coût : créer les apps chez les fournisseurs est gratuit. Chaque appel que l’app fait à ces comptes consomme des crédits d’intégration ;
• Vous devez être présent à l’étape d’autorisation : c’est vous qui approuvez l’accès, connecté à votre compte chez le fournisseur.

Comment fonctionne l’autorisation

Le chemin est le même pour Shopify et Meta, en deux étapes :

1. enregistrer les clés de l’app que vous avez créée chez le fournisseur, sur la carte, avec Enregistrer et activer ;
2. connecter le compte : sur la même carte, cliquez sur Connecter le compte. Une fenêtre du fournisseur s’ouvre, vous vous connectez à votre compte et approuvez l’accès. La fenêtre se ferme toute seule et la carte affiche « Intégration active. »

Le bouton Connecter le compte reste désactivé tant que les clés ne sont pas enregistrées (« Enregistrez d’abord les clés, puis connectez le compte. »). Enregistrer les clés ne suffit pas : sans l’étape 2, l’app répond qu’il faut d’abord connecter le compte.

Shopify

Champs de la carte : Shop domain, API key et API secret key.

L’app peut lister les produits, voir un produit, lister les commandes et lister les clients de la boutique. C’est de la lecture seule : l’accès demandé à la boutique consiste à lire les produits, les commandes et les clients.

1. sur partners.shopify.com, créez une app (pour tester, une boutique de développement est gratuite) ;
2. copiez le Client ID (il va dans le champ API key) et le Client secret (il va dans API secret key) ;
3. dans l’éditeur de l’app, onglet Intégrations, catégorie E-commerce, ouvrez la carte Shopify ;
4. dans Shop domain, indiquez le domaine de la boutique au format votre-boutique.myshopify.com. Il doit s’agir de l’adresse .myshopify.com, pas du domaine personnalisé de la boutique ;
5. remplissez les deux clés et cliquez sur Enregistrer et activer ;
6. cliquez sur Connecter le compte et approuvez l’installation sur la boutique.

Meta (Facebook/Instagram)

Champs de la carte : App ID et App Secret.

L’app peut lister les Pages Facebook que vous administrez et lire les publications d’une page. L’accès demandé consiste à voir la liste des pages, lire leur engagement et gérer l’entreprise.

1. sur developers.facebook.com, créez une app (ce peut être la même que pour WhatsApp) ;
2. ajoutez le produit Facebook Login à l’app ;
3. dans Paramètres → Général, copiez l’App ID et l’App Secret ;
4. dans l’éditeur de l’app, onglet Intégrations, catégorie Réseaux sociaux, ouvrez la carte Meta (Facebook/Instagram) ;
5. collez les deux clés et cliquez sur Enregistrer et activer ;
6. cliquez sur Connecter le compte, connectez-vous avec le Facebook de la personne qui administre les pages et approuvez.

Tant que l’app Meta est en mode développement, seules les personnes qui ont un rôle dans l’app (administrateur, développeur, testeur) peuvent autoriser. Pour votre propre usage, cela suffit.

Google Workspace

Champs de la carte : Client ID et Client Secret.

La connexion permet à l’app d’utiliser Sheets, Calendar, Drive et Gmail avec un compte Google.

1. sur console.cloud.google.com, dans le projet que vous utilisez (ce peut être le même que pour Maps), allez dans API et services → Identifiants → Créer des identifiants → ID client OAuth, type Application Web ;
2. activez dans le projet les APIs que l’app utilisera (par exemple, Google Sheets API et Google Calendar API) ;
3. dans l’éditeur de l’app, onglet Intégrations, catégorie Productivité, ouvrez la carte Google Workspace, collez le Client ID et le Client Secret et cliquez sur Enregistrer et activer.

⚠️ Contrairement à Shopify et Meta, la carte Google Workspace n’a pas aujourd’hui de bouton Connecter le compte : elle conserve les clés, mais l’étape d’autorisation du compte Google n’y est pas disponible. Si votre app dépend de cette connexion, contactez le support avant de construire dessus.

N’utilisez pas ici l’URL de callback de la connexion avec Google, de l’onglet Authentification : elle appartient à une autre connexion.

Savoir que cela a fonctionné

• après Connecter le compte, la fenêtre du fournisseur affiche « Connecté ! Vous pouvez fermer cette fenêtre. » et se ferme toute seule ;
• la carte affiche « Intégration active. » et le badge Connectée. Attention : le badge apparaît dès l’enregistrement des clés, avant l’autorisation. À lui seul, il ne prouve pas que le compte a été connecté ;
• la preuve finale, c’est l’app qui affiche les données : demandez dans le chat, par exemple, « liste les produits de ma boutique Shopify ».

Révoquer l’accès

Deux côtés, et il vaut mieux faire les deux :

1. sur la plateforme : ouvrez la carte et cliquez sur Déconnecter. Les clés et l’accès autorisé sont effacés ici ;
2. chez le fournisseur : retirez l’autorisation de son côté, pour que l’accès disparaisse pour de bon. Sur Shopify, désinstallez l’app dans les paramètres d’apps de la boutique. Sur Facebook, retirez l’app dans les intégrations professionnelles de votre compte.

Problèmes courants

• La fenêtre du fournisseur affiche une erreur sur l’adresse de redirection. Le fournisseur exige que l’adresse de retour soit enregistrée dans l’app que vous avez créée, et cette adresse n’apparaît pas sur la carte aujourd’hui. Contactez le support pour obtenir l’adresse de retour de votre projet et enregistrez-la dans l’app du fournisseur ;
• La fenêtre se ferme avec « Échec : » suivi d’un motif. Le motif vient du fournisseur. Les plus courants : l’autorisation a été annulée, ou la clé secrète enregistrée n’est pas celle de l’app à laquelle vous vous êtes connecté ;
• « remplissez … avant de connecter ». Un champ enregistré manque. Sur Shopify, le Shop domain est aussi obligatoire ;
• « shop_domain doit être un domaine .myshopify.com valide ». Utilisez l’adresse votre-boutique.myshopify.com ;
• Sur Meta, personne d’autre que moi ne peut autoriser. L’app Meta est en mode développement.