Passer au contenu principal
Ce guide vous accompagne dans l’installation du node communautaire Chariow sur une instance n8n auto-hébergée et sa connexion à votre boutique.

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ètresClés API dans votre Tableau de bord Chariow
  • Node.js >= 18.10 sur la machine exécutant n8n

Installation

Le node Chariow n’est pas encore disponible via l’interface Community Nodes de n8n. Vous devez l’installer manuellement en utilisant l’une des méthodes ci-dessous.

npm (recommandé)

Exécutez la commande suivante dans votre répertoire utilisateur n8n :
cd ~/.n8n && npm install @chariow/n8n-nodes-chariow
Puis redémarrez n8n pour que le node apparaisse.

Docker

Si vous exécutez n8n dans Docker, définissez la variable d’environnement N8N_CUSTOM_EXTENSIONS pour installer le package au démarrage :
# docker-compose.yml
services:
  n8n:
    image: n8nio/n8n
    environment:
      - N8N_CUSTOM_EXTENSIONS=@chariow/n8n-nodes-chariow
    # ... votre autre configuration
Redémarrez le conteneur après avoir mis à jour la configuration.
Le support via l’interface Community Nodes est prévu. Une fois disponible, vous pourrez installer directement depuis ParamètresCommunity Nodes dans n8n.

Configurer les identifiants

1

Ouvrir les identifiants

Dans n8n, allez dans SettingsCredentialsAdd 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

  • Assurez-vous d’avoir installé le package dans le bon répertoire (~/.n8n pour les installations npm)
  • Redémarrez n8n complètement après l’installation
  • Vérifiez les logs n8n pour toute erreur d’installation : docker logs n8n ou vérifiez la sortie de votre processus
  • Vérifiez que le package est installé : ls ~/.n8n/node_modules/@chariow
  • 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
  • Assurez-vous que votre instance n8n peut atteindre https://api.chariow.com (aucun pare-feu ou proxy bloquant)
  • Vérifiez que la variable d’environnement N8N_CUSTOM_EXTENSIONS est 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