Elido gebruiken in zelf-gehoste n8n

n8n is een zelf-gehoste tool voor workflowautomatisering. De community-node van Elido geeft je native acties binnen de visuele editor van n8n, zodat je geen HTTP Request-nodes handmatig hoeft te bouwen tegen de Elido API.

Vereisten

• Zelf-gehoste n8n met community-nodes ingeschakeld. Cloud-n8n-abonnementen kunnen community-nodes beperken; controleer je abonnement.
• Een Elido-workspace-API-sleutel.

Stap 1 - De community-node installeren

1. Ga in n8n naar Settings → Community Nodes.
2. Klik op Install a community node.
3. Plak de pakketnaam:

   n8n-nodes-elido
   

4. Ga akkoord met de risicomelding en klik op Install.
5. Zoek naar "Elido" in de node-kiezer. De Elido-node verschijnt met de Link-resource.

Stap 2 - Een Elido API-sleutel aanmaken

1. Ga in Elido naar Settings → API keys → New key.
2. Kies een rol voor de sleutel. Editor kan links aanmaken en analyses lezen; Viewer kan alleen links en analyses lezen. Een sleutel hoort bij de workspace waarin je hem aanmaakt en kan niets doen in een andere workspace.
3. Kopieer de sleutel. Deze begint met elido_ en wordt maar één keer getoond.

Scopes per token (links:write, analytics:read enzovoort) staan gepland; vandaag bepaalt de rol wat een sleutel mag doen.

Stap 3 - Elido-credentials toevoegen in n8n

1. Ga in n8n naar Credentials → New Credential → Elido API.
2. Base URL: laat https://api.elido.app staan voor Elido Cloud, of vul de root van je zelf-gehoste API in.
3. API Token: plak de elido_-sleutel.
4. Workspace ID: het numerieke ID van de workspace waar de sleutel bij hoort (Settings → Workspace). De node gebruikt dit voor analyses.
5. Klik op Save. n8n test de credential door die workspace uit te lezen, dus een verkeerde sleutel, een verkeerde base-URL of een sleutel uit een andere workspace faalt hier al, in plaats van pas in een draaiende workflow.

Maak per Elido-workspace een eigen credential aan en kies in elke node de juiste.

Beschikbare acties

Actie	Wat het doet
Create	Verkort een bestemmings-URL. Optioneel: slug, titel, tags, vervaldatum, redirectstatus en domein-ID
Get	Geeft één link terug op basis van het ID
List	Geeft maximaal 100 links terug, nieuwste eerst, gefilterd op zoektekst, tags of status (actief/uitgeschakeld)
Get Analytics	Geeft klikken over tijd, of klikken per land, referrer, apparaat of browser, voor één link

Create zonder Domain ID plaatst de link op het standaard Elido-domein van je workspace. Voor een aangepast domein geef je het ID mee vanuit Settings → Domains.

List en Get Analytics geven één n8n-item per rij terug, dus de volgende node draait één keer per link, of één keer per dag, land, referrer enzovoort. Get Analytics gebruikt standaard de laatste 30 dagen; stel From en To (YYYY-MM-DD) in om de periode te wijzigen.

Update Link en Look Up Link op slug staan gepland als acties. Tot ze beschikbaar zijn, roep je PATCH /v1/links/{id} of GET /v1/links?q=<slug> aan vanuit een HTTP Request-node met dezelfde credential.

Triggers

Een speciale node Elido Trigger staat gepland. Tot die beschikbaar is, gebruik je de ingebouwde Webhook-trigger van n8n met een Elido-webhookendpoint:

1. Voeg een Webhook-node toe (methode POST) en kopieer de productie-URL.
2. Ga in Elido naar Settings → Webhooks → New endpoint, plak de URL en kies de gebeurtenissen: link.created, link.updated, link.deleted, link.expired, link.cap_reached of link.broken.
3. Kopieer het ondertekeningsgeheim. Elke aflevering bevat een header X-Elido-Signature: v1=<hex>, een HMAC-SHA256 van {timestamp}.{raw body} met dat geheim, waarbij de timestamp de Unix-secondenwaarde uit X-Webhook-Timestamp is; controleer dit in een Code-node voordat je de payload vertrouwt. De webhookshandleiding bevat het verificatiefragment.

Trigger	Status
Link aangemaakt, bijgewerkt, verwijderd, verlopen, kapot, kliklimiet bereikt	Vandaag beschikbaar via de Webhook-node
Link Clicked	Gepland. Vereist de webhookgebeurtenis click.created, die nog niet wordt verstuurd
Conversion Recorded	Gepland, na de conversions-API
Threshold Exceeded	Gepland

Voorbeeldworkflow - dagelijks klikrapport naar een spreadsheet

[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 }}

Voorbeeldworkflow - een link aanmaken vanuit een webhook

Een extern systeem stuurt via POST een URL naar n8n, n8n verkort deze met Elido en geeft de korte URL terug.

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

Probleemoplossing

Community-node verschijnt niet na installatie - herlaad de editor. Als hij nog steeds ontbreekt, herstart n8n; in Docker:

docker restart n8n

De credentialtest faalt met 404 of 403 - het Workspace ID komt niet overeen met de workspace waarin de sleutel is aangemaakt, of de sleutel is ingetrokken. Controleer beide in Elido's Settings → API keys.

Create faalt met "domain_id" - het Domain ID is geen domein van deze workspace. Laat het leeg om het standaarddomein te gebruiken.

Get Analytics geeft niets terug - de link heeft geen klikken in de gekozen periode, of het Link ID hoort bij een andere workspace. Verruim eerst From en To.

Webhook-URL geweigerd door Elido - de webhook-URL van n8n moet bereikbaar zijn vanaf internet. Als je n8n op een lokale machine of een privénetwerk draait, zet dan een tunnel op (bijvoorbeeld Cloudflare Tunnel of ngrok) en wijs de omgevingsvariabele WEBHOOK_URL van n8n naar het tunneladres.