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 eylemler sağlar, böylece Elido API'sine karşı elle HTTP Request düğümleri oluşturmanız gerekmez.

Gereksinimler

• Topluluk düğümleri etkinleştirilmiş, kendi sunucunuzda barındırılan n8n. Bulut n8n planları topluluk düğümlerini kısıtlayabilir; planınızı kontrol edin.
• Bir Elido çalışma alanı API anahtarı.

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:

   n8n-nodes-elido
   

4. Risk bildirimini kabul edin ve Yükle'ye tıklayın.
5. Düğüm seçicide "Elido" araması yapın. Elido düğümü Link kaynağıyla birlikte görünür.

Adım 2 - Bir Elido API anahtarı oluşturun

1. Elido'da Ayarlar → API anahtarları → Yeni anahtar bölümüne gidin.
2. Anahtar için bir rol seçin. Editor bağlantı oluşturabilir ve analizleri okuyabilir; Viewer yalnızca bağlantıları ve analizleri okuyabilir. Bir anahtar, oluşturulduğu çalışma alanına aittir ve başka hiçbir çalışma alanında işlem yapamaz.
3. Anahtarı kopyalayın. elido_ ile başlar ve yalnızca bir kez gösterilir.

Kapsam bazlı token'lar (links:write, analytics:read vb.) planlanıyor; bugün anahtarın neler yapabileceğini rol belirler.

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

1. n8n'de Credentials → Yeni Credential → Elido API bölümüne gidin.
2. Base URL: Elido Cloud için https://api.elido.app olarak bırakın veya kendi sunucunuzda barındırılan API kök adresinizi girin.
3. API Token: elido_ anahtarını yapıştırın.
4. Workspace ID: Anahtarın ait olduğu çalışma alanının sayısal kimliği (Ayarlar → Çalışma Alanı). Düğüm bunu analizler için kullanır.
5. Save'e tıklayın. n8n, kimlik bilgisini o çalışma alanını okuyarak test eder; bu yüzden yanlış bir anahtar, yanlış bir base URL veya başka bir çalışma alanına ait bir anahtar, çalışan bir iş akışında değil burada başarısız olur.

Her Elido çalışma alanı için bir kimlik bilgisi oluşturun ve her düğümde doğru olanı seçin.

Kullanılabilir eylemler

Eylem	Ne yapar
Create	Bir hedef URL'yi kısaltır. İsteğe bağlı slug, başlık, etiketler, son kullanma tarihi, yönlendirme durumu ve domain ID
Get	ID'sine göre tek bir bağlantı döndürür
List	En yeniden en eskiye, arama metni, etiketler veya duruma (active/disabled) göre filtrelenmiş en fazla 100 bağlantı döndürür
Get Analytics	Bir bağlantı için zaman içindeki tıklamaları veya ülkeye, yönlendirene (referrer), cihaza ya da tarayıcıya göre tıklamaları döndürür

Domain ID olmadan Create, bağlantıyı çalışma alanınızın varsayılan Elido domainine yerleştirir. Özel bir domain kullanmak için, ID'sini Ayarlar → Domainler bölümünden geçirin.

List ve Get Analytics, her satır için bir n8n öğesi döndürür; bu yüzden bir sonraki düğüm her bağlantı için ya da her gün, ülke, yönlendiren vb. için bir kez çalışır. Get Analytics varsayılan olarak son 30 günü kullanır; pencereyi değiştirmek için From ve To (YYYY-MM-DD) alanlarını ayarlayın.

Update Link ve Look Up Link by slug planlanan eylemlerdir. Bunlar kullanıma sunulana kadar, aynı kimlik bilgisiyle bir HTTP Request düğümünden PATCH /v1/links/{id} veya GET /v1/links?q=<slug> çağırın.

Tetikleyiciler

Özel bir Elido Trigger düğümü planlanıyor. Kullanıma sunulana kadar, bir Elido webhook uç noktasıyla birlikte n8n'in yerleşik Webhook tetikleyicisini kullanın:

1. Bir Webhook düğümü ekleyin (yöntem POST) ve üretim URL'sini kopyalayın.
2. Elido'da Ayarlar → Webhooks → New endpoint bölümüne gidin, URL'yi yapıştırın ve olayları seçin: link.created, link.updated, link.deleted, link.expired, link.cap_reached veya link.broken.
3. İmzalama sırrını (signing secret) kopyalayın. Her teslimat, o sırla oluşturulmuş {timestamp}.{raw body} değerinin HMAC-SHA256'sı olan bir X-Elido-Signature: v1=<hex> başlığı taşır; burada timestamp, X-Webhook-Timestamp içindeki Unix saniye değeridir. Yüke (payload) güvenmeden önce bunu bir Code düğümünde doğrulayın. webhooks kılavuzu doğrulama kod parçacığını içerir.

Tetikleyici	Durum
Link created, updated, deleted, expired, broken, click cap reached	Bugün Webhook düğümü üzerinden kullanılabilir
Link Clicked	Planlanıyor. Henüz yayınlanmamış olan click.created webhook olayına ihtiyaç duyar
Conversion Recorded	Conversions API'den sonra planlanıyor
Threshold Exceeded	Planlanıyor

Örnek iş akışı - günlük tıklama raporunu bir e-tabloya gönderme

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

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

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

Sorun giderme

Kurulumdan sonra topluluk düğümü görünmüyor: düzenleyiciyi yeniden yükleyin. Hâlâ görünmüyorsa n8n'i yeniden başlatın; Docker'da:

docker restart n8n

Kimlik bilgisi testi 404 veya 403 ile başarısız oluyor: Workspace ID, anahtarın oluşturulduğu çalışma alanıyla eşleşmiyor veya anahtar iptal edilmiş. Her ikisini de Elido'nun Ayarlar → API anahtarları bölümünden kontrol edin.

Create, "domain_id" hatasıyla başarısız oluyor: Domain ID bu çalışma alanına ait bir domain değil. Varsayılan domaini kullanmak için boş bırakın.

Get Analytics hiçbir şey döndürmüyor: bağlantının o pencerede hiç tıklaması yok veya Link ID başka bir çalışma alanına ait. Önce From ve To aralığını genişletin.

Webhook URL'si Elido tarafından reddediliyor: n8n'in webhook URL'si internetten erişilebilir olmalıdır. n8n'i yerel bir makinede veya özel bir ağda çalıştırıyorsanız bir tünel kurun (örneğin Cloudflare Tunnel veya ngrok) ve n8n'in WEBHOOK_URL ortam değişkenini tünel adresine yönlendirin.