Elido in selbst gehostetem n8n verwenden

n8n ist ein selbst gehostetes Workflow-Automatisierungstool. Der Elido-Community-Node gibt Ihnen native Trigger und Aktionen im visuellen Editor von n8n — keine HTTP-Request-Nodes erforderlich.

Anforderungen#

• n8n Version 0.220 oder höher (Community-Nodes erfordern dieses Minimum).
• Selbst gehostetes n8n mit aktivierter Community-Node-Installation. Cloud-n8n-Pläne können dies einschränken — überprüfen Sie Ihren Plan.
• Ein Elido-Workspace-API-Token.

Schritt 1 — Den Community-Node installieren#

1. Gehen Sie in n8n zu Einstellungen → Community-Nodes.
2. Klicken Sie auf Einen Community-Node installieren.
3. Fügen Sie den Paketnamen ein:

   @elidoapp/n8n-nodes-elido
   

4. Stimmen Sie dem Risikohinweis zu und klicken Sie auf Installieren.
5. n8n startet neu. Nach dem Neustart suchen Sie im Node-Picker nach "Elido" — Sie sollten die Elido-Trigger- und Action-Nodes sehen.

Schritt 2 — Einen Elido-API-Token generieren#

1. Gehen Sie in Elido zu Dashboard → API-Keys → Neuer Key.
2. Wählen Sie Scopes basierend auf dem, was Ihr Workflow benötigt:
   • links:read — Links nachschlagen, auflisten.
   • links:write — Links erstellen und aktualisieren.
   • analytics:read — Klickzahlen und Analytics lesen.
3. Kopieren Sie den Token. Er beginnt mit ek_.

Schritt 3 — Elido-Credentials in n8n hinzufügen#

1. Gehen Sie in n8n zu Credentials → Neue Credential → Elido API.
2. Fügen Sie den Token in das Feld API-Token ein.
3. Der Workspace wird automatisch aus dem Token erkannt. Klicken Sie auf Speichern.

Sie können mehrere Credentials erstellen (eine pro Elido-Workspace) und in einzelnen Nodes darauf verweisen.

Verfügbare Trigger#

Trigger	Wann er ausgelöst wird
Link geklickt	Bei jedem Klick auf einen Link im Workspace (oder gefiltert nach Tag/Slug)
Konversion erfasst	Jedes Mal, wenn eine Konversion erfasst wird
Schwelle überschritten	Wenn die Klickanzahl eines Links die konfigurierte Zahl überschreitet

Trigger verwenden Elidos Webhook-System im Hintergrund. n8n registriert die Webhook-URL automatisch, wenn Sie den Workflow aktivieren.

Verfügbare Aktionen#

Aktion	Was sie tut
Link erstellen	Erstellt einen neuen Kurzlink
Link aktualisieren	Aktualisiert Ziel-URL, Slug, Tags oder Ablauf
Links auflisten	Gibt eine paginierte Liste von Links mit Filtern zurück
Link nachschlagen	Findet einen Link nach Slug oder ID
Analytics abrufen	Gibt Klickanzahl und Aufschlüsselung für einen Link zurück

Beispiel-Workflow — Klicks in Baserow protokollieren#

Dieser Workflow wird bei jedem Klick ausgelöst und schreibt eine Zeile in eine Baserow-Tabelle (eine selbst gehostete Airtable-Alternative, die in n8n-Setups verbreitet ist).

[Elido-Trigger: Link geklickt]
      ↓
[Baserow: Zeile erstellen]
  - Tabelle: "Klick-Protokoll"
  - Slug: {{ $json.slug }}
  - Land: {{ $json.country }}
  - Gerät: {{ $json.device }}
  - Geklickt am: {{ $json.clicked_at }}

Einrichten:

1. Ziehen Sie den Elido-Trigger auf die Canvas. Credential auswählen. Trigger-Typ auf "Link geklickt" setzen.
2. Ziehen Sie einen Baserow-Node. Verbinden. Konfigurieren Sie Ihre Baserow-Basis und Tabelle.
3. Ordnen Sie die Felder wie oben gezeigt zu.
4. Klicken Sie auf Workflow aktivieren.

Beispiel-Workflow — Link von einem Webhook erstellen#

Ein einfacheres Muster: Ein externes System POSTet eine URL an n8n, n8n kürzt sie mit Elido und gibt die Kurz-URL zurück.

[Webhook-Node: POST /shorten]
      ↓
[Elido-Aktion: Link erstellen]
  - Ziel-URL: {{ $json.body.url }}
  - Tag: {{ $json.body.tag }}
      ↓
[Auf Webhook antworten]
  - Body: { "short_url": "{{ $json.short_url }}" }

Fehlerbehebung#

Community-Node erscheint nach der Installation nicht — n8n benötigt einen vollständigen Neustart nach der Installation von Community-Nodes. Wenn Sie n8n in Docker ausführen, starten Sie den Container neu: docker restart n8n.

"Ungültige Credentials" beim Testen eines Nodes — Der API-Token ist falsch oder hat den falschen Scope. Generieren Sie einen Token mit den Scopes, die Ihr Workflow benötigt, und aktualisieren Sie die n8n-Credential.

Trigger wird nicht ausgelöst — Überprüfen Sie, ob der Workflow aktiv ist (der Umschalter oben rechts im Workflow-Editor). Inaktive Workflows registrieren keine Webhooks, daher sendet Elido keine Ereignisse.

Webhook-URL von Elido abgelehnt — n8ns Webhook-URL muss aus dem Internet erreichbar sein (oder von Elidos Servern). Wenn Sie n8n auf einem lokalen Computer oder einem privaten Netzwerk betreiben, richten Sie einen Tunnel ein (z. B. Cloudflare Tunnel, ngrok) und konfigurieren Sie WEBHOOK_URL in n8ns Umgebungsvariablen so, dass er auf die Tunnel-Adresse zeigt.