网络钩子

网络钩子允许您接收关于您的链接的实时通知——既包括链接被点击时，也包括链接被创建、更新或删除时。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": {
    "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 文档。