集成

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)

  1. 在 n8n 中,添加一个 Webhook 节点。将其切换为 POST、生产模式,并复制生产环境 URL。
  2. 将该 URL 粘贴到 Letlink 的集成 → Webhook 下。
  3. 每次记录的点击都会以 link_visited JSON 对象送达。将 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 次点击。
通过 HTTP Request 节点列出链接
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

还有疑问?

我们随时为你提供帮助。联系我们,我们会尽快回复。