Usa Elido in n8n self-hosted

n8n è uno strumento di automazione dei workflow self-hosted. Il community node Elido ti dà azioni già pronte nell'editor visuale di n8n, perché tu non debba costruire a mano nodi HTTP Request contro l'API di Elido.

Requisiti

• n8n self-hosted con i community node abilitati. I piani n8n Cloud potrebbero limitare i community node; controlla il tuo piano.
• Una chiave 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:

   n8n-nodes-elido
   

4. Accetta l'avviso di rischio e fai clic su Install.
5. Cerca "Elido" nel selettore di nodi. Il nodo Elido dovrebbe già comparire con la risorsa Link.

Step 2: Crea una chiave API Elido

1. In Elido, vai su Settings → API keys → New key.
2. Scegli un ruolo per la chiave. Editor può creare link e leggere le analisi; Viewer può solo leggere link e analisi. Una chiave appartiene al workspace in cui viene creata e non può agire su nessun altro workspace.
3. Copia la chiave. Inizia con elido_ e viene mostrata una sola volta.

I token per singolo scope (links:write, analytics:read e così via) sono in programma; per ora, però, è il ruolo a determinare cosa può fare una chiave.

Step 3: Aggiungi le credenziali Elido in n8n

1. In n8n, vai su Credentials → New Credential → Elido API.
2. Base URL: lascia https://api.elido.app per Elido Cloud, oppure inserisci la radice della tua API self-hosted.
3. API Token: incolla la chiave elido_.
4. Workspace ID: l'ID numerico del workspace a cui appartiene la chiave (Settings → Workspace). Il nodo lo usa per le analisi.
5. Fai clic su Save. n8n verifica la credenziale leggendo quel workspace, perciò una chiave sbagliata, una Base URL sbagliata o una chiave di un altro workspace falliscono già qui invece che in un workflow in esecuzione.

Crea una credenziale per ogni workspace Elido e scegli quella giusta in ciascun nodo.

Azioni disponibili

Azione	Cosa fa
Create	Abbrevia un URL di destinazione. Slug, titolo, tag, scadenza, stato del redirect e dominio opzionali
Get	Restituisce un link tramite il suo ID
List	Restituisce fino a 100 link, dal più recente, filtrati per testo di ricerca, tag o stato (attivo/disabilitato)
Get Analytics	Restituisce i clic nel tempo, oppure i clic per paese, referrer, dispositivo o browser, per un link

Create senza un Domain ID mette il link sul dominio Elido predefinito del tuo workspace. Per usare un dominio personalizzato, passa il suo ID da Settings → Domains.

List e Get Analytics restituiscono un elemento n8n per riga, quindi il nodo successivo viene eseguito una volta per link o una volta per giorno, paese, referrer e così via. Get Analytics usa di default gli ultimi 30 giorni; imposta però From e To (YYYY-MM-DD) per cambiare la finestra.

Update Link e Look Up Link per slug sono azioni in programma. Finché non vengono rilasciate, chiama PATCH /v1/links/{id} oppure GET /v1/links?q=<slug> da un nodo HTTP Request con la stessa credenziale.

Trigger

Un nodo dedicato Elido Trigger è già in programma. Finché però non viene rilasciato, usa il trigger integrato Webhook di n8n con un endpoint webhook Elido:

1. Aggiungi un nodo Webhook (metodo POST) e copia il suo URL di produzione.
2. In Elido, vai su Settings → Webhooks → New endpoint, incolla l'URL e scegli gli eventi: link.created, link.updated, link.deleted, link.expired, link.cap_reached oppure link.broken.
3. Copia il signing secret. Ogni consegna porta un header X-Elido-Signature: v1=<hex>, un HMAC-SHA256 di {timestamp}.{raw body} con quel secret, dove il timestamp è il valore in secondi Unix in X-Webhook-Timestamp; verificalo in un nodo Code prima di fidarti del payload. La guida ai webhook contiene lo snippet di verifica.

Trigger	Stato
Link creato, aggiornato, eliminato, scaduto, rotto, limite di clic raggiunto	Disponibile oggi tramite il nodo Webhook
Link Clicked	In programma. Richiede l'evento webhook click.created, non ancora emesso
Conversion Recorded	In programma, dopo l'API delle conversioni
Threshold Exceeded	In programma

Workflow di esempio: report giornaliero dei clic su un foglio di calcolo

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

Workflow di esempio: crea un link da un webhook

Un sistema esterno invia un URL con un POST a n8n, n8n lo abbrevia con Elido e restituisce l'URL abbreviato.

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

Risoluzione dei problemi

Il community node non appare dopo l'installazione: ricarica l'editor. Se manca ancora, riavvia n8n; in Docker:

docker restart n8n

Il test della credenziale fallisce con 404 o 403: il Workspace ID non corrisponde al workspace in cui è stata creata la chiave, oppure la chiave è stata revocata. Controlla entrambi in Settings → API keys di Elido.

Create fallisce con "domain_id": il Domain ID non è un dominio di questo workspace. Lascialo vuoto per usare il dominio predefinito.

Get Analytics non restituisce nulla: il link non ha clic nella finestra selezionata, oppure il Link ID appartiene a un altro workspace. Allarga prima From e To.

URL webhook rifiutato da Elido: l'URL webhook di n8n deve essere raggiungibile da internet. Se esegui n8n su una macchina locale o una rete privata, configura un tunnel (per esempio Cloudflare Tunnel o ngrok) e imposta la variabile d'ambiente WEBHOOK_URL di n8n sull'indirizzo del tunnel.