Usa Elido in n8n self-hosted

n8n è uno strumento di automazione dei workflow self-hosted. Il community node Elido ti dà trigger e azioni native nell'editor visuale di n8n — nessun nodo HTTP Request richiesto.

Requisiti#

• n8n versione 0.220 o successiva (i community node richiedono questo minimo).
• n8n self-hosted con l'installazione dei community node abilitata. I piani cloud n8n potrebbero non supportarlo — controlla il tuo piano.
• Un token API del workspace Elido.

Step 1 — Installa il community node#

1. In n8n, vai su Settings → Community Nodes.
2. Fai clic su Install a community node.
3. Incolla il nome del pacchetto:

   @elidoapp/n8n-nodes-elido
   

4. Accetta l'avviso di rischio e fai clic su Install.
5. n8n si riavvia. Dopo il riavvio, cerca "Elido" nel selettore di nodi — dovresti vedere i nodi trigger e azione di Elido.

Step 2 — Genera un token API Elido#

1. In Elido, vai su Dashboard → API Keys → New key.
2. Scegli gli scope in base a ciò di cui il tuo workflow ha bisogno:
   • links:read — cerca link, elenca link.
   • links:write — crea e aggiorna link.
   • analytics:read — leggi i conteggi dei clic e le analisi.
3. Copia il token. Inizia con ek_.

Step 3 — Aggiungi le credenziali Elido in n8n#

1. In n8n, vai su Credentials → New Credential → Elido API.
2. Incolla il token nel campo API Token.
3. Il workspace viene rilevato automaticamente dal token. Fai clic su Salva.

Puoi creare più credenziali (una per workspace Elido) e referenziarle nei singoli nodi.

Trigger disponibili#

Trigger	Quando si attiva
Link Clicked	Ad ogni clic su qualsiasi link nel workspace (o filtrato per tag/slug)
Conversion Recorded	Ogni volta che viene registrata una conversione
Threshold Exceeded	Quando il conteggio dei clic di un link supera il numero configurato

I trigger usano il sistema webhook di Elido internamente. n8n registra automaticamente l'URL del webhook quando attivi il workflow.

Azioni disponibili#

Azione	Cosa fa
Create Link	Crea un nuovo link abbreviato
Update Link	Aggiorna l'URL di destinazione, lo slug, i tag o la scadenza
List Links	Restituisce un elenco paginato di link con filtri
Look Up Link	Trova un link per slug o ID
Get Analytics	Restituisce il conteggio dei clic e il dettaglio per un link

Workflow di esempio — registra i clic in Baserow#

Questo workflow si attiva ad ogni clic e scrive una riga in una tabella Baserow (un'alternativa Airtable self-hosted comune nelle configurazioni 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 }}

Per configurarlo:

1. Trascina il trigger Elido sul canvas. Seleziona le credenziali. Imposta il tipo di trigger su "Link Clicked".
2. Trascina un nodo Baserow. Collegalo. Configura la tua base e tabella Baserow.
3. Mappa i campi come mostrato sopra.
4. Fai clic su Activate workflow.

Workflow di esempio — crea un link da un webhook#

Un pattern più semplice: un sistema esterno invia un POST di un URL a n8n, n8n lo abbrevia con Elido e restituisce l'URL abbreviato.

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

Risoluzione dei problemi#

Il community node non appare dopo l'installazione — n8n ha bisogno di un riavvio completo dopo l'installazione dei community node. Se stai eseguendo n8n in Docker, riavvia il container:

docker restart n8n

"Invalid credentials" quando si testa un nodo — Il token API è errato o con scope errati. Rigenera un token con gli scope di cui ha bisogno il tuo workflow e aggiorna la credenziale n8n.

Il trigger non si attiva — Controlla che il workflow sia attivo (il toggle in alto a destra nell'editor del workflow). I workflow inattivi non registrano webhook, quindi Elido non invia mai eventi.

URL webhook rifiutato da Elido — L'URL webhook di n8n deve essere raggiungibile da internet (o dai server di Elido). Se stai eseguendo n8n su una macchina locale o una rete privata, configura un tunnel (es. Cloudflare Tunnel, ngrok) e configura WEBHOOK_URL nelle variabili d'ambiente di n8n per puntare all'indirizzo del tunnel.