Webhooks

Webhooks cho phép bạn nhận thông báo theo thời gian thực về các liên kết của mình — 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(s) được chỉ định của bạn với thông tin chi tiết về mỗi sự kiện.

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 đế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 các 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 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 Zapier của chúng tôi sẽ dễ thiết lập hơn so với webhooks tùy chỉnh. Chúng bao gồm các trích kích hoạt nhấp tức thời được cung cấp bởi webhooks, 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 trên 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 sự kiện cho liên kết đó, một webhook cấp không gian làm việc nhận 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 cao nhất để phân biệt chúng:

Tải trọng webhook

Tải trọng nhấp

Khi một nhấp xảy ra, Linkly gửi một yêu cầu POST với tải trọng 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 tải trọng

Thông tin sự kiện

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

Đối tượng nhấp

Ghi chú về Quyền riêng tư: Địa chỉ IP không bao giờ được bao gồm trong tải trọng webhook.

Tải trọng 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

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

• Make Integration - Nền tảng tự động hóa trực quan với trích kích hoạt nhấp tức thời
• Zapier Integration - 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 dưới mui capô nhưng xử lý tất cả thiết lập tự động.

Các thực hành tốt nhất

Nhiều webhooks

Bạn có thể thêm nhiều URL webhook (mỗi URL một dòng). Tất cả các URL sẽ nhận được tải trọng giống nhau khi một nhấp xảy ra.

Xử lý lỗi

• Webhooks là fire-and-forget - Linkly không thử lại các giao hàng 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 (< 5 giây được khuyên dùng)

Bảo mật

• Sử dụng đ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

Kiểm tra

1. 1
   Thiết lập URL webhook bằng cách sử dụng một 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 tải trọng được 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 lập 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.