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.