Webhooks

Webhooks cho phép bạn nhận thông báo real-time về các liên kết của bạn — cả khi chúng được nhấp và khi chúng được tạo, cập nhật hoặc xóa. Linkly gửi yêu cầu POST đến URL được chỉ định của bạn với thông tin chi tiết về mỗi sự kiện.

Các trường hợp sử dụng

• Nền tảng tự động hóa: Kích hoạt quy trình làm việc trong Make hoặc Zapier khi các liên kết được nhấp
• Phân tích tùy chỉnh: Gửi dữ liệu nhấp chuột đến hệ thống phân tích của riêng bạn
• Cập nhật CRM: Cập nhật hồ sơ khách hàng khi họ nhấp vào liên kết
• Thông báo Slack: Nhận thông báo trong Slack khi các liên kết quan trọng được nhấp
• Theo dõi khách hàng tiềm năng: Theo dõi khi các khách hàng tiềm năng tương tác với các liên kết của bạn

Mẹo: Đối với hầu hết các trường hợp sử dụng tự động hóa, tích hợp Make hoặc tích hợp Zapier của chúng tôi dễ thiết lập hơn webhooks tùy chỉnh. Chúng bao gồm các kích hoạt nhấp chuột tức thì được hỗ trợ bởi webhooks, mà không cần mã hóa.

Lưu ý: Nếu bạn định cấu hình webhooks ở cả hai cấp độ, cả hai sẽ kích hoạt cho các nhấp chuột vào liên kết đó.

Sự kiện

Mỗi webhook nhận tất cả các loại sự kiện cho phạm vi của nó — một webhook cấp liên kết nhận các sự kiện cho liên kết đó, một webhook cấp không gian làm việc nhận các sự kiện cho mọi liên kết trong không gian làm việc. Kiểm tra trường event cấp trên để phân biệt chúng:

Payload webhook

Payload nhấp chuột

Khi xảy ra nhấp chuột, Linkly gửi yêu cầu POST với payload JSON sau:

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

Các trường payload

Thông tin sự kiện

Đối tượng liên kết

Đối tượng nhấp chuột

Lưu ý về Quyền riêng tư: Địa chỉ IP không bao giờ được đưa vào payload webhook.

Payload vòng đời liên kết

Các sự kiện link.created, link.updated và link.deleted chia sẻ một hình dạng. Không có đối tượng click — bạn nhận event, timestamp và link đầy đủ:

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

Tích hợp nền tảng tự động hóa

Để thiết lập dễ dàng hơn mà không cần mã hóa tùy chỉnh, hãy sử dụng các tích hợp gốc của chúng tôi:

• Tích hợp Make - Nền tảng tự động hóa trực quan với các kích hoạt nhấp chuột tức thì
• Tích hợp Zapier - Kết nối Linkly với hàng nghìn ứng dụng mà không cần mã

Cả hai tích hợp đều sử dụng webhooks bên dưới nhưng xử lý tất cả các thiết lập tự động.

Các phương pháp hay nhất

Nhiều webhooks

Bạn có thể thêm nhiều URL webhook (một trên mỗi dòng). Tất cả các URL sẽ nhận cùng một payload khi xảy ra nhấp chuột.

Xử lý lỗi

• Webhooks là fire-and-forget - Linkly không thử lại các lần gửi không thành công
• Các lỗi webhook không bao giờ ảnh hưởng đến chuyển hướng - người dùng luôn đến được đích của họ
• Đảm bảo điểm cuối webhook của bạn phản hồi nhanh chóng (khuyến nghị < 5 giây)

Bảo mật

• Sử dụng các điểm cuối HTTPS cho URL webhook
• Xác thực các yêu cầu đến trong trình xử lý webhook của bạn
• Cân nhắc thêm tham số bí mật vào URL webhook của bạn để xác minh

Thử nghiệm

1. 1
   Thiết lập URL webhook bằng cách sử dụng dịch vụ như webhook.site hoặc RequestBin
2. 2
   Nhấp vào liên kết của bạn
3. 3
   Kiểm tra payload đã nhận
4. 4
   Sau khi xác minh, chuyển sang URL webhook sản xuất của bạn

Truy cập API

Bạn cũng có thể quản lý webhooks theo chương trình thông qua 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

Xem Tài liệu API để biết chi tiết.