Prérequis
Avant de commencer, assurez-vous d’avoir :- Une instance n8n auto-hébergée (v1.0 ou ultérieure)
- Une clé API Chariow (commence par
sk_) : générez-en une depuis Paramètres → Clés API dans votre Tableau de bord Chariow, avec les scopes dont vos workflows ont besoin. Le test de l’identifiant exige au moinsstore.read - Node.js >= 18.10 sur la machine exécutant n8n
Installation
npm (recommandé)
Exécutez la commande suivante dans votre répertoire utilisateur n8n :Docker
Si vous exécutez n8n dans Docker, définissez la variable d’environnementN8N_CUSTOM_EXTENSIONS pour installer le package au démarrage :
Le support via l’interface Community Nodes est prévu. Une fois disponible, vous pourrez installer directement depuis Paramètres → Community Nodes dans n8n.
Configurer les identifiants
1
Ouvrir les identifiants
Dans n8n, allez dans Settings → Credentials → Add Credential.
2
Rechercher Chariow
Recherchez Chariow API et sélectionnez-le.
3
Entrer votre clé API
Collez votre clé API Chariow (commence par
sk_) dans le champ API Key.4
Enregistrer
Cliquez sur Save. n8n testera la connexion automatiquement. Une coche verte confirme que votre clé est valide.
Vérifier l’installation
1
Créer un nouveau workflow
Cliquez sur New Workflow dans n8n.
2
Ajouter un node
Cliquez sur + pour ajouter un node et recherchez Chariow.
3
Confirmer que les deux nodes apparaissent
Vous devriez voir deux nodes :
- Chariow : pour effectuer des actions (obtenir, lister, créer)
- Chariow Trigger : pour démarrer des workflows à partir des événements de votre boutique
Dépannage
Les nodes n'apparaissent pas après l'installation
Les nodes n'apparaissent pas après l'installation
- Assurez-vous d’avoir installé le package dans le bon répertoire (
~/.n8npour les installations npm) - Redémarrez n8n complètement après l’installation
- Vérifiez les logs n8n pour toute erreur d’installation :
docker logs n8nou vérifiez la sortie de votre processus - Vérifiez que le package est installé :
ls ~/.n8n/node_modules/@chariow
Le test des identifiants a échoué
Le test des identifiants a échoué
- Confirmez que votre clé API commence par
sk_et est copiée en entier - Vérifiez que votre boutique est active dans le tableau de bord Chariow
- Le test appelle
GET /v1/store: vérifiez que la clé possède le scopestore.read - Assurez-vous que votre instance n8n peut atteindre
https://api.chariow.com(aucun pare-feu ou proxy bloquant)
Le node échoue avec une erreur 403
Le node échoue avec une erreur 403
La clé API ne possède pas le scope requis par cette opération. L’erreur liste les scopes manquants : ajoutez-les à la clé dans Paramètres → Clés API. Consultez les scopes requis pour la clé API.
Problèmes avec le conteneur Docker
Problèmes avec le conteneur Docker
- Vérifiez que la variable d’environnement
N8N_CUSTOM_EXTENSIONSest correctement définie - Reconstruisez et redémarrez le conteneur :
docker compose down && docker compose up -d - Vérifiez les logs du conteneur pour les erreurs d’installation npm :
docker logs <nom_du_conteneur>
Prochaines étapes
Ressources disponibles
Découvrez toutes les ressources et opérations
Événements déclencheurs
Parcourez les 8 événements déclencheurs disponibles