Webhook

Trên Growth và Ultimate, Letlink POST JSON tới mọi URL HTTPS đã đăng ký trong không gian làm việc khi một lượt nhấp được ghi nhận. Chủ sở hữu và quản trị viên thêm hoặc xóa URL trong Tích hợp → Webhook. Thành viên có thể xem danh sách nhưng không thể thay đổi.

Thêm endpoint

1. Chuẩn bị một URL HTTPS chấp nhận POST với Content-Type: application/json. HTTP sẽ bị từ chối.
2. Dán vào Tích hợp → Webhook và lưu. Tên sự kiện là link_visited.
3. Nhấp vào một liên kết rút gọn của bạn (từ mạng chưa vượt hạn mức hằng tháng). Bạn sẽ thấy một yêu cầu trong vài giây — việc gửi được xếp hàng đợi, không diễn ra ngay trong lúc chuyển hướng.

Bạn cũng có thể đăng ký từ API: POST /api/v1/hooks/subscribe với target_url và event tùy chọn (mặc định là link_visited). REST Hook của Zapier gọi chính cặp route subscribe/unsubscribe này.

Dữ liệu gửi

Phần thân là đối tượng lượt truy cập chuẩn. Các trường UTM hoặc cửa hàng trống sẽ là 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"
}

Khi webhook không kích hoạt

• Không gian làm việc đang dùng gói Free hoặc Solo (allowsWebhooks đang tắt).
• Đã chạm hạn mức lượt nhấp được theo dõi hằng tháng — chuyển hướng vẫn diễn ra, không có dòng dữ liệu nào được ghi, nên không có gì được gửi đi.
• Giới hạn lượt truy cập theo thiết bị đã trả về 429 trước khi lượt nhấp được lưu.
• Một quy tắc truy cập theo quốc gia đã từ chối khách truy cập. Lượt truy cập bị chặn không bao giờ được lưu thành lượt nhấp.
• URL đích đang ngừng hoạt động. Việc gửi được thực hiện theo khả năng tốt nhất và không bao giờ được làm chậm khách truy cập; các lần gửi thất bại sẽ không được thử lại từ trang này.

Ai nhận được gì

Hook được lưu theo từng người dùng. URL link_visited của mọi thành viên đều được thông báo khi có lượt nhấp vào bất kỳ liên kết nào trong không gian làm việc. Nếu hai đồng đội đều đăng ký Zapier, cả hai Zap đều chạy. Hãy xóa các URL không dùng để một Catch Hook còn sót lại không tiếp tục kích hoạt.