n8nのWebhook連携を移行：Google Sheetsへの書き込みをAI Flowi Workflowで再構築

n8nのWebhook連携を移行するには、Google Sheetsへの書き込みに使うフィールドのマッピング、入力検証、呼び出し元への応答をAI Flowiで再構築します。n8nからエクスポートしたワークフローは直接インポートできません。Googleの認証をやり直し、書き込み先をテストしてください。このAI Flowiの構成例は2026年10月8日に本番環境でテスト済みです。有効なリクエストには200が返り、入力検証やキーの確認で拒否されたリクエストでは行が書き込まれませんでした。

著者：Ai Flowi · 公開日：2026年10月9日 · 更新日：2026年10月9日

詳しい構築手順：WebhookからGoogle Sheetsに書き込むチュートリアル。機密情報を除去した、検証済みワークフローJSONのZIPをダウンロード。

n8nのワークフローJSONはAI Flowiにインポートできる形式ではありません。移行には手動での再構築が必要です。上記の機密情報を除去したAI FlowiのJSONを出発点とし、n8nのエクスポートは参照用にのみ使ってください。ファイルの拡張子が同じでも、互換性があるとは限りません。n8nのエクスポートを直接インポートしたり変換したりするテストは行っていません。n8nのドキュメントには、ワークフローのJSON形式が記載されています。ドキュメントに記載がありますが、Ai Flowiでは未テストです。確認日：2026年10月9日。

開始前の準備

• 既存のn8nワークフローについて、入力フィールド、変換処理、列の順序、書き込み先、認証、呼び出し元への応答、重複配信への対処方針を記録してください。

n8nノードとAI Flowiコンポーネントの対応

実際のワークフローから、ペイロード内のパス、フィールドの式、呼び出し元との取り決めを記録してください。下表を使って、その動作を再構築します。n8nに関する項目は、ドキュメントに記載がありますが、Ai Flowiでは未テストです。リンク先の公式資料の確認日：2026年10月9日。

別の参考資料として、AI Flowi Workflowとn8nの比較をご覧ください。ワークフローの入力仕様、Google接続、書き込み先を再構築してテストしてください。

手動で再構築する項目

アカウントの作成または再認証は、Settings → Google Connectionsで行い、そのアカウントをAppend Rowsで選択します。既存のn8nのOAuth2またはService Accountの認証情報は、この接続に置き換える必要があります。エクスポートを共有する前に内容を確認してください。n8nのドキュメントには、認証情報の名前とIDがワークフローのエクスポートに含まれることが記載されています（ドキュメントに記載がありますが、Ai Flowiでは未テストです。確認日：2026年10月9日）。提供するAI FlowiのJSONは機密情報を除去済みです。通常の一括エクスポートには、アカウントのラベル、接続識別子、スプレッドシートID、エンドポイントURLが残る場合があります。

引き継がれない項目

• 標準のインポート機能では取り込めません：n8nのワークフローJSONはAI Flowiにインポートできません。動作を手動で再構築してください。n8nのエクスポートは参照資料であり、AI Flowiと互換性のあるワークフローファイルではありません。
• この構成例で同等の動作をテストしていない機能：n8nで設定できるWebhookの応答コード、ヘッダー、本文については、呼び出し元との取り決めを確認する必要があります（公式資料に記載がありますが、Ai Flowiでは未テストです。確認日：2026年10月9日）。また、このガイドの既知の制限に示すとおり、この基本構成例にはカスタムコード、その他のノード、バイナリ応答やストリーミング応答、エラーワークフロー、リトライ、実行履歴の再構築は含まれません。必要な動作は別途再構築してテストし、必要な過去の記録を保存してください。
• 認証情報：AI FlowiでGoogle接続とWebhook認証を作り直してください。n8nのOAuth2 / Service Accountの認証情報は移行されません。エクスポートに含まれる認証情報の名前とIDだけでは、認証済みのAI Flowi接続にはなりません（公式資料に記載がありますが、Ai Flowiでは未テストです。確認日：2026年10月9日）。
• Webhook URL：受け入れ確認後、送信側は新しいAI FlowiのProduction Endpointを使う必要があります。ロールバック用に、以前のn8nのURLを保存してください。

AI Flowiのテスト結果（2026年10月8日）

このAI Flowiの構成は、2026年10月8日に本番環境でのテストとクリーンな状態でのインポートテストに合格しました。以下の記録は、この構成例の結果であり、移行したご自身のn8nワークフローの結果ではありません。ご自身のフィールドマッピング、認証情報、書き込み先を再構築し、送信先を切り替える前に呼び出し元への応答とシートへの書き込みの両方を確認してください。

クリーンな状態でインポートしたコピーでも、成功、入力検証による拒否、キーによる拒否、重複時の動作を再現できました。不正なIDのテストは、元の構成のみで実施しました。各ケースの実行後に応答本文を比較し、実際のシートを読み戻してください。キャンバスの表示やインポートの成功だけでは、書き込みが行われた証拠にはなりません。

関連情報：ワークフロー比較。

既知の制限と、この移行で対応していない機能

2026年10月8日の行追加テストでは、繰り返し配信するたびに行が追加されました。リトライを行う送信側には、重複防止版があります。2026年10月9日に本番環境でテスト済みのこの版では、event_idとUpsert Rowを使用します。ただし、同時配信では両方が挿入される可能性があります。元の構成での不正なIDのテストでは、スプレッドシートIDを含むGoogleのエラー詳細がそのまま返されました。この構成例にはフロー内でエラーを捕捉する処理がありません。

この基本構成例が扱うのは、1つのJSONオブジェクトと3列からなる1行の追加です。カスタムコード、その他のノード、バイナリ応答やストリーミング応答、エラーワークフロー、リトライ、実行履歴は再構築しません。必要な過去の記録は別途保存してください。切り替え前に追加の動作を再構築してテストしてください。ノード名が似ているだけでは、応答やアクセスルールが同等であるとは判断できません。

切り替えチェックリスト

再構築したn8nワークフローには、次の手順を使ってください。これは運用チェックリストであり、プラットフォーム間の切り替えをテスト済みであることを示すものではありません。

1. 構築と設定：基本チュートリアルの設定手順に従ってください。リトライを行う送信側の場合は、重複防止の設定手順に従います。Google接続を作り直し、Spreadsheet ID、タブ、列の順序、フィールドマッピング、POSTメソッド、Platform API Key認証、From Flow応答モードを確認してください。JQフィールドは表示したままにしてください。
2. AI Flowiで受け入れテストを実施：認証済みの有効な入力は200を返し、1行を書き込む必要があります。フィールドの欠落、型の誤り、無効なメールアドレス、不正な形式のJSONは422を返し、行を書き込んではいけません。キーの欠落や無効なキーは403を返し、行を書き込んではいけません。各ケースの実行後にシートを読み戻してください。
3. 重複配信をテスト：行追加版は、同じ有効な入力を2回配信すると2行を書き込みます。重複防止版では、同じevent_idを順番に送信してください。1回目は200と{"status":"inserted"}、次は200と{"status":"duplicate"}が返り、追加の行が書き込まれないことを確認します。同時配信では両方が挿入される可能性があります。
4. テスト用シートで両システムを並行実行：n8nとAI Flowiに同じテスト用に作成した入力データを送信します。書き込みを比較できるよう、テスト用スプレッドシートではそれぞれ別のタブを使ってください。マッピングした値、列の順序、HTTP応答、重複時の動作を、記録した呼び出し元との取り決めと比較します。本番の送信側を変更する前に差異を解消してください。
5. 送信側のURLを切り替え：以前のURLと切り替え時刻を記録してから、n8nのWebhook URLをAI FlowiのProduction Endpointに置き換え、送信側にAI Flowiの認証を設定してください。
6. 最初のリクエストを監視：呼び出し元に返るステータスと本文、実際の書き込み先の行を確認し、書き込みの欠落や重複がないか調べてください。Sheetsの障害時には、プラットフォームのエラーがそのまま返る場合があります。テスト済みの構成例にはフロー内でエラーを捕捉する処理がありません。再構築した動作が確認基準を満たさない場合は、ロールバック計画に従ってください。
7. ロールバック期間を確保：切り替え後、以前のn8nワークフローを無効にします。削除せず無効のまま保持し、設定したロールバック期間が終了するまで、そのURLと設定を利用できる状態にしてください。

ロールバック計画

1. 配信を復旧：送信側を記録済みのn8nのWebhook URLに戻し、元の認証を復元して、以前のワークフローを再び有効にします。リクエストと書き込み先の行を確認してから、置き換え用のAI Flowiワークフローを無効にしてください。
2. 切り替え期間のデータを照合：重複防止版を使う場合は、欠落したイベントを再送する前に、切り替え期間中に書き込まれた行と送信側の記録をevent_idで照合してください。リトライ時には同じ識別子を使います。Upsert Rowは一致する既存の行を更新します。既存の重複行を統合する機能はなく、キーの有効範囲は1つのワークシートです。以前のワークフローがevent_idを保存していない場合は、手動で照合できるよう送信側の記録に残してください。行追加版にはevent_idによる重複防止がないため、再送前に切り替え期間中の行を手動で確認してください。

元に切り替えても、シートへの書き込みは取り消されません。これは手動の運用ロールバックです。テスト済みの重複防止機能の制限は引き続き適用され、同時配信では両方の行が挿入される可能性も残ります。

出典と検証範囲

• WebhookからGoogle Sheetsに書き込むチュートリアルと機密情報を除去したワークフローJSONのZIP。AI Flowiの構成例、実際に使用したJQ式、応答、制限の根拠は、2026年10月8日付の本番環境およびクリーンな状態でのインポートテスト報告です。ポートは機密情報を除去したインポートファイルと一致しています。
• Google ConnectionとAI Flowiワークフローのインポート／エクスポート。
• n8nの公式ドキュメントへのリンクは、上記の各対応関係とエクスポートに関する記述のそばに掲載しています。公式資料の確認日：2026年10月9日。ドキュメントに記載がありますが、Ai Flowiでは未テストです。n8nのワークフローの実行や、プラットフォーム間のインポートは行っていません。