Web Kancaları

Web kancaları, bağlantılarınız hakkında gerçek zamanlı bildirimler almanızı sağlar — tıklandıklarında, oluşturuldukları, güncellendiği veya silindiği zaman. Linkly, her etkinlik hakkında ayrıntılı bilgiler içeren bir POST isteği belirtilen URL'nize gönderir.

Kullanım durumları

• Otomasyon Platformları: Make veya Zapier içinde bağlantılar tıklandığında iş akışlarını tetikleyin
• Özel Analitikler: Tıklama verilerini kendi analitik sisteminize gönderin
• CRM Güncellemeleri: Müşteri kayıtlarını bağlantıları tıkladığında güncelleyin
• Slack Bildirimleri: Önemli bağlantılar tıklandığında Slack'te bildirim alın
• Potansiyel Müşteri Takibi: Potansiyel müşterilerin bağlantılarınızla nasıl etkileşimde bulunduğunu takip edin

İpucu: Çoğu otomasyon kullanım durumu için Make entegrasyonu veya Zapier entegrasyonu özel web kancalarından kurulumu daha kolaydır. Bunlar kodlama gerektirmeden anında tıklama tetikleyicileri içerir.

Not: İki düzeyde de web kancaları yapılandırırsanız, o bağlantının tıklaması için her ikisi de çalışacaktır.

Etkinlikler

Her web kancası kapsamı için tüm etkinlik türlerini alır — bağlantı düzeyindeki web kancası o bağlantı için olaylar alır, çalışma alanı düzeyindeki web kancası çalışma alanınızdaki her bağlantı için olaylar alır. Bunları ayırt etmek için en üst düzey event alanını kontrol edin:

Web kancası yükü

Tıklama yükü

Bir tıklama oluştuğunda, Linkly aşağıdaki JSON yükü ile bir POST isteği gönderir:

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "id": "01KYPGEEPJSPR3S564QRBDGA1W",
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

Yük alanları

Etkinlik bilgisi

Bağlantı nesnesi

Tıklama nesnesi

Gizlilik Notu: IP adresleri hiçbir zaman web kancası yüklerine dahil edilmez.

Bağlantı yaşam döngüsü yükü

link.created, link.updated ve link.deleted olayları aynı şekli paylaşır. click nesnesi yok — event, bir timestamp ve tam link alırsınız:

{
  "event": "link.created",
  "timestamp": "2026-06-20T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "workspace_id": 1,
    "enabled": true,
    "rules": []
  }
}

Otomasyon platform entegrasyonları

Özel kodlama olmadan daha kolay kurulum için yerel entegrasyonlarımızı kullanın:

• Make Entegrasyonu - Anında tıklama tetikleyicilerine sahip görsel otomasyon platformu
• Zapier Entegrasyonu - Linkly'yi binlerce uygulamaya kod yazmadan bağlayın

Her iki entegrasyon da arka planda web kancaları kullanır ancak tüm kurulumu otomatik olarak yönetir.

En iyi uygulamalar

Birden çok web kancası

Birden çok web kancası URL'si (her satıra bir tane) ekleyebilirsiniz. Bir tıklama oluştuğunda tüm URL'ler aynı yükü alacaktır.

Hata işleme

• Web kancaları ateşle ve unut şeklindedir - Linkly başarısız teslimatları yeniden denemez
• Web kancası başarısızlıkları yönlendirmeyi asla etkilemez - kullanıcılar her zaman hedeflerine ulaşır
• Web kancası uç noktanızın hızlı yanıt vermesini sağlayın (< 5 saniye önerilir)

Güvenlik

• Web kancası URL'leri için HTTPS uç noktalarını kullanın
• Web kancası işleyicinizde gelen istekleri doğrulayın
• Doğrulama için web kancası URL'nize gizli bir parametre eklemeyi düşünün

Test Etme

1. 1
   webhook.site veya RequestBin gibi bir hizmet kullanarak bir web kancası URL'si kurun
2. 2
   Bağlantınızı tıklayın
3. 3
   Alınan yükü inceleyin
4. 4
   Doğrulandıktan sonra, üretim web kancası URL'nize geçiş yapın

API erişimi

Ayrıca API aracılığıyla web kancalarını programlı olarak yönetebilirsiniz:

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

Ayrıntılar için API Belgeleri bölümüne bakın.