Folosiți Elido în n8n auto-găzduit

n8n este un instrument de automatizare a fluxurilor de lucru auto-găzduit. Nodul comunitar Elido vă oferă acțiuni native în editorul vizual al n8n, astfel încât nu mai trebuie să construiți manual noduri HTTP Request pentru API-ul Elido.

Cerințe

• n8n auto-găzduit cu nodurile comunitare activate. Planurile n8n Cloud pot restricționa nodurile comunitare; verificați planul dumneavoastră.
• O cheie API de workspace Elido.

Pasul 1 - Instalați nodul comunitar

1. În n8n, mergeți la Settings → Community Nodes.
2. Faceți clic pe Install a community node.
3. Lipiți numele pachetului:

   n8n-nodes-elido
   

4. Acceptați avertismentul de risc și faceți clic pe Install.
5. Căutați "Elido" în selectorul de noduri. Nodul Elido apare cu resursa Link.

Pasul 2 - Creați o cheie API Elido

1. În Elido, mergeți la Settings → API keys → New key.
2. Alegeți un rol pentru cheie. Editor poate crea linkuri și citi date de analiză; Viewer poate doar citi linkuri și date de analiză. O cheie aparține workspace-ului în care a fost creată și nu poate acționa asupra niciunui alt workspace.
3. Copiați cheia. Începe cu elido_ și este afișată o singură dată.

Tokenurile per-scope (links:write, analytics:read etc.) sunt planificate; în prezent, rolul stabilește ce poate face o cheie.

Pasul 3 - Adăugați acreditările Elido în n8n

1. În n8n, mergeți la Credentials → New Credential → Elido API.
2. Base URL: lăsați https://api.elido.app pentru Elido Cloud sau introduceți rădăcina API-ului dumneavoastră auto-găzduit.
3. API Token: lipiți cheia elido_.
4. Workspace ID: ID-ul numeric al workspace-ului căruia îi aparține cheia (Settings → Workspace). Nodul îl folosește pentru datele de analiză.
5. Faceți clic pe Save. n8n testează acreditarea citind acel workspace, astfel încât o cheie greșită, un Base URL greșit sau o cheie dintr-un alt workspace eșuează aici, nu într-un flux de lucru aflat în execuție.

Creați câte o acreditare pentru fiecare workspace Elido și alegeți-o pe cea potrivită în fiecare nod.

Acțiuni disponibile

Acțiune	Ce face
Create	Scurtează un URL de destinație. Slug, titlu, tag-uri, expirare, cod de stare pentru redirecționare și ID de domeniu opționale
Get	Returnează un link după ID-ul său
List	Returnează până la 100 de linkuri, cele mai noi primele, filtrate după text de căutare, tag-uri sau stare (activ/dezactivat)
Get Analytics	Returnează clicurile în timp, sau clicurile după țară, referrer, dispozitiv sau browser, pentru un link

Create fără un Domain ID plasează linkul pe domeniul implicit Elido al workspace-ului dumneavoastră. Pentru a folosi un domeniu personalizat, transmiteți ID-ul acestuia din Settings → Domains.

List și Get Analytics returnează câte un element n8n pentru fiecare rând, astfel încât următorul nod rulează o dată pentru fiecare link sau o dată pentru fiecare zi, țară, referrer etc. Get Analytics folosește implicit ultimele 30 de zile; setați From și To (YYYY-MM-DD) pentru a schimba intervalul.

Update Link și Look Up Link by slug sunt acțiuni planificate. Până la lansarea lor, apelați PATCH /v1/links/{id} sau GET /v1/links?q=<slug> dintr-un nod HTTP Request folosind aceeași acreditare.

Declanșatoare

Un nod dedicat Elido Trigger este planificat. Până la lansarea lui, folosiți declanșatorul Webhook integrat în n8n împreună cu un endpoint webhook Elido:

1. Adăugați un nod Webhook (metoda POST) și copiați URL-ul lui de producție.
2. În Elido, mergeți la Settings → Webhooks → New endpoint, lipiți URL-ul și alegeți evenimentele: link.created, link.updated, link.deleted, link.expired, link.cap_reached sau link.broken.
3. Copiați secretul de semnare. Fiecare livrare conține un header X-Elido-Signature: v1=<hex>, un HMAC-SHA256 al {timestamp}.{raw body} calculat cu acel secret, unde timestamp-ul este valoarea în secunde Unix din X-Webhook-Timestamp; verificați-l într-un nod Code înainte de a avea încredere în payload. Ghidul webhook-urilor conține fragmentul de cod pentru verificare.

Declanșator	Stare
Link creat, actualizat, șters, expirat, întrerupt, plafon de clicuri atins	Disponibil astăzi prin nodul Webhook
Link Clicked	Planificat. Necesită evenimentul webhook click.created, care încă nu este emis
Conversion Recorded	Planificat, după lansarea API-ului de conversii
Threshold Exceeded	Planificat

Flux de lucru exemplu - raport zilnic de clicuri într-o foaie 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 }}

Flux de lucru exemplu - crearea unui link dintr-un webhook

Un sistem extern trimite (POST) un URL către n8n, n8n îl scurtează cu Elido și returnează URL-ul scurt.

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

Depanare

Nodul comunitar nu apare după instalare - reîncărcați editorul. Dacă tot lipsește, reporniți n8n; în Docker:

docker restart n8n

Testul acreditării eșuează cu 404 sau 403 - Workspace ID-ul nu corespunde workspace-ului în care a fost creată cheia, sau cheia a fost revocată. Verificați ambele în Settings → API keys din Elido.

Create eșuează cu "domain_id" - Domain ID nu este un domeniu al acestui workspace. Lăsați-l gol pentru a folosi domeniul implicit.

Get Analytics nu returnează nimic - linkul nu are clicuri în intervalul respectiv, sau Link ID-ul aparține altui workspace. Lărgiți mai întâi From și To.

URL-ul webhook-ului este respins de Elido - URL-ul webhook-ului n8n trebuie să fie accesibil din internet. Dacă rulați n8n pe un computer local sau într-o rețea privată, configurați un tunel (de exemplu Cloudflare Tunnel sau ngrok) și direcționați variabila de mediu WEBHOOK_URL a n8n către adresa tunelului.