連携
n8n
3つの接続方法:Webhookトリガー、REST APIへのHTTPリクエスト、またはMCP Clientノード。
n8nは3つの異なる方法で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 |
| エージェントに使用状況を確認させ、リンクを作成させる | UltimateでのMCP Client |