Webhooks

Webhooks cho phép bạn nhận thông báo 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 một 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.

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 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 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 so với 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, 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 lần nhấp chuột trên liên kết đó.

Các 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 cao nhất để phân biệt chúng:

Tải trọng webhook

Tải trọng nhấp chuột

Khi xảy ra lần nhấp chuột, 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": {
    "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 chuột

Lưu ý về bảo mật: Các địa chỉ IP không bao giờ được đưa vào 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 được 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 hình ảnh với 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 ngàn ứng dụng mà không cần mã

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

Các thực tiễn tốt nhất

Nhiều webhooks

Bạn có thể thêm nhiều URL webhook (mỗi cái một dòng). Tất cả các URL sẽ nhận được cùng một tải trọng khi xảy ra lần 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 (< 5 giây được khuyến nghị)

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 một 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 một 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 nhận được
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.