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 detail tentang setiap acara.

Kasus penggunaan

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

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

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

Acara

Setiap webhook menerima semua jenis acara untuk cakupannya — webhook tingkat tautan mendapat acara untuk tautan itu, webhook tingkat ruang kerja mendapat acara 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": {
    "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 acara

Objek tautan

Objek klik

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

Payload siklus hidup tautan

Acara 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 penyiapan yang lebih mudah tanpa kode 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 balik layar tetapi menangani semua penyiapan 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 ulang 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 penangan webhook Anda
• Pertimbangkan untuk 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 payload yang diterima
4. 4
   Setelah diverifikasi, alihkan 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.