Webhooks — 链接点击事件实时推送到你的服务器

为什么要用 Webhooks

点击数据实时到手，你可以在此基础上搭建自己的业务流程

实时推送

事件在点击发生的那一刻就会送达，不需要按计划轮询 API、等待数据更新。

每次点击的完整数据

国家、城市、设备、操作系统、浏览器、来源以及是否为机器人访问 —— 分析所需的字段一应俱全。

默认安全

每个请求都会用你自己的密钥进行 HMAC 签名，轻松区分真实事件和伪造请求。

可靠投递

服务器暂时不可用时会自动重试投递，所有尝试和状态都能在投递日志中查看。

典型使用场景

点击事件通常会被接入到这些地方

自建分析或 CRM

把每一次点击写入自己的数据库或 CRM，按你自己的方式生成报表。

聊天工具通知

让 Telegram、Slack 或 Discord 机器人实时播报新的点击事件，无需人工盯盘。

自动化流程

在 Zapier、Make 或 n8n 中搭建流程：一次点击事件就能触发任意后续动作。

Webhook 会推送什么内容

redirects.batch 事件：一个请求体打包某个时间窗口内的一批点击数据

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

默认情况下不会包含访客的 IP 地址（属于个人信息），只有在你为该 endpoint 明确开启后才会返回。

Webhooks 的能力

配置灵活、安全性强、投递结果可预期

批量投递事件

点击事件会按时间窗口打包批量投递（redirects.batch），有效减少对你服务器的请求次数。

自由选择范围

账户下全部链接、某个分组，或者单条链接 —— 只接收你真正需要的事件。

HMAC 签名

每个请求都会用你的密钥签名，密钥可随时重新生成。

自动重试与失效停用

服务器无法访问时会自动重试；长期无响应的 endpoint 会被自动停用。

投递日志

记录每一次投递的状态和请求体，出问题时可以快速定位原因。

测试推送（ping）

在真实流量到来之前，一键发送测试事件，验证接入是否正常。

丰富的事件字段

每次点击都包含 link_id、时间、国家、城市、操作系统、设备、浏览器、来源以及是否为机器人访问。

默认保护隐私

除非你在具体的 endpoint 中明确开启，否则不会发送 IP 地址。

免费试用

如何配置 Webhook

五个步骤，从填写服务器 URL 到接收持续的点击事件流

1

创建 endpoint

注册 Lix.li 账号，打开 Webhooks 页面，填写你的服务器 URL —— Lix.li 会把点击事件发送到这里。

2

选择推送范围

决定哪些链接的点击事件会被推送：账户下全部链接、某个分组，或者单条链接。

3

保存签名密钥

Lix.li 会生成一个密钥。每个请求都会用它进行 HMAC 签名 —— 校验请求头中的签名，确认事件确实来自 Lix.li。

4

发送一次测试请求

点击"测试"（ping），确认你的服务器能正常接收请求并返回 2xx 状态码。这样可以在真实流量之前先验证接入是否正确。

5

关注投递日志

日志中能看到每一次投递、状态以及重试记录。服务器不可用时会自动重试投递，长期失效的 endpoint 会被自动停用。

接入 Webhook

Webhooks 常见问题

什么是 Webhook？

Webhook 是 Lix.li 在事件发生时主动发送到你服务器的 HTTP 通知。你不需要轮询任何 API，用户点击链接的瞬间数据就会自动送达。

会推送哪些事件？

你的短链接被点击的事件。事件会以批次形式送达（event_type = redirects.batch），每次点击都包含时间、国家、城市、操作系统、设备、浏览器、来源以及是否为机器人访问。

数据是什么格式？

HTTP POST 传输的 JSON。请求体里包含一些元信息字段（delivery_id、时间窗口、count），以及一个 events 数组，里面是每次点击的详细数据。本页有完整的请求体示例。

如何确认请求确实来自 Lix.li？

每个请求都会基于你的密钥进行 HMAC 签名 —— 校验请求头中的签名和请求体即可过滤伪造请求。密钥可以随时重新生成（轮换）。

如果我的服务器临时不可用怎么办？

投递会自动重试。如果 endpoint 长时间无响应，会被临时停用，所有尝试及其状态都会保留在投递日志中，事件不会悄无声息地丢失。

能只接收特定链接的事件吗？

可以。范围可以自由选择：账户下全部链接、某个分组的链接，或者单条链接，这样就不会给服务器带来不必要的流量。

会传输访客的 IP 地址吗？

默认不会，因为这属于个人信息。只有在该 endpoint 的设置中明确开启后，IP 才会包含在事件数据里。

哪个套餐能使用 Webhooks？

Webhooks 是 Premium 套餐的功能。注册账号并升级到 Premium 即可接入你的 endpoint。

基于点击事件搭建你自己的集成

几分钟即可完成 Webhook 接入，让点击数据准确送达你需要的地方。

Lix.li 的 Webhooks 是一种自动获取短链接点击通知的方式。你不需要不停地轮询 API，只要填写自己服务器的 URL，Lix.li 就会在用户点击的那一刻发送 HTTP POST 请求。这是短链接领域经典的 HTTP callback 模式，能让点击事件实时进入你的系统。

每个请求体都是一个 redirects.batch 事件，内含一个点击数组：每次点击都带有时间、国家、城市、浏览器、操作系统、设备、来源以及是否为机器人访问等字段。你可以把这些数据存入自己的数据库或 CRM，转发成 Telegram、Slack、Discord 里的点击通知，也可以作为 Zapier、Make、n8n 中的触发条件。请求由 HMAC 签名保护：校验请求头中的签名即可过滤伪造请求，密钥也可以随时重新生成。

投递结果可预期：服务器出现故障时事件会自动重试，长期失效的 endpoint 会被临时停用，所有投递尝试都能在日志中查到。你可以把范围限定为全部链接、某个分组或单条链接，还能在正式流量到来之前用测试推送（ping）验证接入。Webhooks 可以和 Lix.li 的短链接、二维码、数据统计功能配合使用，属于 Premium 套餐的能力。