Webhooks: lượt click vào link tự động chuyển về server của bạn

Lix.li gửi một sự kiện cho mỗi lượt click trực tiếp về URL của bạn qua HTTP POST — real-time, có chữ ký HMAC, giao hàng đáng tin cậy. Không cần polling API liên tục: dữ liệu tự động đến ngay khi có click.

Thiết lập webhook Xem định dạng dữ liệu

Real-time · chữ ký HMAC · retry và log giao hàng

# Lix.li itself sends POST to your server during transitions POST https://your-server.com/hooks X-Lix-Signature: sha256=9f86d0818884… Content-Type: application/json { "event_type": "redirects.batch", "count": 2, "events": [ { "link_id": 9053352, "country": "DE", "device": "mobile" } ] }

Vì sao nên dùng webhooks

Nhận dữ liệu click ngay tức thì và tự xây workflow của riêng bạn dựa trên đó

Real-time

Sự kiện đến ngay khi có click. Không cần polling API theo lịch rồi chờ cập nhật.

Dữ liệu đầy đủ cho từng click

Quốc gia, thành phố, thiết bị, hệ điều hành, trình duyệt, nguồn giới thiệu và cờ đánh dấu bot — mọi thứ bạn cần cho phân tích của riêng mình.

An toàn ngay từ đầu

Mỗi request đều được ký HMAC bằng secret của riêng bạn, giúp bạn dễ dàng phân biệt sự kiện thật với giả mạo.

Giao hàng đáng tin cậy

Nếu server của bạn tạm ngưng hoạt động, hệ thống sẽ tự động retry. Mọi lần thử và trạng thái đều hiển thị trong log giao hàng.

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

Sự kiện click thường được đưa về đâu

Lix.li POST
Hệ thống phân tích hoặc CRM riêng

Lưu từng lượt click vào database hoặc CRM của riêng bạn, rồi tự xây báo cáo theo đúng ý muốn.

Lix.li POST
Thông báo qua chat

Để bot Telegram, Slack hoặc Discord báo ngay khi có click mới, không cần kiểm tra thủ công.

Lix.li POST
Tự động hoá

Kích hoạt kịch bản trong Zapier, Make hoặc n8n: một sự kiện click trở thành trigger cho bất kỳ hành động nào tiếp theo.

Webhook chứa những gì

Sự kiện redirects.batch: một payload duy nhất gộp một loạt click trong một khoảng thời gian

{ "delivery_id": "d_01HXY9F0…", "event_type": "redirects.batch", "sent_at": "2026-08-04T10:15:00Z", "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" }, "count": 1, "truncated": false, "events": [ { "event_id": "e_9f86d0…", "link_id": 9053352, "datetime": "2026-08-04T10:14:12Z", "country": "DE", "city": "Berlin", "browser": "Chrome", "os": "Android", "device": "mobile", "ref_domain": "t.me", "group_id": null, "is_bot": false } ] }

Địa chỉ IP của khách truy cập không được gửi mặc định (vì là dữ liệu cá nhân) — chỉ được thêm vào khi bạn chủ động bật cho endpoint đó.

Webhooks có thể làm gì

Cấu hình linh hoạt, bảo mật chắc chắn, giao hàng có thể dự đoán được

Giao sự kiện theo batch

Click được gộp lại (redirects.batch) trong một khoảng thời gian — giúp giảm số lượng request tới server của bạn.

Phạm vi tuỳ chọn

Toàn bộ link trong tài khoản, một nhóm cụ thể, hoặc một link duy nhất — chỉ nhận đúng những sự kiện bạn cần.

Chữ ký HMAC

Mọi request đều được ký bằng secret của bạn. Bạn có thể tạo lại secret bất cứ lúc nào.

Tự retry và tự tắt endpoint

Server không thể truy cập được sẽ được retry; endpoint "chết" liên tục sẽ tự động bị vô hiệu hoá.

Log giao hàng

Lịch sử mọi lần gửi kèm trạng thái và nội dung — dễ dàng truy ra nguyên nhân khi có sự cố.

Gửi thử (ping)

Kiểm tra tích hợp chỉ với một cú click trước khi có traffic thật — server của bạn sẽ nhận một sự kiện thử nghiệm.

Dữ liệu sự kiện phong phú

link_id, thời gian, quốc gia, thành phố, hệ điều hành, thiết bị, trình duyệt, nguồn giới thiệu và cờ bot cho mỗi lượt click.

Bảo mật quyền riêng tư mặc định

Địa chỉ IP không được gửi trừ khi bạn chủ động bật cho một endpoint cụ thể.

Dùng thử miễn phí

Cách thiết lập webhook

Năm bước — từ URL server của bạn đến dòng sự kiện click liên tục

1
Tạo endpoint

Đăng ký Lix.li, mở mục Webhooks và nhập URL server của bạn — nơi Lix.li sẽ gửi các sự kiện click đến.

2
Chọn phạm vi

Quyết định muốn nhận sự kiện của link nào: toàn bộ link trong tài khoản, một nhóm cụ thể, hoặc một link duy nhất.

3
Lưu secret để ký

Lix.li sẽ cấp cho bạn một secret key. Mọi request đều được ký HMAC — đối chiếu chữ ký ở header để xác nhận sự kiện thực sự đến từ Lix.li.

4
Gửi một request thử

Nhấn "Test" (ping) và kiểm tra xem server của bạn có nhận request và trả về mã 2xx không. Nhờ vậy bạn xác thực được tích hợp trước khi có traffic thật.

5
Theo dõi log giao hàng

Log hiển thị mọi lần gửi, trạng thái và các lần retry. Khi server không thể truy cập, hệ thống sẽ tự retry, còn endpoint "chết" liên tục sẽ tự động bị vô hiệu hoá.

Thiết lập webhook

Câu hỏi thường gặp về webhooks

Webhook là một thông báo HTTP mà Lix.li tự động gửi về server của bạn mỗi khi có sự kiện xảy ra. Bạn không cần polling bất kỳ API nào — dữ liệu tự động đến ngay khi link của bạn được click.
Các lượt click vào link rút gọn của bạn. Sự kiện được gửi theo batch (event_type = redirects.batch); mỗi click mang theo thời gian, quốc gia, thành phố, hệ điều hành, thiết bị, trình duyệt, nguồn giới thiệu và cờ đánh dấu bot.
JSON qua HTTP POST. Phần thân chứa các trường metadata (delivery_id, khoảng thời gian, count) cùng mảng events chứa dữ liệu của từng click. Trang này có ví dụ đầy đủ về nội dung request.
Mọi request đều được ký HMAC dựa trên secret key của bạn — đối chiếu chữ ký ở header với nội dung request để lọc ra các request giả mạo. Bạn có thể tạo lại secret (rotate) bất cứ lúc nào.
Hệ thống sẽ tự động retry việc giao hàng. Nếu endpoint không phản hồi trong thời gian dài, nó sẽ tạm thời bị vô hiệu hoá, và mọi lần thử cùng trạng thái vẫn được lưu trong log giao hàng — không sự kiện nào biến mất mà bạn không hay biết.
Có. Bạn có thể chọn phạm vi: toàn bộ link trong tài khoản, link thuộc một nhóm cụ thể, hoặc một link duy nhất. Nhờ vậy server của bạn không phải nhận traffic không cần thiết.
Mặc định là không, vì đây là dữ liệu cá nhân. IP chỉ được đưa vào sự kiện khi bạn chủ động bật trong cài đặt của endpoint đó.
Webhooks chỉ có ở gói Premium. Hãy đăng ký và nâng cấp lên Premium để kết nối endpoint của bạn.

Xây dựng tích hợp dựa trên sự kiện click

Thiết lập webhook chỉ trong vài phút — và nhận dữ liệu click đúng nơi bạn cần.

Webhooks của Lix.li là cách để nhận thông báo click trên link rút gọn của bạn một cách tự động. Thay vì phải polling API liên tục, bạn chỉ cần cung cấp URL server của mình, và Lix.li sẽ gửi HTTP POST đến đó ngay khi có click. Đây là một dạng HTTP callback kinh điển cho link rút gọn, giúp đưa sự kiện click vào hệ thống của bạn theo thời gian thực.

Mỗi phần thân request là một sự kiện redirects.batch chứa một mảng các lượt click: mỗi click mang theo thời gian, quốc gia, thành phố, trình duyệt, hệ điều hành, thiết bị, nguồn giới thiệu và cờ đánh dấu bot. Bạn dễ dàng đưa dữ liệu này vào database hoặc CRM riêng, biến chúng thành thông báo click trên Telegram, Slack hoặc Discord, hoặc dùng làm trigger trong Zapier, Make và n8n. Các request được bảo vệ bằng chữ ký HMAC: bạn đối chiếu chữ ký ở header với phần thân để loại bỏ các request giả mạo, và có thể tạo lại secret bất cứ khi nào cần.

Việc giao hàng luôn có thể dự đoán được: nếu server gặp sự cố, sự kiện sẽ được retry, endpoint "chết" liên tục sẽ tạm thời bị vô hiệu hoá, và mọi lần thử đều hiện trong log giao hàng. Bạn có thể giới hạn phạm vi ở toàn bộ link, một nhóm, hoặc chỉ một link, và xác thực tích hợp bằng cách gửi thử (ping) trước khi có traffic thật. Webhooks hoạt động song song với link rút gọn Lix.li thông thường, mã QR và số liệu thống kê, và có sẵn ở gói Premium.

Thiết lập webhook