Używaj Elido w samodzielnie hostowanym n8n

n8n to samodzielnie hostowane narzędzie do automatyzacji workflow. Community node Elido daje Ci natywne akcje w wizualnym edytorze n8n, więc nie musisz ręcznie budować węzłów HTTP Request względem API Elido.

Wymagania

• Samodzielnie hostowany n8n z włączonymi community node. Plany cloud n8n mogą ograniczać community node: sprawdź swój plan.
• Klucz 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:

   n8n-nodes-elido
   

4. Zaakceptuj ostrzeżenie o ryzyku i kliknij Install.
5. Wyszukaj "Elido" w selektorze węzłów. Pojawi się węzeł Elido z zasobem Link.

Krok 2 - Utwórz klucz API Elido

1. W Elido przejdź do Settings → API keys → New key.
2. Wybierz rolę dla klucza. Editor może tworzyć linki i odczytywać analitykę; Viewer może tylko odczytywać linki i analitykę. Klucz należy do workspace, w którym go utworzono, i nie może działać w żadnym innym workspace.
3. Skopiuj klucz. Zaczyna się od elido_ i jest wyświetlany tylko raz.

Tokeny z zakresami per-scope (links:write, analytics:read i tak dalej) są planowane; dziś to rola określa, co może zrobić klucz.

Krok 3 - Dodaj dane uwierzytelniające Elido w n8n

1. W n8n przejdź do Credentials → New Credential → Elido API.
2. Base URL: zostaw https://api.elido.app dla Elido Cloud albo wpisz root swojego samodzielnie hostowanego API.
3. API Token: wklej klucz elido_.
4. Workspace ID: numeryczne ID workspace, do którego należy klucz (Settings → Workspace). Węzeł używa go do analityki.
5. Kliknij Save. n8n testuje dane uwierzytelniające, odczytując ten workspace, więc błędny klucz, błędny base URL lub klucz z innego workspace zawiedzie tutaj, a nie w działającym workflow.

Utwórz jedne dane uwierzytelniające na każdy workspace Elido i wybieraj właściwe w każdym węźle.

Dostępne akcje

Akcja	Co robi
Create	Skraca docelowy URL. Opcjonalnie slug, tytuł, tagi, data wygaśnięcia, status przekierowania i domain ID
Get	Zwraca jeden link po jego ID
List	Zwraca do 100 linków, od najnowszych, filtrowanych po tekście wyszukiwania, tagach lub statusie (active/disabled)
Get Analytics	Zwraca kliknięcia w czasie lub kliknięcia według kraju, referrera, urządzenia lub przeglądarki, dla jednego linku

Create bez Domain ID umieszcza link na domyślnej domenie Elido Twojego workspace. Aby użyć domeny niestandardowej, przekaż jej ID z Settings → Domains.

List i Get Analytics zwracają jeden element n8n na wiersz, więc następny węzeł uruchamia się raz na link albo raz na dzień, kraj, referrera i tak dalej. Get Analytics domyślnie obejmuje ostatnie 30 dni; ustaw From i To (YYYY-MM-DD), aby zmienić okres.

Update Link i Look Up Link by slug to planowane akcje. Dopóki nie zostaną wydane, wywołuj PATCH /v1/links/{id} lub GET /v1/links?q=<slug> z węzła HTTP Request, używając tych samych danych uwierzytelniających.

Wyzwalacze

Dedykowany węzeł Elido Trigger jest planowany. Dopóki nie zostanie wydany, użyj wbudowanego wyzwalacza Webhook n8n z punktem końcowym webhooka Elido:

1. Dodaj węzeł Webhook (metoda POST) i skopiuj jego produkcyjny URL.
2. W Elido przejdź do Settings → Webhooks → New endpoint, wklej URL i wybierz zdarzenia: link.created, link.updated, link.deleted, link.expired, link.cap_reached lub link.broken.
3. Skopiuj sekret podpisujący. Każda dostawa niesie nagłówek X-Elido-Signature: v1=<hex>, czyli HMAC-SHA256 z {timestamp}.{raw body} z użyciem tego sekretu, gdzie znacznik czasu to wartość w sekundach Unix z X-Webhook-Timestamp; zweryfikuj go w węźle Code, zanim zaufasz ładunkowi. Przewodnik po webhookach zawiera fragment kodu do weryfikacji.

Wyzwalacz	Status
Link utworzony, zaktualizowany, usunięty, wygasły, zepsuty, limit kliknięć osiągnięty	Dostępne dziś przez węzeł Webhook
Link Clicked	Planowane. Wymaga zdarzenia webhook click.created, które nie jest jeszcze emitowane
Conversion Recorded	Planowane, po wdrożeniu API konwersji
Threshold Exceeded	Planowane

Przykładowy workflow - dzienny raport kliknięć do arkusza kalkulacyjnego

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

Przykładowy workflow - utwórz link z webhooka

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: Create]
  - Destination URL: {{ $json.body.url }}
  - Tags: {{ $json.body.tag }}
      ↓
[Respond to Webhook]
  - Body: { "short_url": "{{ $json.short_url }}" }

Rozwiązywanie problemów

Community node nie pojawia się po instalacji - odśwież edytor. Jeśli nadal go nie ma, zrestartuj n8n; w Dockerze:

docker restart n8n

Test danych uwierzytelniających kończy się błędem 404 lub 403 - Workspace ID nie pasuje do workspace, w którym utworzono klucz, albo klucz został unieważniony. Sprawdź oba w Elido, w Settings → API keys.

Create kończy się błędem "domain_id" - Domain ID nie jest domeną tego workspace. Zostaw pole puste, aby użyć domeny domyślnej.

Get Analytics nic nie zwraca - link nie ma kliknięć w tym okresie albo Link ID należy do innego workspace. Najpierw poszerz From i To.

URL webhooka odrzucony przez Elido - URL webhooka n8n musi być dostępny z internetu. Jeśli uruchamiasz n8n na lokalnej maszynie lub w sieci prywatnej, skonfiguruj tunel (na przykład Cloudflare Tunnel lub ngrok) i ustaw zmienną środowiskową WEBHOOK_URL n8n na adres tunelu.