Web Kancaları

Web kancaları, bağlantılarınız hakkında gerçek zamanlı bildirimler almanızı sağlar — hem tıklandıklarında hem de oluşturulduktan, güncellendiğinde veya silindiğinde. Linkly, belirtilen URL'niz(e) her olay hakkında ayrıntılı bilgiler içeren bir POST isteği gönderir.

Kullanım durumları

• Otomasyon Platformları: Make veya Zapier'da bağlantılara tıklandığında iş akışlarını tetikleyin
• Özel Analitikler: Tıklama verilerini kendi analitik sisteminize gönderin
• CRM Güncellemeleri: Müşteriler bağlantılara tıkladığında müşteri kayıtlarını güncelleyin
• Slack Bildirimleri: Önemli bağlantılara tıklandığında Slack'te bildirim alın
• Müşteri Adayı Takibi: Potansiyel müşterilerin bağlantılarınızla ne zaman etkileşime girdiğini izleyin

İpucu: Çoğu otomasyon kullanım durumu için Make entegrasyonu veya Zapier entegrasyonu özel web kancalarından daha kolay kurulur. Kodlama gerektirmeyen web kancaları tarafından desteklenen anında tıklama tetikleyicileri içerirler.

Not: Her iki düzeyde de web kancalarını yapılandırırsanız, ikisi de o bağlantıya tıklamalar için ateşlenir.

Etkinlikler

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

Web kancanız 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": {
    "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ı

Olay bilgileri

Bağlantı nesnesi

Tıklama nesnesi

Gizlilik Notu: IP adresleri web kancanız yüklerine hiçbir zaman 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 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 kodlama olmadan daha kolay kurulum için yerel entegrasyonlarımızı kullanın:

• Make Entegrasyonu - Anında tıklama tetikleyicileriyle görsel otomasyon platformu
• Zapier Entegrasyonu - Linkly'yi binlerce uygulama ile kodsuz olarak bağlayın

Her iki entegrasyon da arka planda web kancalarını kullanır, ancak tüm kurulumu otomatik olarak işler.

En iyi uygulamalar

Birden çok web kancanız

Birden çok web kancanız 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ı ateş ve unut — Linkly başarısız teslimatları yeniden denemez
• Web kancanız hataları yeniden yönlendirmeyi hiçbir zaman etkilemez — kullanıcılar her zaman hedeflerine ulaşır
• Web kancanız uç noktası hızlı yanıt verdiğinden emin olun (< 5 saniye önerilir)

Güvenlik

• Web kancanız URL'leri için HTTPS uç noktaları kullanın
• Web kancanız işleyicisinde gelen istekleri doğrulayın
• Doğrulama için web kancanız URL'nize bir gizli parametre eklemeyi göz önünde bulundurun

Test

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

API erişimi

API aracılığıyla web kancalarını 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 Belgelerine bakın.