网络钩子

网络钩子允许您接收有关链接的实时通知 — 包括被点击以及被创建、更新或删除的时间。Linkly 向您指定的 URL 发送 POST 请求，其中包含有关每个事件的详细信息。

用例

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

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

注意：如果您在两个级别都配置网络钩子，则该链接上的点击会触发两者。

事件

每个网络钩子接收其范围内的所有事件类型 — 链接级网络钩子获取该链接的事件，工作区级网络钩子获取工作区中每个链接的事件。检查顶级 event 字段以区分它们：

网络钩子有效负载

点击有效负载

发生点击时，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",
    "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"
    }
  }
}

有效负载字段

事件信息

链接对象

点击对象

隐私注意：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,
    "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 文档。