Elido gebruiken in zelf-gehoste n8n

n8n is een zelf-gehoste tool voor workflowautomatisering. De community-node van Elido geeft je native triggers en acties binnen de visuele editor van n8n — er zijn geen HTTP Request-nodes nodig.

Vereisten

• n8n-versie 0.220 of later (community-nodes vereisen dit minimum).
• Zelf-gehoste n8n met installatie van community-nodes ingeschakeld. Cloud-n8n-plannen kunnen dit beperken — controleer je plan.
• Een Elido-workspace API-token.

Stap 1 — De community-node installeren

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

   @elidoapp/n8n-nodes-elido
   

4. Ga akkoord met de risicomelding en klik op Install.
5. n8n start opnieuw op. Zoek na het herstarten naar "Elido" in de node-kiezer — je zou de trigger- en actienodes van Elido moeten zien.

Stap 2 — Een Elido API-token genereren

1. Ga in Elido naar Dashboard → API-sleutels → Nieuwe sleutel.
2. Kies scopes op basis van wat je workflow nodig heeft:
   • links:read — links opzoeken, links weergeven.
   • links:write — links aanmaken en bijwerken.
   • analytics:read — klikaantallen en analytics lezen.
3. Kopieer het token. Het begint met ek_.

Stap 3 — Elido-credentials toevoegen in n8n

1. Ga in n8n naar Credentials → New Credential → Elido API.
2. Plak het token in het veld API Token.
3. De workspace wordt automatisch herkend op basis van het token. Klik op Save.

Je kunt meerdere credentials aanmaken (één per Elido-workspace) en deze in afzonderlijke nodes gebruiken.

Beschikbare triggers

Trigger	Wanneer deze afgaat
Link Clicked	Bij elke klik op elke link in de workspace (of gefilterd op tag/slug)
Conversion Recorded	Telkens wanneer een conversie wordt geregistreerd
Threshold Exceeded	Wanneer het klikaantal van een link de ingestelde waarde overschrijdt

Triggers gebruiken onder de motorkap het webhooksysteem van Elido. n8n registreert de webhook-URL automatisch wanneer je de workflow activeert.

Beschikbare acties

Actie	Wat het doet
Create Link	Maakt een nieuwe korte link aan
Update Link	Werkt bestemmings-URL, slug, tags of verlooptermijn bij
List Links	Retourneert een gepagineerde lijst met links met filters
Look Up Link	Zoekt een link op basis van slug of ID
Get Analytics	Retourneert het klikaantal en de uitsplitsing voor een link

Voorbeeldworkflow — klikken loggen naar Baserow

Deze workflow gaat af bij elke klik en schrijft een rij naar een Baserow-tabel (een zelf-gehoste Airtable-alternatief dat vaak in n8n-installaties wordt gebruikt).

[Elido Trigger: Link Clicked]
      ↓
[Baserow: Create Row]
  - Table: "Click Log"
  - Slug: {{ $json.slug }}
  - Country: {{ $json.country }}
  - Device: {{ $json.device }}
  - Clicked At: {{ $json.clicked_at }}

Zo stel je dit in:

1. Sleep de Elido-trigger naar het canvas. Selecteer de credential. Stel het triggertype in op "Link Clicked".
2. Sleep een Baserow-node erbij. Verbind deze. Configureer je Baserow-basis en -tabel.
3. Koppel de velden zoals hierboven getoond.
4. Klik op Activate workflow.

Voorbeeldworkflow — een link aanmaken vanuit een webhook

Een eenvoudiger patroon: een extern systeem stuurt een URL via POST naar n8n, n8n kort deze in met Elido en retourneert de korte URL.

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

Probleemoplossing

Community-node verschijnt niet na installatie — n8n heeft een volledige herstart nodig na het installeren van community-nodes. Als je n8n in Docker draait, herstart dan de container:

docker restart n8n

"Invalid credentials" bij het testen van een node — Het API-token is onjuist of heeft de verkeerde scopes. Genereer een nieuw token met de scopes die je workflow nodig heeft en werk de n8n-credential bij.

Trigger gaat niet af — Controleer of de workflow actief is (de schakelaar rechtsboven in de workfloweditor). Inactieve workflows registreren geen webhooks, waardoor Elido nooit gebeurtenissen verstuurt.

Webhook-URL geweigerd door Elido — De webhook-URL van n8n moet bereikbaar zijn vanaf internet (of vanaf de servers van Elido). Als je n8n draait op een lokale machine of een privénetwerk, stel dan een tunnel in (bijv. Cloudflare Tunnel, ngrok) en configureer WEBHOOK_URL in de omgevingsvariabelen van n8n zodat het naar het tunneladres verwijst.