网络钩子

网络钩子允许您在点击链接时接收实时通知。点击发生时，Linkly 会向您指定的 URL 发送 POST 请求，包含有关点击的详细信息。

用例

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

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

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

网络钩子负载

点击发生时，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 地址永远不会包含在网络钩子负载中。

自动化平台集成

为了更容易地设置而无需自定义编码，请使用我们的原生集成：

• 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 文档。