Elido'yu Kendi Sunucunuzda Barındırılan n8n'de Kullanın

n8n, kendi sunucunuzda barındırılan bir iş akışı otomasyon aracıdır. Elido topluluk düğümü, n8n'in görsel düzenleyicisi içinde yerel tetikleyiciler ve eylemler sağlar — HTTP Request düğümlerine gerek kalmadan.

Gereksinimler

• n8n sürüm 0.220 veya üzeri (topluluk düğümleri bu minimumu gerektirir).
• Topluluk düğümü kurulumu etkinleştirilmiş, kendi sunucunuzda barındırılan n8n. Bulut n8n planları bunu kısıtlayabilir — planınızı kontrol edin.
• Bir Elido çalışma alanı API token'ı.

Adım 1 — Topluluk düğümünü yükleyin

1. n8n'de, Ayarlar → Topluluk Düğümleri bölümüne gidin.
2. Bir topluluk düğümü yükle'ye tıklayın.
3. Paket adını yapıştırın:

   @elidoapp/n8n-nodes-elido
   

4. Risk bildirimini kabul edin ve Yükle'ye tıklayın.
5. n8n yeniden başlar. Yeniden başlattıktan sonra, düğüm seçicide "Elido" araması yapın — Elido tetikleyici ve eylem düğümlerini görmelisiniz.

Adım 2 — Bir Elido API token'ı oluşturun

1. Elido'da, Kontrol Paneli → API Anahtarları → Yeni anahtar bölümüne gidin.
2. İş akışınızın neye ihtiyacı olduğuna göre kapsamları seçin:
   • links:read — bağlantılara bakma, bağlantıları listeleme.
   • links:write — bağlantı oluşturma ve güncelleme.
   • analytics:read — tıklama sayılarını ve analizleri okuma.
3. Token'ı kopyalayın. ek_ ile başlar.

Adım 3 — n8n'de Elido kimlik bilgilerini ekleyin

1. n8n'de, Credentials → Yeni Credential → Elido API bölümüne gidin.
2. Token'ı API Token alanına yapıştırın.
3. Çalışma alanı, token'dan otomatik olarak algılanır. Kaydet'e tıklayın.

Birden fazla kimlik bilgisi oluşturabilir (Elido çalışma alanı başına bir tane) ve bunlara ayrı düğümlerde başvurabilirsiniz.

Mevcut tetikleyiciler

Tetikleyici	Ne zaman tetiklenir
Bağlantı Tıklandı	Çalışma alanındaki herhangi bir bağlantıya her tıklamada (veya etiket/slug'a göre filtrelenmiş)
Dönüşüm Kaydedildi	Her dönüşüm kaydedildiğinde
Eşik Aşıldı	Bir bağlantının tıklama sayısı yapılandırılan sayıyı aştığında

Tetikleyiciler, Elido'nun webhook sistemini arka planda kullanır. İş akışını etkinleştirdiğinizde n8n, webhook URL'sini otomatik olarak kaydeder.

Mevcut eylemler

Eylem	Ne yapar
Bağlantı Oluştur	Yeni bir kısa bağlantı oluşturur
Bağlantı Güncelle	Hedef URL'yi, slug'ı, etiketleri veya son kullanma tarihini günceller
Bağlantıları Listele	Filtrelerle sayfalanmış bir bağlantı listesi döndürür
Bağlantı Ara	Slug veya ID'ye göre bir bağlantı bulur
Analiz Getir	Bir bağlantı için tıklama sayısı ve dökümünü döndürür

Örnek iş akışı — tıklamaları Baserow'a kaydetme

Bu iş akışı her tıklamada tetiklenir ve bir Baserow tablosuna (n8n kurulumlarında yaygın, kendi sunucunuzda barındırılan bir Airtable alternatifi) bir satır yazar.

[Elido Trigger: Link Clicked]
      ↓
[Baserow: Create Row]
  - Table: "Click Log"
  - Slug: {{ $json.slug }}
  - Country: {{ $json.country }}
  - Device: {{ $json.device }}
  - Clicked At: {{ $json.clicked_at }}

Kurmak için:

1. Elido tetikleyicisini tuval üzerine sürükleyin. Kimlik bilgisini seçin. Tetikleyici türünü "Link Clicked" olarak ayarlayın.
2. Bir Baserow düğümü sürükleyin. Bağlayın. Baserow tabanınızı ve tablonuzu yapılandırın.
3. Alanları yukarıda gösterildiği gibi eşleyin.
4. Activate workflow'a tıklayın.

Örnek iş akışı — bir webhook'tan bağlantı oluşturma

Daha basit bir desen: harici bir sistem n8n'e bir URL POST eder, n8n bunu Elido ile kısaltır ve kısa URL'yi döndürür.

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

Sorun giderme

Kurulumdan sonra topluluk düğümü görünmüyor — Topluluk düğümlerini yükledikten sonra n8n'in tam bir yeniden başlatmaya ihtiyacı vardır. Docker'da n8n çalıştırıyorsanız, konteyneri yeniden başlatın:

docker restart n8n

Bir düğümü test ederken "Invalid credentials" — API token'ı yanlış veya yanlış kapsamlandırılmış. İş akışınızın ihtiyaç duyduğu kapsamlarla yeni bir token oluşturun ve n8n kimlik bilgisini güncelleyin.

Tetikleyici tetiklenmiyor — İş akışının active olduğunu kontrol edin (iş akışı düzenleyicisinin sağ üstündeki geçiş anahtarı). Etkin olmayan iş akışları webhook kaydetmez, bu yüzden Elido asla olay göndermez.

Webhook URL'si Elido tarafından reddedildi — n8n'in webhook URL'si internetten (veya Elido'nun sunucularından) erişilebilir olmalıdır. n8n'i yerel bir makinede veya özel bir ağda çalıştırıyorsanız, bir tünel kurun (örn. Cloudflare Tunnel, ngrok) ve n8n'in ortam değişkenlerinde WEBHOOK_URL'i tünel adresine işaret edecek şekilde yapılandırın.