Webhook

Webhook memungkinkan Anda menerima notifikasi real-time tentang tautan Anda — baik saat diklik maupun saat dibuat, diperbarui, atau dihapus. Linkly mengirim 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 Kustom: Kirim data klik ke sistem analitik Anda sendiri
• Pembaruan CRM: Perbarui catatan pelanggan saat mereka mengklik tautan
• Notifikasi Slack: Dapatkan pemberitahuan di Slack saat tautan penting diklik
• Pelacakan Prospek: Lacak saat prospek terlibat dengan tautan Anda

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

Catatan: Jika Anda mengonfigurasikan webhook di kedua level, keduanya akan aktif saat tautan tersebut diklik.

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 membedakan keduanya:

Muatan webhook

Muatan klik

Saat klik terjadi, Linkly mengirim permintaan POST dengan muatan 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 muatan

Info peristiwa

Objek tautan

Objek klik

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

Muatan 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 setup yang lebih mudah tanpa coding 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 topi tetapi menangani semua setup secara otomatis.

Praktik terbaik

Beberapa webhook

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

Penanganan kesalahan

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

Keamanan

• Gunakan endpoint 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
   Inspeksi muatan 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 detail.