集成
n8n
三种接入方式:Webhook 触发器、调用 REST API 的 HTTP Request,或 MCP Client 节点。
n8n 可以通过三种不同的方式接入 Letlink。Webhook 和 REST API 适用于 Growth 和 Ultimate。MCP Client 节点需要 Ultimate。应用内页面位于集成 → n8n;即使你已经熟悉 API 文档,它也会显示你的令牌和 MCP URL。
1. Webhook 触发器(Growth 和 Ultimate)
- 在 n8n 中,添加一个 Webhook 节点。将其切换为 POST、生产模式,并复制生产环境 URL。
- 将该 URL 粘贴到 Letlink 的集成 → Webhook 下。
- 每次记录的点击都会以
link_visitedJSON 对象送达。将link_shortcode、visitor_variation、utm_campaign等映射到后续节点。
这是“有人点击时执行 X”的合适默认方式——向 Airtable 添加一行、通知另一个 Slack 工作区、补充 IP 信息、创建工单。
2. HTTP 请求(Growth 和 Ultimate)
使用 n8n 的 HTTP Request 节点调用 https://letl.ink/api/v1。将请求头 X-API-KEY 设为“集成 → n8n”中的令牌。常见调用:
GET /auth/me——连接测试。GET /links?domain=letl.ink——链接清单及点击总数。- 使用 JSON 调用
POST /links——从表单、CRM 或表格行创建短链接。 GET /visits——如果你不想使用推送式 Webhook,可以定时拉取最近 50 次点击。
GET https://letl.ink/api/v1/links?domain=letl.ink
Header: X-API-KEY = YOUR_TOKEN
3. MCP 客户端(Ultimate)
将 n8n 的 MCP Client 节点指向 Streamable HTTP https://letl.ink/mcp,并使用 Authorization: Bearer YOUR_TOKEN。这些工具与 Claude 和 ChatGPT 看到的相同:workspace_summary、list_links、get_link、get_recent_visits、create_link。当工作流需要向工作区*提问*,而不是自己解析 REST JSON 时,请使用这种方式。
选哪一种
| 职位 | 使用 |
|---|---|
| 实时响应点击 | Webhook 节点 |
| 每晚报告或清单同步 | 对 /links 或 /visits 发起 HTTP 请求 |
| 从其他系统创建链接 | HTTP 请求 POST /links |
| 让 AI 代理查看用量并创建链接 | Ultimate 上的 MCP Client |