网络钩子

网络钩子允许您接收关于链接的实时通知——无论是在点击时,还是在创建、更新或删除时。当发生每个事件时,Linkly 会向您指定的 URL 发送 POST 请求,其中包含详细信息。

用例

  • 自动化平台:当链接被点击时在 Make 或 Zapier 中触发工作流
  • 自定义分析:将点击数据发送到您自己的分析系统
  • CRM 更新:当客户点击链接时更新客户记录
  • Slack 通知:在重要链接被点击时在 Slack 中获得通知
  • 潜在客户跟踪:跟踪潜在客户何时与您的链接互动

提示:对于大多数自动化用例,我们的 Make 集成 或 Zapier 集成 比自定义网络钩子更容易设置。它们包括由网络钩子驱动的即时点击触发器,无需编码。

如何设置链接级别网络钩子

1

转到链接并点击您要配置的链接。

2

向下滚动到网络钩子部分。

3

输入您的网络钩子 URL,每行一个。

您可以添加多个网络钩子 URL。当链接被点击时,所有 URL 都将接收相同的有效载荷。

输入您的网络钩子 URL,每行一个。
输入您的网络钩子 URL,每行一个。
4

点击保存。

链接级别网络钩子仅在特定链接被点击时触发。

如何设置工作区级别网络钩子

1

转到设置(侧边栏中的齿轮图标)。

2

点击工作区设置

3

输入您的网络钩子 URL,每行一个。

您可以添加多个网络钩子 URL。当工作区中任何链接被点击时,所有 URL 都将接收相同的有效载荷。

输入您的网络钩子 URL,每行一个。
输入您的网络钩子 URL,每行一个。
4

点击保存设置。

工作区级别网络钩子对工作区中任何链接的每次点击都会触发。

注意:如果在两个级别上都配置了网络钩子,该链接上的点击将同时触发两者。

事件

每个网络钩子都会接收其范围内的所有事件类型——链接级别网络钩子获取该链接的事件,工作区级别网络钩子获取工作区中每个链接的事件。检查顶级 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"
    }
  }
}

有效载荷字段

事件信息

字段描述
eventclick、link.created、link.updated 或 link.deleted
timestamp点击的 ISO 8601 时间戳

链接对象

字段描述
id唯一链接标识符
name链接昵称
url原始目标 URL
full_url短链接 URL
domain自定义域(如已配置)
slugURL 路径/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": []
  }
}

自动化平台集成

为了更容易地设置而不需要自定义编码,请使用我们的原生集成:

  • Make 集成 - 具有即时点击触发器的可视化自动化平台
  • Zapier 集成 - 将 Linkly 连接到数千个应用,无需编码

两个集成在幕后使用网络钩子,但会自动处理所有设置。

最佳实践

多个网络钩子

您可以添加多个网络钩子 URL(每行一个)。当点击发生时,所有 URL 都将接收相同的有效载荷。

错误处理

  • 网络钩子是一次性发送——Linkly 不重试失败的传递
  • 网络钩子失败永远不会影响重定向——用户始终到达目标
  • 确保您的网络钩子端点响应速度快(建议 < 5 秒)

安全

  • 为网络钩子 URL 使用 HTTPS 端点
  • 在网络钩子处理程序中验证传入请求
  • 考虑为您的网络钩子 URL 添加秘密参数以进行验证

测试

  1. 1
    使用 webhook.site 或 RequestBin 等服务设置网络钩子 URL
  2. 2
    点击您的链接
  3. 3
    检查收到的有效载荷
  4. 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 或跳过的爬虫不会触发它们。

为什么网络钩子有效载荷中的某些字段为 null?

如果信息不可用(例如,没有引荐人)、隐私设置阻止了收集,或点击来自机器人(在这种情况下 bot_name 将被填充),某些字段可能为 null。

Linkly 会重试失败的网络钩子传递吗?

不会。网络钩子是一次性发送。失败的传递不会重试,Linkly 不会跟踪网络钩子传递状态。网络钩子请求在 5 秒后超时。

Linkly 是否支持用于转化跟踪的回发?

不支持。Linkly 网络钩子仅是出站的,在点击发生时触发。我们无法从联盟网络或广告平台接收回发数据。对于转化跟踪,请使用目标平台的原生跟踪、通过查询参数转发传递点击 ID,或使用我们的 BigQuery 集成来将点击数据与您的转化数据进行联接。

我应该使用网络钩子还是 Make/Zapier?

对于大多数自动化用例,我们的 Make 或 Zapier 集成更容易设置。它们在幕后使用网络钩子,但会自动处理所有配置。当您需要将数据发送到您自己的系统或需要对集成进行更多控制时,使用自定义网络钩子。

我可以在链接和工作区上都有网络钩子吗?

是的。如果在两个级别上都配置了网络钩子,该链接被点击时两者都会触发。如果您希望有工作区范围的日志记录加上特定链接的特定操作,这很有用。

谁可以设置网络钩子?

单个链接上的网络钩子需要写入角色或更高级别。工作区网络钩子需要管理员或所有者角色。请参阅用户角色和权限。

可用套餐

Business及以上套餐可用

比较套餐 →

每月追踪500次点击,包含所有功能。