Webhook

Webhook memungkinkan Anda menerima notifikasi real-time tentang tautan Anda — baik saat diklik maupun saat dibuat, diperbarui, atau dihapus. Linkly mengirimkan permintaan POST ke URL yang Anda tentukan dengan informasi terperinci tentang setiap peristiwa.

Kasus penggunaan

• Platform Otomasi: Picu alur kerja di Make atau Zapier saat tautan diklik
• Analitik Khusus: Kirim data klik ke sistem analitik Anda sendiri
• Update CRM: Perbarui catatan pelanggan saat mereka mengklik tautan
• Notifikasi Slack: Dapatkan pemberitahuan di Slack saat tautan penting diklik
• Pelacakan Lead: Lacak saat prospek terlibat dengan tautan Anda

Tip: Untuk sebagian besar kasus penggunaan otomasi, integrasi Make atau integrasi Zapier kami lebih mudah diatur daripada webhook khusus. Mereka menyertakan pemicu klik instan yang didukung webhook, tanpa pengkodean yang diperlukan.

Catatan: Jika Anda mengonfigurasi webhook di kedua tingkat, keduanya akan aktif untuk klik pada tautan tersebut.

Peristiwa

Setiap webhook menerima semua jenis peristiwa untuk ruang lingkupnya — webhook tingkat tautan mendapatkan peristiwa untuk tautan tersebut, webhook tingkat ruang kerja mendapatkan peristiwa untuk setiap tautan di ruang kerja. Periksa bidang event tingkat atas untuk membedakannya:

Payload webhook

Payload klik

Saat klik terjadi, Linkly mengirimkan permintaan POST dengan payload JSON berikut:

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

Bidang payload

Info peristiwa

Objek tautan

Objek klik

Catatan Privasi: Alamat IP tidak pernah disertakan dalam payload webhook.

Payload siklus hidup tautan

Peristiwa link.created, link.updated, dan link.deleted berbagi satu bentuk. Tidak ada objek click — Anda mendapatkan event, timestamp, dan link lengkap:

{
  "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": []
  }
}

Integrasi platform otomasi

Untuk pengaturan yang lebih mudah tanpa pengkodean khusus, gunakan integrasi asli kami:

• Integrasi Make - Platform otomasi visual dengan pemicu klik instan
• Integrasi Zapier - Hubungkan Linkly ke ribuan aplikasi tanpa kode

Kedua integrasi menggunakan webhook di bawah tenda tetapi menangani semua pengaturan secara otomatis.

Praktik terbaik

Beberapa webhook

Anda dapat menambahkan beberapa URL webhook (satu per baris). Semua URL akan menerima payload yang sama saat klik terjadi.

Penanganan kesalahan

• Webhook adalah fire-and-forget - Linkly tidak mencoba lagi pengiriman yang gagal
• Kegagalan webhook tidak pernah mempengaruhi pengalihan - pengguna selalu mencapai tujuan mereka
• Pastikan titik akhir webhook Anda merespons dengan cepat (< 5 detik disarankan)

Keamanan

• Gunakan titik akhir HTTPS untuk URL webhook
• Validasi permintaan masuk di penanganan webhook Anda
• Pertimbangkan menambahkan parameter rahasia ke URL webhook Anda untuk verifikasi

Pengujian

1. 1
   Siapkan URL webhook menggunakan layanan seperti webhook.site atau RequestBin
2. 2
   Klik tautan Anda
3. 3
   Periksa payload yang diterima
4. 4
   Setelah diverifikasi, beralih ke URL webhook produksi Anda

Akses API

Anda juga dapat mengelola webhook secara terprogram melalui API:

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

Lihat Dokumentasi API untuk rinciannya.