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 actions natives dans l'éditeur visuel de n8n, pour éviter de construire à la main des nodes HTTP Request contre l'API Elido.

Prérequis

• n8n auto-hébergé avec les nodes communautaires activés. Les plans cloud de n8n peuvent restreindre les nodes communautaires ; vérifiez votre plan.
• Une clé API de workspace Elido.

Étape 1 - Installer le node communautaire

1. Dans n8n, allez dans Settings → Community Nodes.
2. Cliquez sur Install a community node.
3. Collez le nom du package :

   n8n-nodes-elido
   

4. Acceptez l'avis de risque et cliquez sur Install.
5. Recherchez "Elido" dans le sélecteur de nodes. Le node Elido apparaît avec la ressource Link.

Étape 2 - Créer une clé API Elido

1. Dans Elido, allez dans Settings → API keys → New key.
2. Choisissez un rôle pour la clé. Editor peut créer des liens et lire les analytics ; Viewer peut seulement lire les liens et les analytics. Une clé appartient au workspace dans lequel vous la créez et ne peut agir sur aucun autre workspace.
3. Copiez la clé. Elle commence par elido_ et n'est affichée qu'une seule fois.

Des jetons par portée (links:write, analytics:read, etc.) sont prévus ; aujourd'hui, c'est le rôle qui détermine ce qu'une clé peut faire.

Étape 3 - Ajouter les credentials Elido dans n8n

1. Dans n8n, allez dans Credentials → New Credential → Elido API.
2. Base URL : laissez https://api.elido.app pour Elido Cloud, ou indiquez la racine de votre API auto-hébergée.
3. API Token : collez la clé elido_.
4. Workspace ID : l'ID numérique du workspace auquel appartient la clé (Settings → Workspace). Le node l'utilise pour les analytics.
5. Cliquez sur Save. n8n teste le credential en lisant ce workspace, donc une clé erronée, une mauvaise Base URL ou une clé d'un autre workspace échoue ici plutôt que dans un workflow en cours d'exécution.

Créez un credential par workspace Elido et choisissez le bon dans chaque node.

Actions disponibles

Action	Ce qu'elle fait
Create	Raccourcit une URL de destination. Slug, titre, tags, expiration, statut de redirection et ID de domaine optionnels
Get	Retourne un lien à partir de son ID
List	Retourne jusqu'à 100 liens, les plus récents en premier, filtrés par texte de recherche, tags ou statut (actif/désactivé)
Get Analytics	Retourne les clics dans le temps, ou les clics par pays, referrer, appareil ou navigateur, pour un lien

Create sans Domain ID place le lien sur le domaine Elido par défaut de votre workspace. Pour utiliser un domaine personnalisé, transmettez son ID depuis Settings → Domains.

List et Get Analytics retournent un item n8n par ligne, donc le node suivant s'exécute une fois par lien ou une fois par jour, pays, referrer, etc. Get Analytics utilise par défaut les 30 derniers jours ; définissez From et To (AAAA-MM-JJ) pour changer la période.

Update Link et Look Up Link by slug sont des actions prévues. En attendant, appelez PATCH /v1/links/{id} ou GET /v1/links?q=<slug> depuis un node HTTP Request avec le même credential.

Déclencheurs

Un node dédié Elido Trigger est prévu. En attendant, utilisez le déclencheur Webhook intégré à n8n avec un endpoint webhook Elido :

1. Ajoutez un node Webhook (méthode POST) et copiez son URL de production.
2. Dans Elido, allez dans Settings → Webhooks → New endpoint, collez l'URL et choisissez les événements : link.created, link.updated, link.deleted, link.expired, link.cap_reached ou link.broken.
3. Copiez le signing secret. Chaque livraison porte un en-tête X-Elido-Signature: v1=<hex>, un HMAC-SHA256 de {timestamp}.{raw body} avec ce secret, où le timestamp est la valeur en secondes Unix de X-Webhook-Timestamp ; vérifiez-le dans un node Code avant de faire confiance à la charge utile. Le guide des webhooks contient l'extrait de vérification.

Déclencheur	Statut
Lien créé, mis à jour, supprimé, expiré, cassé, plafond de clics atteint	Disponible aujourd'hui via le node Webhook
Link Clicked	Prévu. Nécessite l'événement webhook click.created, qui n'est pas encore émis
Conversion Recorded	Prévu, après l'API de conversions
Threshold Exceeded	Prévu

Exemple de workflow - rapport de clics quotidien vers une feuille de calcul

[Schedule Trigger: every day 08:00]
      ↓
[Elido: Get Analytics]
  - Link ID: 4711
  - Report: Clicks by Country
      ↓
[Google Sheets: Append Row]
  - Country: {{ $json.key }}
  - Clicks: {{ $json.count }}

Exemple de workflow - créer un lien depuis un webhook

Un système externe envoie une URL en POST à n8n, n8n la raccourcit avec Elido et retourne l'URL courte.

[Webhook node: POST /shorten]
      ↓
[Elido: Create]
  - Destination URL: {{ $json.body.url }}
  - Tags: {{ $json.body.tag }}
      ↓
[Respond to Webhook]
  - Body: { "short_url": "{{ $json.short_url }}" }

Résolution des problèmes

Le node communautaire n'apparaît pas après l'installation - rechargez l'éditeur. S'il manque toujours, redémarrez n8n ; sous Docker :

docker restart n8n

Le test du credential échoue avec 404 ou 403 - le Workspace ID ne correspond pas au workspace dans lequel la clé a été créée, ou la clé a été révoquée. Vérifiez les deux dans Settings → API keys d'Elido.

Create échoue avec "domain_id" - le Domain ID n'est pas un domaine de ce workspace. Laissez-le vide pour utiliser le domaine par défaut.

Get Analytics ne retourne rien - le lien n'a pas de clics dans la période, ou le Link ID appartient à un autre workspace. Élargissez d'abord From et To.

URL webhook rejetée par Elido - l'URL webhook de n8n doit être joignable depuis internet. Si vous exécutez n8n sur une machine locale ou un réseau privé, mettez en place un tunnel (par exemple Cloudflare Tunnel ou ngrok) et pointez la variable d'environnement WEBHOOK_URL de n8n vers l'adresse du tunnel.