セルフホストn8nでElidoを使う

n8nはセルフホストのワークフロー自動化ツールです。Elidoコミュニティノードにより、n8nのビジュアルエディター内でネイティブのトリガーとアクションが使えます — HTTP Requestノードは不要です。

要件#

• n8n バージョン 0.220以上（コミュニティノードにはこの最低バージョンが必要）。
• コミュニティノードのインストールが有効なセルフホストn8n。クラウドのn8nプランではこれが制限される場合があります — プランを確認してください。
• ElidoワークスペースのAPIトークン。

ステップ1 — コミュニティノードをインストールする#

1. n8nで Settings → Community Nodes に移動します。
2. Install a community node をクリックします。
3. パッケージ名を貼り付けます：

   @elidoapp/n8n-nodes-elido
   

4. リスク通知に同意して Install をクリックします。
5. n8nが再起動します。再起動後、ノードピッカーで「Elido」を検索してください — Elidoのトリガーノードとアクションノードが表示されるはずです。

ステップ2 — Elido APIトークンを生成する#

1. Elidoで Dashboard → API Keys → New key に移動します。
2. ワークフローのニーズに基づいてスコープを選択します：
   • links:read — リンクの検索と一覧。
   • links:write — リンクの作成と更新。
   • analytics:read — クリック数とアナリティクスの読み取り。
3. トークンをコピーします。ek_ で始まります。

ステップ3 — n8nにElido認証情報を追加する#

1. n8nで Credentials → New Credential → Elido API に移動します。
2. API Token フィールドにトークンを貼り付けます。
3. ワークスペースはトークンから自動検出されます。Save をクリックします。

複数の認証情報（Elidoワークスペースごとに1つ）を作成して、個々のノードで参照できます。

利用可能なトリガー#

トリガー	いつ発火するか
Link Clicked	ワークスペースの任意のリンクへのすべてのクリック（またはタグ/スラグでフィルタリング）
Conversion Recorded	コンバージョンが記録されるたびに
Threshold Exceeded	リンクのクリック数が設定値を超えたとき

トリガーはElidoのウェブフックシステムを内部で使用します。ワークフローをアクティブにすると、n8nがウェブフックURLを自動的に登録します。

利用可能なアクション#

アクション	機能
Create Link	新しい短縮リンクを作成
Update Link	宛先URL、スラグ、タグ、または有効期限を更新
List Links	フィルター付きのリンクのページ送りリストを返す
Look Up Link	スラグまたはIDでリンクを検索
Get Analytics	リンクのクリック数と内訳を返す

サンプルワークフロー — Baserowにクリックを記録する#

このワークフローはすべてのクリックで発火し、Baserowテーブルに行を書き込みます（n8nセットアップでよく使われるAirtableのセルフホスト代替）。

[Elido Trigger: Link Clicked]
      ↓
[Baserow: Create Row]
  - Table: "Click Log"
  - Slug: {{ $json.slug }}
  - Country: {{ $json.country }}
  - Device: {{ $json.device }}
  - Clicked At: {{ $json.clicked_at }}

設定手順：

1. Elido トリガーをキャンバスにドラッグします。認証情報を選択します。トリガータイプを「Link Clicked」に設定します。
2. Baserow ノードをドラッグします。接続します。Baserowのベースとテーブルを設定します。
3. 上記のようにフィールドをマッピングします。
4. Activate workflow をクリックします。

サンプルワークフロー — ウェブフックからリンクを作成する#

よりシンプルなパターン：外部システムがURLをn8nにPOSTし、n8nがElidoでそれを短縮して短縮URLを返します。

[Webhook node: POST /shorten]
      ↓
[Elido Action: Create Link]
  - Destination URL: {{ $json.body.url }}
  - Tag: {{ $json.body.tag }}
      ↓
[Respond to Webhook]
  - Body: { "short_url": "{{ $json.short_url }}" }

トラブルシューティング#

インストール後にコミュニティノードが表示されない — n8nはコミュニティノードのインストール後に完全な再起動が必要です。n8nをDockerで実行している場合は、コンテナを再起動してください：docker restart n8n。

ノードのテスト時に「Invalid credentials」 — APIトークンが間違っているかスコープが正しくありません。ワークフローに必要なスコープで新しいトークンを生成し、n8nの認証情報を更新してください。

トリガーが発火しない — ワークフローがアクティブであることを確認してください（ワークフローエディターの右上のトグル）。非アクティブなワークフローはウェブフックを登録しないため、Elidoはイベントを送信しません。

ElidoによってウェブフックURLが拒否される — n8nのウェブフックURLはインターネット（またはElidoのサーバー）から到達可能である必要があります。ローカルマシンや私用ネットワークでn8nを実行している場合は、トンネル（Cloudflare Tunnel、ngrokなど）を設定し、n8nの環境変数の WEBHOOK_URL をトンネルアドレスに向けてください。