Comment configurer n8n : Guide pratique

En bref

• Auto-hébergez n8n en 2 minutes avec Docker : docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n
• Créez votre premier workflow en 5 minutes : HTTP Request → OpenAI → Slack
• Utilisez les nœuds d'IA (OpenAI/Anthropic) pour automatiser des tâches comme le résumé des tickets de support
• Planifiez des workflows avec des déclencheurs cron (par exemple, 0 9 * * * pour une exécution quotidienne à 9h)
• Sécurisez les identifiants avec des variables d'environnement (fichier .env)

1. Auto-hébergement avec Docker

1.1 Installer Docker

Si Docker n'est pas installé, exécutez :

# Linux/macOS
curl -fsSL https://get.docker.com | sh

# Windows (PowerShell)
winget install Docker.DockerDesktop

1.2 Lancer n8n

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Sortie attendue :

n8n ready on 0.0.0.0, port 5678
Version: 1.40.0
Editor is now accessible via: http://localhost:5678

Points d'attention :

• Conflit de port ? Changez -p 5678:5678 en -p 5679:5678 si le port 5678 est déjà utilisé.
• Erreurs de permission ? Ajoutez -e N8N_USER=node pour exécuter en tant qu'utilisateur non-root.

1.3 Persister les données

Ajoutez un volume pour sauvegarder les workflows et les identifiants :

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

2. Votre premier workflow

2.1 Accéder à l'éditeur

Ouvrez http://localhost:5678 dans votre navigateur. Vous verrez l'éditeur de workflow visuel.

2.2 Créer un workflow « Hello World »

1. Cliquez sur + Nouveau workflow.
2. Glissez-déposez un nœud HTTP Request depuis le panneau de gauche.
3. Configurez-le :
   • Méthode : GET
   • URL : https://api.github.com/users/n8n-io
4. Cliquez sur Exécuter le nœud pour tester. Vous verrez la réponse de l'API GitHub.

Sortie attendue (tronquée) :

{
  "login": "n8n-io",
  "id": 45487711,
  "node_id": "MDEyOk9yZ2FuaXphdGlvbjQ1NDg3NzEx",
  ...
}

3. Nœuds d'agent IA (OpenAI/Anthropic)

3.1 Ajouter un nœud OpenAI

1. Glissez-déposez un nœud OpenAI dans votre workflow.
2. Cliquez sur Connecter un compte et entrez votre clé API OpenAI (obtenez-la ici).
3. Configurez le nœud :
   • Ressource : Chat
   • Opération : Create Chat Completion
   • Modèle : gpt-4o-mini
   • Prompt : Résumez ces données utilisateur GitHub : {{ $json }}

3.2 Connecter les nœuds

1. Connectez la sortie du nœud HTTP Request à l'entrée du nœud OpenAI.
2. Exécutez le workflow. Le nœud OpenAI résumera les données GitHub.

Exemple de sortie :

L'utilisateur GitHub "n8n-io" est un compte organisation avec l'ID 45487711. Il a été créé pour héberger le projet n8n, un outil d'automatisation de workflow open-source.

Points d'attention :

• Limites de l'API ? Utilisez gpt-4o-mini pour réduire les coûts.
• Limites de débit ? Ajoutez un nœud Wait (par exemple, un délai d'1 seconde) entre les requêtes.

4. Nœuds HTTP Request et Webhook

4.1 Nœud HTTP Request

Utilisez ce nœud pour appeler n'importe quelle API. Exemple : récupérer des données météo depuis OpenWeatherMap.

1. Ajoutez un nœud HTTP Request.
2. Configurez :
   • Méthode : GET
   • URL : https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_API_KEY
   • Paramètres de requête :

     {
       "q": "London",
       "appid": "YOUR_API_KEY"
     }
     

     Copy

4.2 Nœud Webhook

Déclenchez des workflows via HTTP. Exemple : commande slash Slack.

1. Ajoutez un nœud Webhook.
2. Configurez :
   • Chemin : slack-command
   • Méthode HTTP : POST
3. Cliquez sur URLs de webhook pour copier l'URL (par exemple, http://localhost:5678/webhook/slack-command).
4. Ajoutez un nœud Slack pour envoyer une réponse.

Tester le webhook :

curl -X POST http://localhost:5678/webhook/slack-command \
  -H "Content-Type: application/json" \
  -d '{"text": "Bonjour depuis Slack !"}'

5. Planification et déclencheurs Cron

5.1 Ajouter un déclencheur Cron

1. Glissez-déposez un nœud Cron dans votre workflow.
2. Configurez :
   • Déclencher : Toutes les minutes (ou utilisez une syntaxe cron, par exemple, 0 9 * * * pour une exécution quotidienne à 9h).
3. Connectez-le à un nœud HTTP Request pour récupérer des données quotidiennement.

Exemples d'expressions cron :

5.2 Déclencheurs manuels

Utilisez le nœud Manual Trigger pour exécuter des workflows à la demande.

6. Variables d'environnement et identifiants

6.1 Utiliser un fichier .env

Créez un fichier .env :

echo "N8N_BASIC_AUTH_USER=admin" >> .env
echo "N8N_BASIC_AUTH_PASSWORD=securepassword" >> .env
echo "OPENAI_API_KEY=sk-your-key" >> .env

Redémarrez n8n avec le fichier .env :

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  --env-file .env \
  n8nio/n8n

6.2 Sécuriser les identifiants

1. Dans l'éditeur n8n, allez dans Credentials → Ajouter un identifiant.
2. Sélectionnez OpenAI et entrez votre clé API.
3. Utilisez cet identifiant dans n'importe quel nœud OpenAI (pas besoin de coder en dur les clés).

Points d'attention :

• Ne jamais commiter le fichier .env dans Git ! Ajoutez-le à .gitignore.
• Faites tourner les clés régulièrement (par exemple, tous les 90 jours).

7. Conseils pour la production et sauvegardes

7.1 Utiliser PostgreSQL (pas SQLite)

Pour la production, remplacez SQLite par PostgreSQL :

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_DATABASE=n8n \
  -e DB_POSTGRESDB_HOST=postgres \
  -e DB_POSTGRESDB_PORT=5432 \
  -e DB_POSTGRESDB_USER=n8n \
  -e DB_POSTGRESDB_PASSWORD=securepassword \
  n8nio/n8n

7.2 Activer HTTPS

Utilisez un reverse proxy comme Nginx ou Caddy :

# Exemple avec Caddy
echo "localhost:5678 {
  reverse_proxy n8n:5678
}" > Caddyfile
docker run -d --name caddy -p 80:80 -p 443:443 -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile caddy

7.3 Sauvegarder les workflows

Exportez les workflows via l'API :

curl http://localhost:5678/rest/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o workflows_backup.json

Restaurer les workflows :

curl -X POST http://localhost:5678/rest/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @workflows_backup.json

7.4 Surveiller les workflows

• Utilisez la Liste d'exécutions dans l'interface utilisateur de n8n pour déboguer les workflows en échec.
• Activez les Workflows d'erreur pour envoyer des alertes Slack en cas d'échec.

Alternatives à n8n

Prochaines étapes

1. Créez un workflow réel : Automatisez une tâche comme le résumé des messages Slack avec OpenAI.
2. Déployez en production : Utilisez Kubernetes ou n8n.cloud pour la scalabilité.
3. Explorez les fonctionnalités d'IA : Essayez le générateur de workflows IA de n8n (bêta).

Besoin d'aide pour mettre à l'échelle vos workflows d'IA ? Hyperion Consulting se spécialise dans les outils d'IA et l'automatisation pour les entreprises. Visitez hyperion-consulting.io pour en savoir plus.