集成
Zapier
每次记录访问时触发 Zap,并从其他应用创建短链接。
Zapier 与你自己的脚本调用的是同一个 REST API。你需要 Growth 或 Ultimate 工作区,以及从集成 → Zapier(或 API——两者是同一个令牌)获取的 API 令牌。
连接应用
- 在 Zapier 中,添加 Letlink 连接,并在提示时粘贴 API 令牌。
- Zapier 调用
GET /api/v1/auth/me进行验证。 - 如果测试返回 403,说明工作区套餐尚不包含 API——请升级到 Growth。
触发器:链接被访问
这是一个基于 link_visited 事件的 REST Hook。当你开启 Zap 时,Zapier 会将其 Catch URL POST 到 /api/v1/hooks/subscribe。之后每次记录的点击都会以 Webhook 数据结构 POST 过去(见 Webhook)。在映射字段时,Zapier 还可能调用 GET /api/v1/visits 拉取示例数据——该端点以相同结构返回最近 50 次点击。
Zap 中有用的字段:link_shortcode、link_destination_url、visitor_device_type、visitor_browser、visitor_referrer、visitor_variation、utm_source、utm_campaign、instagram_username。
操作:创建链接
对应 POST /api/v1/links。你可以传入 type、destination、short_code、title、domain 以及智能类型字段(ios_url、android_url 等)。Free 套餐使用智能类型或工作区超出上限时,会在 Zap 的运行日志中返回错误。
运维说明
- 在 Letlink 中重新生成令牌会断开 Zapier 连接,直到你粘贴新的令牌。
- 关闭 Zap 应会取消订阅 Hook。如果残留了 Catch URL,请在“集成 → Webhook”中删除。
- 高流量链接每记录一次点击就会触发一次 Zap 运行。请在 Zapier 中进行筛选(例如只保留
visitor_variation=qr),而不要再记录第二个短码。