# Zapier → n8n ノード対応チートシート

ebis AI 配布 / 利用条件は同梱 LICENSE 参照。

## 主要ノード対応表

| Zapier 概念 | n8n 対応ノード | 備考 |
|---|---|---|
| Trigger (Webhook) | **Webhook** | URL 取得後、外部からの POST/GET をトリガー |
| Trigger (Schedule) | **Schedule Trigger** | cron 式 / 間隔指定 |
| Trigger (Polling) | **HTTP Request** + **Schedule Trigger** | 5-15 分間隔の polling は自前構築可 |
| Trigger (Email) | **Email Trigger (IMAP)** | IMAP 設定で受信メール起動 |
| Trigger (Form) | **Form Trigger** | n8n 組込フォーム or 外部フォーム + Webhook |
| Action (App-specific) | **HTTP Request** | API 仕様書があれば全 SaaS に対応可、URL/method/headers/body を直書き |
| Action (公式統合) | **<App> Node** (例: Slack / Notion / Google Sheets) | 認証は Credentials で管理 |
| Filter | **IF** | 単純な真偽分岐 |
| Paths | **Switch** | 複数経路の分岐 |
| Formatter | **Set** / **Function** / **Edit Fields** | データ加工 |
| Delay | **Wait** | 時間/日付指定の停止 |
| Code (Python/JS) | **Code** | JavaScript / Python (pyodide) |
| Loop | **Split In Batches** + **Loop Over Items** | 配列処理は組み込み |
| Error handler (Replay) | **Error Trigger** workflow | エラー専用 workflow を別途用意 |

## 認証 (Credentials) 移行のポイント

Zapier 側で connect 済の OAuth/API キーは **n8n 側で再認証**が必要。手順:

1. n8n の `Credentials` メニューで対応サービス選択
2. OAuth の場合は同じアプリの Client ID/Secret を流用 (or 新規作成)
3. API Key の場合は元のキーを再入力 (Zapier ダッシュボードから export 不可、各 SaaS から再発行が安全)

## ワークフロー移行の現実的進行プラン

### 1. 棚卸し (Day 0)

- Zapier の全 Zap を CSV export (Tools > Export Zaps)
- 「Active / Paused / Errored」で分類
- 「過去 30 日 0 task の Zap」「同じトリガーの重複」「テスト用残存」を **削除候補**として印
- 残った Zap だけが移行対象 = 工数見積りの起点

### 2. 優先順位付け (Day 0-1)

| 優先度 | 条件 | 移行タイミング |
|---|---|---|
| 高 | コアビジネス (受注・問合せ・請求) | 最優先で n8n に移植 |
| 中 | 通知系 (Slack/メール飛ばすだけ) | 次手 |
| 低 | レポート定期生成 / 内部 dump | 余裕期 |

### 3. n8n 上での再現 (Day 1-N)

- ノード対応表に従って 1 Zap = 1 n8n workflow で組む
- **エラー時のリトライ** (n8n: ノードごとに `Retry on Fail` 設定可) は Zapier 既定より細かく設定可能
- **環境変数** (DB 接続文字列 / 外部 API URL) は `.env` 経由で n8n に渡す

### 4. 並行稼働テスト (Day N, 2-3 日)

- Zapier 側を **Off にせず**、n8n 側を Active にして同じトリガーを並行受信
- 出力先 (例: 同じ Notion DB に書く場合) は n8n 側で別ステータスタグを付けて区別
- 2-3 日後に出力一致を目視確認 → エラーログなしを確認

### 5. 切替 (Day N+3)

- Zapier 側 Zap を 1 つずつ Off
- 1 週間モニター → 不具合なければ Zapier アカウントを Free プランにダウングレード
- (お疲れ様でした)

## ハマりどころ Top 5

1. **Webhook URL の固定**: n8n の Webhook ノードは production 用 URL と test 用 URL が別 → 切替時は production URL を相手システムに登録
2. **Timezone**: n8n の `GENERIC_TIMEZONE` 環境変数を未設定だと UTC 動作 → JST にしたいなら `Asia/Tokyo` を明示
3. **HTTPS / SSL**: Caddy 経由で自動発行 (本配布雛形に同梱) / 自前で nginx 構成する場合は Let's Encrypt 別途
4. **DB バックアップ**: PostgreSQL の定期 dump を cron 等で別途仕込む必要あり (本雛形未含)
5. **アップデート**: `docker.n8n.io/n8nio/n8n:latest` を pull で最新追従、major version up は CHANGELOG 確認後に

## 参考リンク

- n8n 公式ドキュメント: https://docs.n8n.io/
- 本記事 (ebis AI): https://ebis-ai.com/ai-tools/n8n/advanced-1/zapier-migration/
- 本配布キット問い合わせ: https://ebis-ai.com/contact/