Utiliser Elido dans n8n auto-hébergé

n8n est un outil d'automatisation de workflow auto-hébergé. Le node communautaire Elido vous donne des déclencheurs et des actions natifs dans l'éditeur visuel de n8n — pas besoin de nodes HTTP Request.

Prérequis#

• n8n version 0.220 ou supérieure (les nodes communautaires nécessitent ce minimum).
• n8n auto-hébergé avec l'installation de nodes communautaires activée. Les plans cloud n8n peuvent restreindre cela — vérifiez votre plan.
• Un jeton API de workspace Elido.

Étape 1 — Installer le node communautaire#

1. Dans n8n, allez dans Paramètres → Nodes communautaires.
2. Cliquez sur Installer un node communautaire.
3. Collez le nom du package :

   @elidoapp/n8n-nodes-elido
   

4. Acceptez l'avis de risque et cliquez sur Installer.
5. n8n redémarre. Après le redémarrage, recherchez "Elido" dans le sélecteur de nodes — vous devriez voir les nodes de déclencheur et d'action Elido.

Étape 2 — Générer un jeton API Elido#

1. Dans Elido, allez dans Dashboard → Clés API → Nouvelle clé.
2. Choisissez les portées selon les besoins de votre workflow :
   • links:read — rechercher des liens, lister des liens.
   • links:write — créer et mettre à jour des liens.
   • analytics:read — lire les compteurs de clics et les analytics.
3. Copiez le jeton. Il commence par ek_.

Étape 3 — Ajouter les credentials Elido dans n8n#

1. Dans n8n, allez dans Credentials → Nouvelle Credential → Elido API.
2. Collez le jeton dans le champ Jeton API.
3. Le workspace est détecté automatiquement depuis le jeton. Cliquez sur Enregistrer.

Vous pouvez créer plusieurs credentials (une par workspace Elido) et les référencer dans des nodes individuels.

Déclencheurs disponibles#

Déclencheur	Quand il se déclenche
Lien cliqué	À chaque clic sur un lien du workspace (ou filtré par tag/slug)
Conversion enregistrée	Chaque fois qu'une conversion est enregistrée
Seuil dépassé	Quand le compteur de clics d'un lien dépasse le nombre configuré

Les déclencheurs utilisent le système de webhook d'Elido en arrière-plan. n8n enregistre l'URL webhook automatiquement quand vous activez le workflow.

Actions disponibles#

Action	Ce qu'elle fait
Créer un lien	Crée un nouveau lien court
Mettre à jour un lien	Met à jour l'URL de destination, le slug, les tags ou l'expiration
Lister les liens	Retourne une liste paginée de liens avec des filtres
Rechercher un lien	Trouve un lien par slug ou ID
Obtenir les analytics	Retourne le compteur de clics et la décomposition pour un lien

Exemple de workflow — journaliser les clics dans Baserow#

Ce workflow se déclenche à chaque clic et écrit une ligne dans une table Baserow (une alternative Airtable auto-hébergée courante dans les configurations n8n).

[Déclencheur Elido : Lien cliqué]
      ↓
[Baserow : Créer une ligne]
  - Table : "Journal de clics"
  - Slug : {{ $json.slug }}
  - Pays : {{ $json.country }}
  - Appareil : {{ $json.device }}
  - Cliqué le : {{ $json.clicked_at }}

Pour le configurer :

1. Faites glisser le déclencheur Elido sur la toile. Sélectionnez le credential. Définissez le type de déclencheur sur "Lien cliqué".
2. Faites glisser un node Baserow. Connectez-le. Configurez votre base et table Baserow.
3. Mappez les champs comme indiqué ci-dessus.
4. Cliquez sur Activer le workflow.

Exemple de workflow — créer un lien depuis un webhook#

Un pattern plus simple : un système externe POSte une URL à n8n, n8n la raccourcit avec Elido et retourne l'URL courte.

[Node Webhook : POST /shorten]
      ↓
[Action Elido : Créer un lien]
  - URL de destination : {{ $json.body.url }}
  - Tag : {{ $json.body.tag }}
      ↓
[Répondre au Webhook]
  - Corps : { "short_url": "{{ $json.short_url }}" }

Résolution des problèmes#

Node communautaire n'apparaît pas après l'installation — n8n nécessite un redémarrage complet après l'installation de nodes communautaires. Si vous exécutez n8n dans Docker, redémarrez le conteneur : docker restart n8n.

"Credentials invalides" lors du test d'un node — Le jeton API est incorrect ou a une portée incorrecte. Régénérez un jeton avec les portées dont votre workflow a besoin et mettez à jour le credential n8n.

Déclencheur ne se déclenche pas — Vérifiez que le workflow est actif (le bouton en haut à droite de l'éditeur de workflow). Les workflows inactifs n'enregistrent pas les webhooks, donc Elido n'envoie jamais d'événements.

URL webhook rejetée par Elido — L'URL webhook de n8n doit être accessible depuis internet (ou depuis les serveurs d'Elido). Si vous exécutez n8n sur une machine locale ou un réseau privé, configurez un tunnel (ex. Cloudflare Tunnel, ngrok) et configurez WEBHOOK_URL dans les variables d'environnement de n8n pour pointer vers l'adresse du tunnel.