Web Kancaları

Web kancaları, bağlantılarınız hakkında gerçek zamanlı bildirimler almanıza olanak tanır — hem tıklandıklarında hem de oluşturuldukları, güncelledikleri veya silindikleri zaman. Linkly, her olay hakkında ayrıntılı bilgiler içeren bir POST isteğini belirttiğiniz URL'ye 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: Bağlantıyı tıkladıklarında müşteri kayıtlarını güncelleyin
• Slack Bildirimleri: Önemli bağlantılar tıklandığında Slack'te bildirim alın
• Müşteri Adayı Takibi: Potansiyel müşterileriniz bağlantılarınıza ne zaman katıldığını takip edin

İpucu: Çoğu otomasyon kullanım durumunda, Make entegrasyonu veya Zapier entegrasyonu, özel web kancalarından daha kolay kurulur. Bunlar, kodlama gerektirmeyen web kancaları tarafından desteklenen anında tıklama tetikleyicileri içerir.

Not: Her iki düzeyde de web kancaları yapılandırırsanız, o bağlantıya yapılan tıklamalar için her ikisi de harekete geçer.

Etkinlikler

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

Web kancası yükü

Tıklama yükü

Bir tıklama gerçekleştiğinde, 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 etkinlikleri aynı şekli paylaşır. click nesnesi yoktur — 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 platformu entegrasyonları

Özel kodlamaya gerek 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'i binlerce uygulamaya kod olmadan bağlayın

Her iki entegrasyon de arkasında web kancalarını kullanır ancak tüm kurulumu otomatik olarak işler.

En iyi uygulamalar

Birden fazla web kancası

Birden fazla web kanca URL'si ekleyebilirsiniz (her satırda bir tane). Bir tıklama gerçekleştiğinde tüm URL'ler aynı yükü alacaktır.

Hata işleme

• Web kancaları gönder ve unut — Linkly başarısız teslimatleri yeniden denemez
• Web kancası hataları yeniden yönlendirmeyi asla etkilemez — kullanıcılar her zaman hedeflerine ulaşır
• Web kanca uç noktanızın hızlı yanıt vermesini sağlayın (< 5 saniye önerilir)

Güvenlik

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

Test etme

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

API erişimi

API üzerinden web kancaları programlı olarak da 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 Belgesi'ne bakın.