Configuration de la connexion BigCommerce
Ce guide vous explique comment créer un compte d'API au niveau de la boutique (store-level API account) dans BigCommerce et connecter votre boutique à LinkyFlow pour charger et gérer votre catalogue, vos commandes, vos clients et votre stock dans Excel ou dans l'application web.
Prérequis
- Une boutique BigCommerce
- Un accès à son panneau de contrôle, avec le droit de créer des comptes d'API
Étape 1 — Créer un compte d'API et copier ses identifiants
- Dans le panneau de contrôle BigCommerce, allez dans Settings → API → Store-level API accounts.
- Cliquez sur Create API account et choisissez le type V2/V3 API token. Donnez-lui un nom (par exemple
LinkyFlow). - Sous OAuth scopes, accordez les scopes que LinkyFlow doit utiliser — chacun est facultatif, et LinkyFlow utilise ceux que vous donnez : Products (le catalogue, les marques et les catégories), Orders (les commandes, leurs lignes, adresses, expéditions, coupons, remboursements et statuts), Order transactions en read-only (les paiements enregistrés sur une commande), Customers (les clients, leurs adresses et leurs groupes), Store inventory et Store locations (les niveaux de stock et les emplacements), Marketing (les coupons et les promotions) et Information & settings en read-only (les informations de la boutique, et le nom de la connexion). Réglez un scope sur modify pour écrire par lui — modify sur Store inventory pour fixer le stock — ou sur read-only pour seulement lire. Les autres scopes peuvent rester sur None.
- Cliquez sur Save. BigCommerce n'affiche l'Access token qu'une seule fois : copiez-le maintenant, avec l'API path affiché à côté. L'API path ressemble à
https://api.bigcommerce.com/stores/abc123/v3/.
Étape 2 — Ajouter la connexion dans LinkyFlow
- Dans Excel ou l'application web, ouvrez Connexions → Ajouter une connexion.
- Choisissez BigCommerce dans la liste des fournisseurs.
- Collez l'API Path et l'Access Token. L'API path doit être celui qu'affiche BigCommerce —
https://api.bigcommerce.com/stores/<store hash>, suivi de la version d'API (/v3/) ou de rien ; toute autre adresse est refusée, avec la raison. - Enregistrez. Sauf si vous avez saisi un alias vous-même, la connexion prend le nom de votre boutique — son nom quand le compte a Information & settings, son store hash sinon.
À l'enregistrement ou à la synchronisation de la connexion, LinkyFlow vérifie le jeton par une lecture légère de chacun de ces éléments : vos produits, vos commandes, vos clients, vos emplacements de stock et les informations de la boutique. Si BigCommerce refuse le jeton, la connexion vous demande de vous reconnecter avec un jeton valide ; si aucune boutique ne répond à l'API path, elle vous demande de le recopier. Un scope que le compte n'a pas est affiché comme non accordé, et les autres continuent de fonctionner ; un compte qui n'en a aucun est refusé. Remplacer l'API path par celui d'une autre boutique fait vérifier la connexion à nouveau.
Étape 3 — Charger votre première requête
- Insérez une requête LinkyFlow et choisissez le fournisseur BigCommerce.
- Choisissez Products, sélectionnez votre connexion dans le champ Link, puis exécutez-la — les 100 premiers produits se chargent par défaut.
- Utilisez Per page (jusqu'à 250) et les flèches pour naviguer, ou choisissez Tous les résultats pour lire toutes les pages.
LinkyFlow conserve l'access token côté serveur : il n'est plus jamais affiché, ni envoyé à un assistant IA.