Webhook

Di Growth dan Ultimate, Letlink mengirim JSON melalui POST ke setiap URL HTTPS yang terdaftar di ruang kerja saat klik dicatat. Pemilik dan admin menambah atau menghapus URL di Integrasi → Webhook. Anggota dapat melihat daftarnya tetapi tidak dapat mengubahnya.

Tambahkan endpoint

1. Siapkan URL HTTPS yang menerima POST dengan Content-Type: application/json. HTTP ditolak.
2. Tempelkan ke Integrasi → Webhook lalu simpan. Nama event-nya adalah link_visited.
3. Klik salah satu tautan pendek Anda (dari jaringan yang belum melebihi batas bulanan). Anda akan melihat permintaan dalam beberapa detik — pengiriman dimasukkan ke antrean, bukan dijalankan langsung saat pengalihan.

Anda juga dapat berlangganan dari API: POST /api/v1/hooks/subscribe dengan target_url dan event opsional (default link_visited). Zapier REST Hooks memanggil pasangan rute subscribe/unsubscribe yang sama.

Payload

Body-nya adalah objek kunjungan kanonis. Kolom UTM atau toko yang kosong bernilai null.

{
  "visit_id": 42,
  "visit_time": "2026-09-09T18:01:22+00:00",
  "link_type": "utm",
  "link_shortcode": "summer",
  "link_domain": "letl.ink",
  "link_destination_url": "https://example.com/a",
  "utm_source": "newsletter",
  "utm_campaign": "sep",
  "utm_medium": "email",
  "google_play_app_url": null,
  "google_play_utm_source": null,
  "google_play_utm_campaign": null,
  "app_store_app_url": null,
  "app_store_ct": null,
  "instagram_username": null,
  "visitor_ip": "203.0.113.10",
  "visitor_browser": "Chrome",
  "visitor_device_type": "desktop",
  "visitor_referrer": "https://mail.example.com/",
  "visitor_variation": "hero-b"
}

Saat webhook tidak terpicu

• Ruang kerja menggunakan Free atau Solo (allowsWebhooks nonaktif).
• Batas klik terlacak bulanan sudah tercapai — pengalihan tetap terjadi, tidak ada baris yang ditulis, sehingga tidak ada yang dikirim.
• Batas kunjungan per perangkat mengembalikan 429 sebelum klik disimpan.
• Aturan akses negara menolak pengunjung ini. Kunjungan yang diblokir tidak pernah disimpan sebagai klik.
• URL target sedang tidak aktif. Pengiriman bersifat upaya terbaik dan tidak boleh menunda pengunjung; posting yang gagal tidak dicoba ulang dari halaman ini.

Siapa menerima apa

Hook disimpan per pengguna. URL link_visited milik setiap anggota diberi tahu untuk klik pada tautan mana pun di ruang kerja. Jika dua rekan tim masing-masing berlangganan Zapier, kedua Zap akan berjalan. Hapus URL yang tidak dipakai agar Catch Hook yang tertinggal tidak terus terpicu.