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ă declanșatoare și acțiuni native în editorul vizual al n8n — fără să fie nevoie de noduri HTTP Request.

Cerințe

• n8n versiunea 0.220 sau ulterioară (nodurile comunitare necesită acest minim).
• n8n auto-găzduit cu instalarea nodurilor comunitare activată. Planurile n8n Cloud pot restricționa acest lucru — verificați planul dumneavoastră.
• Un token 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:

   @elidoapp/n8n-nodes-elido
   

4. Acceptați avertismentul de risc și faceți clic pe Install.
5. n8n repornește. După repornire, căutați „Elido” în selectorul de noduri — ar trebui să vedeți nodurile de declanșare și acțiune Elido.

Pasul 2 — Generați un token API Elido

1. În Elido, mergeți la Dashboard → API Keys → New key.
2. Alegeți permisiunile în funcție de ce are nevoie fluxul dumneavoastră de lucru:
   • links:read — caută linkuri, listează linkuri.
   • links:write — creează și actualizează linkuri.
   • analytics:read — citește numărul de clicuri și analizele.
3. Copiați tokenul. Începe cu ek_.

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

1. În n8n, mergeți la Credentials → New Credential → Elido API.
2. Lipiți tokenul în câmpul API Token.
3. Workspace-ul este detectat automat din token. Faceți clic pe Save.

Puteți crea mai multe acreditări (câte una pentru fiecare workspace Elido) și le puteți referenția în noduri individuale.

Declanșatoare disponibile

Declanșator	Când se activează
Link Clicked	La fiecare clic pe orice link din workspace (sau filtrat după tag/slug)
Conversion Recorded	De fiecare dată când este înregistrată o conversie
Threshold Exceeded	Când numărul de clicuri al unui link depășește numărul configurat

Declanșatoarele folosesc sistemul de webhook-uri al Elido în culise. n8n înregistrează automat URL-ul webhook-ului atunci când activați fluxul de lucru.

Acțiuni disponibile

Acțiune	Ce face
Create Link	Creează un link scurt nou
Update Link	Actualizează URL-ul de destinație, slug-ul, tag-urile sau expirarea
List Links	Returnează o listă paginată de linkuri cu filtre
Look Up Link	Găsește un link după slug sau ID
Get Analytics	Returnează numărul de clicuri și defalcarea pentru un link

Flux de lucru exemplu — înregistrarea clicurilor în Baserow

Acest flux de lucru se declanșează la fiecare clic și scrie un rând într-un tabel Baserow (o alternativă auto-găzduită la Airtable, obișnuită în configurațiile n8n).

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

Pentru configurare:

1. Trageți declanșatorul Elido pe canvas. Selectați acreditarea. Setați tipul de declanșator la „Link Clicked”.
2. Trageți un nod Baserow. Conectați-l. Configurați baza și tabelul dumneavoastră Baserow.
3. Asociați câmpurile așa cum este arătat mai sus.
4. Faceți clic pe Activate workflow.

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

Un model mai simplu: 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 Action: Create Link]
  - Destination URL: {{ $json.body.url }}
  - Tag: {{ $json.body.tag }}
      ↓
[Respond to Webhook]
  - Body: { "short_url": "{{ $json.short_url }}" }

Depanare

Nodul comunitar nu apare după instalare — n8n necesită o repornire completă după instalarea nodurilor comunitare. Dacă rulați n8n în Docker, reporniți containerul:

docker restart n8n

„Invalid credentials” la testarea unui nod — Tokenul API este greșit sau are permisiunile setate incorect. Regenerați un token cu permisiunile de care are nevoie fluxul dumneavoastră de lucru și actualizați acreditarea în n8n.

Declanșatorul nu se activează — Verificați că fluxul de lucru este activ (comutatorul din colțul din dreapta sus al editorului de fluxuri de lucru). Fluxurile de lucru inactive nu înregistrează webhook-uri, așa că Elido nu trimite niciodată evenimente.

URL-ul webhook-ului este respins de Elido — URL-ul webhook-ului n8n trebuie să fie accesibil de pe internet (sau de pe serverele Elido). Dacă rulați n8n pe un computer local sau într-o rețea privată, configurați un tunel (de ex. Cloudflare Tunnel, ngrok) și setați WEBHOOK_URL în variabilele de mediu ale n8n pentru a indica adresa tunelului.