Elido in selbst gehostetem n8n verwenden

n8n ist ein selbst gehostetes Workflow-Automatisierungstool. Der Elido-Community-Node gibt Ihnen native Aktionen im visuellen Editor von n8n, sodass Sie keine HTTP-Request-Nodes von Hand gegen die Elido-API bauen müssen.

Anforderungen

• Selbst gehostetes n8n mit aktivierten Community-Nodes. Cloud-n8n-Pläne können Community-Nodes einschränken; prüfen Sie Ihren Plan.
• Ein Elido-Workspace-API-Key.

Schritt 1 - Den Community-Node installieren

1. Gehen Sie in n8n zu Settings → Community Nodes.
2. Klicken Sie auf Install a community node.
3. Fügen Sie den Paketnamen ein:

   n8n-nodes-elido
   

4. Stimmen Sie dem Risikohinweis zu und klicken Sie auf Install.
5. Suchen Sie im Node-Picker nach "Elido". Der Elido-Node erscheint mit der Ressource Link.

Schritt 2 - Einen Elido-API-Key erstellen

1. Gehen Sie in Elido zu Settings → API keys → New key.
2. Wählen Sie eine Rolle für den Key. Editor kann Links erstellen und Analytics lesen; Viewer kann nur Links und Analytics lesen. Ein Key gehört zu dem Workspace, in dem Sie ihn erstellen, und kann auf keinem anderen Workspace agieren.
3. Kopieren Sie den Key. Er beginnt mit elido_ und wird nur einmal angezeigt.

Tokens pro Scope (links:write, analytics:read und so weiter) sind geplant; heute bestimmt die Rolle, was ein Key darf.

Schritt 3 - Elido-Credentials in n8n hinzufügen

1. Gehen Sie in n8n zu Credentials → New Credential → Elido API.
2. Base URL: Lassen Sie https://api.elido.app für Elido Cloud stehen, oder geben Sie Ihre selbst gehostete API-Root-URL ein.
3. API Token: Fügen Sie den elido_-Key ein.
4. Workspace ID: die numerische ID des Workspace, zu dem der Key gehört (Settings → Workspace). Der Node nutzt sie für Analytics.
5. Klicken Sie auf Save. n8n testet die Credential, indem es diesen Workspace liest, sodass ein falscher Key, eine falsche Base URL oder ein Key aus einem anderen Workspace hier fehlschlägt statt in einem laufenden Workflow.

Erstellen Sie eine Credential pro Elido-Workspace und wählen Sie in jedem Node die richtige aus.

Verfügbare Aktionen

Aktion	Was sie tut
Create	Kürzt eine Ziel-URL. Optional Slug, Titel, Tags, Ablauf, Redirect-Status und Domain-ID
Get	Gibt einen Link anhand seiner ID zurück
List	Gibt bis zu 100 Links zurück, neueste zuerst, gefiltert nach Suchtext, Tags oder Status (aktiv/deaktiviert)
Get Analytics	Gibt Klicks über die Zeit oder Klicks nach Land, Referrer, Gerät oder Browser für einen Link zurück

Create ohne Domain ID legt den Link auf der Standard-Elido-Domain Ihres Workspace ab. Um eine Custom Domain zu nutzen, übergeben Sie deren ID aus Settings → Domains.

List und Get Analytics geben pro Zeile ein n8n-Item zurück, sodass der nächste Node einmal pro Link oder einmal pro Tag, Land, Referrer und so weiter läuft. Get Analytics nutzt standardmäßig die letzten 30 Tage; setzen Sie From und To (JJJJ-MM-TT), um das Zeitfenster zu ändern.

Update Link und Look Up Link by slug sind geplante Aktionen. Bis sie verfügbar sind, rufen Sie PATCH /v1/links/{id} oder GET /v1/links?q=<slug> über einen HTTP-Request-Node mit derselben Credential auf.

Trigger

Ein dedizierter Elido Trigger-Node ist geplant. Bis er verfügbar ist, nutzen Sie n8ns eingebauten Webhook-Trigger mit einem Elido-Webhook-Endpunkt:

1. Fügen Sie einen Webhook-Node hinzu (Methode POST) und kopieren Sie seine Produktions-URL.
2. Gehen Sie in Elido zu Settings → Webhooks → New endpoint, fügen Sie die URL ein und wählen Sie die Ereignisse: link.created, link.updated, link.deleted, link.expired, link.cap_reached oder link.broken.
3. Kopieren Sie das Signing Secret. Jede Zustellung trägt einen Header X-Elido-Signature: v1=<hex>, einen HMAC-SHA256 von {timestamp}.{raw body} mit diesem Secret, wobei der Timestamp der Unix-Sekunden-Wert in X-Webhook-Timestamp ist; verifizieren Sie ihn in einem Code-Node, bevor Sie dem Payload vertrauen. Der Webhooks-Leitfaden enthält das Verifizierungs-Snippet.

Trigger	Status
Link erstellt, aktualisiert, gelöscht, abgelaufen, broken, Klick-Cap erreicht	Heute über den Webhook-Node verfügbar
Link Clicked	Geplant. Benötigt das Webhook-Ereignis click.created, das noch nicht ausgelöst wird
Conversion Recorded	Geplant, nach der Conversions-API
Threshold Exceeded	Geplant

Beispiel-Workflow - täglicher Klickbericht in eine Tabelle

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

Beispiel-Workflow - Link von einem Webhook erstellen

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: Create]
  - Destination URL: {{ $json.body.url }}
  - Tags: {{ $json.body.tag }}
      ↓
[Respond to Webhook]
  - Body: { "short_url": "{{ $json.short_url }}" }

Fehlerbehebung

Community-Node erscheint nach der Installation nicht - laden Sie den Editor neu. Fehlt er weiterhin, starten Sie n8n neu; in Docker:

docker restart n8n

Der Credential-Test schlägt mit 404 oder 403 fehl - die Workspace ID passt nicht zu dem Workspace, in dem der Key erstellt wurde, oder der Key wurde widerrufen. Prüfen Sie beides in Elidos Settings → API keys.

Create schlägt mit "domain_id" fehl - die Domain ID ist keine Domain dieses Workspace. Lassen Sie das Feld leer, um die Standard-Domain zu nutzen.

Get Analytics liefert nichts zurück - der Link hat im gewählten Zeitfenster keine Klicks, oder die Link ID gehört zu einem anderen Workspace. Erweitern Sie zuerst From und To.

Webhook-URL von Elido abgelehnt - die Webhook-URL von n8n muss aus dem Internet erreichbar sein. Wenn Sie n8n auf einem lokalen Rechner oder in einem privaten Netzwerk betreiben, richten Sie einen Tunnel ein (zum Beispiel Cloudflare Tunnel oder ngrok) und richten Sie die Umgebungsvariable WEBHOOK_URL von n8n auf die Tunnel-Adresse aus.