网络钩子
网络钩子允许您接收关于链接的实时通知——无论是在点击时,还是在创建、更新或删除时。当发生每个事件时,Linkly 会向您指定的 URL 发送 POST 请求,其中包含详细信息。
用例
- 自动化平台:当链接被点击时在 Make 或 Zapier 中触发工作流
- 自定义分析:将点击数据发送到您自己的分析系统
- CRM 更新:当客户点击链接时更新客户记录
- Slack 通知:在重要链接被点击时在 Slack 中获得通知
- 潜在客户跟踪:跟踪潜在客户何时与您的链接互动
提示:对于大多数自动化用例,我们的 Make 集成 或 Zapier 集成 比自定义网络钩子更容易设置。它们包括由网络钩子驱动的即时点击触发器,无需编码。
如何设置链接级别网络钩子
转到链接并点击您要配置的链接。
向下滚动到网络钩子部分。
输入您的网络钩子 URL,每行一个。
您可以添加多个网络钩子 URL。当链接被点击时,所有 URL 都将接收相同的有效载荷。

点击保存。
链接级别网络钩子仅在特定链接被点击时触发。
如何设置工作区级别网络钩子
转到设置(侧边栏中的齿轮图标)。
点击工作区设置
输入您的网络钩子 URL,每行一个。
您可以添加多个网络钩子 URL。当工作区中任何链接被点击时,所有 URL 都将接收相同的有效载荷。

点击保存设置。
工作区级别网络钩子对工作区中任何链接的每次点击都会触发。
注意:如果在两个级别上都配置了网络钩子,该链接上的点击将同时触发两者。
事件
每个网络钩子都会接收其范围内的所有事件类型——链接级别网络钩子获取该链接的事件,工作区级别网络钩子获取工作区中每个链接的事件。检查顶级 event 字段以区分它们:
event | 发送时机 |
|---|---|
click | 短链接被点击时。包含访客请求数据的 click 对象。 |
link.created | 在工作区中创建新链接时。 |
link.updated | 链接的设置更改时。在每次更新时触发,包括自动保存的编辑,因此您可能在一个编辑会话中收到多个。 |
link.deleted | 链接被删除时。link 对象保留删除前的 slug 和域。 |
网络钩子有效载荷
点击有效载荷
当发生点击时,Linkly 会发送以下 JSON 有效载荷的 POST 请求:
{
"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",
"metadata": {
"order_id": "A-10293",
"crm_contact_id": "3f2b8c1e-9a47-4d0e-b6a5-1c2d3e4f5a6b"
},
"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"
}
}
}
有效载荷字段
事件信息
| 字段 | 描述 |
|---|---|
event | click、link.created、link.updated 或 link.deleted |
timestamp | 点击的 ISO 8601 时间戳 |
链接对象
| 字段 | 描述 |
|---|---|
id | 唯一链接标识符 |
name | 链接昵称 |
url | 原始目标 URL |
full_url | 短链接 URL |
domain | 自定义域(如已配置) |
slug | URL 路径/slug |
metadata | 您自己附加到链接的键值数据,例如来自您自己系统的 ID。始终是对象,如果未设置则为空。请参阅链接元数据 |
destination | 此次点击的实际目标(如果应用了规则,可能与 url 不同) |
workspace_id | 工作区标识符 |
enabled | 链接是否活跃 |
rules | 重定向规则数组(地理、设备、轮转) |
utm_* | 已配置的 UTM 参数 |
og_* | 已配置的 Open Graph 设置 |
点击对象
| 字段 | 描述 |
|---|---|
id | 此次点击的唯一标识符,26 字符 ULID。前导字符编码点击时间,因此 id 作为纯字符串按时间顺序排序 |
country | 两字母国家代码(例如,"US"、"GB") |
is_eu_country | 点击是否来自欧盟 |
platform | 设备平台(桌面、ios、android 等) |
browser_name | 浏览器名称(Chrome、Safari、Firefox 等) |
referer | 引荐 URL(如可用) |
isp | 互联网服务提供商 |
bot_name | 机器人标识符(人工点击为 null) |
destination | 此次点击的最终目标 URL |
params | 传递给链接的查询参数 |
隐私注意:IP 地址永远不会包含在网络钩子有效载荷中。
链接生命周期有效载荷
link.created、link.updated 和 link.deleted 事件共享一个形状。没有 click 对象——您获得 event、timestamp 和完整的 link:
{
"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,
"metadata": {
"order_id": "A-10293"
},
"rules": []
}
}
自动化平台集成
为了更容易地设置而不需要自定义编码,请使用我们的原生集成:
两个集成在幕后使用网络钩子,但会自动处理所有设置。
最佳实践
多个网络钩子
您可以添加多个网络钩子 URL(每行一个)。当点击发生时,所有 URL 都将接收相同的有效载荷。
错误处理
- 网络钩子是一次性发送——Linkly 不重试失败的传递
- 网络钩子失败永远不会影响重定向——用户始终到达目标
- 确保您的网络钩子端点响应速度快(建议 < 5 秒)
安全
- 为网络钩子 URL 使用 HTTPS 端点
- 在网络钩子处理程序中验证传入请求
- 考虑为您的网络钩子 URL 添加秘密参数以进行验证
测试
- 1使用 webhook.site 或 RequestBin 等服务设置网络钩子 URL
- 2点击您的链接
- 3检查收到的有效载荷
- 4验证后,切换到您的生产网络钩子 URL
API 访问
您也可以通过 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
有关详细信息,请参阅 API 文档。
网络钩子常见问题
网络钩子可以发送哪些事件?
网络钩子在四个事件上触发,由有效载荷中的事件字段标识。您会在链接被点击时获得 click,以及在链接更改时获得 link.created、link.updated 和 link.deleted。每个网络钩子都会接收其范围内的所有事件类型,因此请根据事件字段分支处理每一个。
为什么我的网络钩子没有触发?
检查您的网络钩子 URL 是否有效且可访问,以及网络钩子是否保存在链接或工作区上。对于点击事件,请注意网络钩子仅在实际记录点击时触发——被排除的 IP 或跳过的爬虫不会触发它们。
Linkly 是否支持用于转化跟踪的回发?
不支持。Linkly 网络钩子仅是出站的,在点击发生时触发。我们无法从联盟网络或广告平台接收回发数据。对于转化跟踪,请使用目标平台的原生跟踪、通过查询参数转发传递点击 ID,或使用我们的 BigQuery 集成来将点击数据与您的转化数据进行联接。
我应该使用网络钩子还是 Make/Zapier?
对于大多数自动化用例,我们的 Make 或 Zapier 集成更容易设置。它们在幕后使用网络钩子,但会自动处理所有配置。当您需要将数据发送到您自己的系统或需要对集成进行更多控制时,使用自定义网络钩子。
谁可以设置网络钩子?
单个链接上的网络钩子需要写入角色或更高级别。工作区网络钩子需要管理员或所有者角色。请参阅用户角色和权限。
每月追踪500次点击,包含所有功能。