Używaj Elido w samodzielnie hostowanym n8n

n8n to samodzielnie hostowane narzędzie do automatyzacji workflow. Community node Elido daje Ci natywne wyzwalacze i akcje w wizualnym edytorze n8n — nie są potrzebne węzły HTTP Request.

Wymagania#

• n8n w wersji 0.220 lub nowszej (community node wymagają tego minimum).
• Samodzielnie hostowany n8n z włączoną instalacją community node. Plany cloud n8n mogą to ograniczać — sprawdź swój plan.
• Token API workspace Elido.

Krok 1 — Zainstaluj community node#

1. W n8n przejdź do Settings → Community Nodes.
2. Kliknij Install a community node.
3. Wklej nazwę pakietu:

   @elidoapp/n8n-nodes-elido
   

4. Zaakceptuj ostrzeżenie o ryzyku i kliknij Install.
5. n8n restartuje się. Po restarcie wyszukaj "Elido" w selektorze węzłów — powinieneś zobaczyć węzły wyzwalaczy i akcji Elido.

Krok 2 — Wygeneruj token API Elido#

1. W Elido przejdź do Dashboard → API Keys → New key.
2. Wybierz zakresy na podstawie potrzeb workflow:
   • links:read — wyszukuj linki, listuj linki.
   • links:write — twórz i aktualizuj linki.
   • analytics:read — czytaj liczniki kliknięć i analitykę.
3. Skopiuj token. Zaczyna się od ek_.

Krok 3 — Dodaj dane uwierzytelniające Elido w n8n#

1. W n8n przejdź do Credentials → New Credential → Elido API.
2. Wklej token w polu API Token.
3. Workspace jest wykrywany automatycznie z tokenu. Kliknij Zapisz.

Możesz tworzyć wiele danych uwierzytelniających (jeden na workspace Elido) i odwoływać się do nich w poszczególnych węzłach.

Dostępne wyzwalacze#

Wyzwalacz	Kiedy się odpala
Link Clicked	Przy każdym kliknięciu dowolnego linku w workspace (lub przefiltrowanym po tagu/slugu)
Conversion Recorded	Za każdym razem gdy zostaje zarejestrowana konwersja
Threshold Exceeded	Gdy licznik kliknięć linku przekracza skonfigurowaną liczbę

Wyzwalacze używają pod spodem systemu webhook Elido. n8n automatycznie rejestruje URL webhooka podczas aktywacji workflow.

Dostępne akcje#

Akcja	Co robi
Create Link	Tworzy nowy krótki link
Update Link	Aktualizuje docelowy URL, slug, tagi lub datę wygaśnięcia
List Links	Zwraca paginowaną listę linków z filtrami
Look Up Link	Znajduje link po slugu lub ID
Get Analytics	Zwraca licznik kliknięć i podział dla linku

Przykładowy workflow — loguj kliknięcia do Baserow#

Ten workflow odpala się przy każdym kliknięciu i zapisuje wiersz do tabeli Baserow (samodzielnie hostowana alternatywa Airtable popularna w konfiguracjach 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 }}

Konfiguracja:

1. Przeciągnij wyzwalacz Elido na canvas. Wybierz dane uwierzytelniające. Ustaw typ wyzwalacza na "Link Clicked".
2. Przeciągnij węzeł Baserow. Połącz go. Skonfiguruj bazę i tabelę Baserow.
3. Zmapuj pola jak pokazano powyżej.
4. Kliknij Activate workflow.

Przykładowy workflow — utwórz link z webhooka#

Prostszy wzorzec: zewnętrzny system wysyła POST z URL-em do n8n, n8n skraca go za pomocą Elido i zwraca krótki URL.

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

Rozwiązywanie problemów#

Community node nie pojawia się po instalacji — n8n wymaga pełnego restartu po zainstalowaniu community node. Jeśli uruchamiasz n8n w Docker, zrestartuj kontener: docker restart n8n.

"Invalid credentials" przy testowaniu węzła — Token API jest błędny lub ma nieprawidłowy zakres. Wygeneruj ponownie token z zakresami potrzebnymi przez workflow i zaktualizuj dane uwierzytelniające n8n.

Wyzwalacz nie odpala się — Sprawdź, czy workflow jest aktywny (przełącznik w prawym górnym rogu edytora workflow). Nieaktywne workflow nie rejestrują webhooków, więc Elido nigdy nie wysyła zdarzeń.

URL webhooka odrzucony przez Elido — URL webhooka n8n musi być dostępny z internetu (lub z serwerów Elido). Jeśli uruchamiasz n8n na lokalnej maszynie lub sieci prywatnej, skonfiguruj tunel (np. Cloudflare Tunnel, ngrok) i ustaw WEBHOOK_URL w zmiennych środowiskowych n8n, aby wskazywał na adres tunelu.