n8nの基本的な使い方|最初の自動化を作るまで

n8nの基本的な使い方。n8nなどを対象に、向き不向きが分かるように整理します。

AIものさし編集部

n8nを初めて使うなら、まず「手動で開始 → 値を整える → 条件で分ける → 結果を見る」という小さなworkflowを作ります。外部サービスへの送信やAI Agentをいきなり加えず、入力dataがnode間をどう移るかを確認すれば、trigger・mapping・条件分岐の基本を安全に覚えられます。

作るものを一文で決める

この練習では、問い合わせ情報を受け取り、件名に「見積もり」が含まれるかで内部向けの分類値を出すところまでを作ります。実在の顧客dataや外部serviceへ書き込まず、dummy dataで動作を確かめます。

  • Input:件名、カテゴリ、受付日時

  • Process:項目を整え、件名に応じて分類値を決める

  • Output:分類値と元の件名を表示する

  • しないこと:メール送信、顧客dataの保存、production activation

n8nのworkflowはtrigger nodeから始まり、各nodeのoutputが次nodeのinputになります。nodeをたくさん置くことではなく、どの値を渡し、どの条件で進むかが分かることが大切です。

最初のworkflowを組み立てる

  1. n8n Cloudか自分のSelf-hosted instanceを開き、空のworkflowを作成します。初回はhostingの管理が少ないCloudを選べます。Self-hostedを使う場合はinstanceの更新とbackupを管理する人を決めます。

  2. Manual Triggerを開始点にします。手動実行なら、外部eventが発生しても意図せず本番処理が始まりません。

  3. Edit Fields / Set相当のnodeで、次のsample fieldsを作ります。画面の名称が異なる場合は、dataを設定する現行nodeを使います。

  4. IF nodeをつなぎ、subjectに「見積もり」が含まれるかを条件にします。true / false両方のbranchを残し、結果を見比べます。

  5. 各branchにもう一つdata設定nodeを置き、categoryへ「見積もり対応」または「通常問い合わせ」を設定します。

  6. workflow全体を手動実行し、各nodeのinput / outputを順番に確認します。出力が期待と違えば、最初にずれたnodeのmappingまたは条件を直します。

表は横にスクロールできます

sample input値
subject見積もりについて相談したい
receivedAt2026-10-08T09:30:00+09:00
sourcetest

期待するoutputは、元の3項目を保持したうえでcategoryが「見積もり対応」になることです。別のsubjectを入れたときに「通常問い合わせ」へ進むことも確認します。これはnodeの使い方を説明する架空dataで、実在の問い合わせや実際に作成したworkflowの結果ではありません。

nodeのoutputを次へ渡す

n8nでは、前のnodeのdataをUIのmappingやexpressionで次のnodeのfieldへ渡せます。件名をそのまま次のmessageへ入れるなどの単純なflowから始めると、値の所在を把握しやすくなります。

sampleを作ったら、IF nodeの条件を「subjectが空でない」など明確な条件にし、true/false両方のoutputを確認します。空文字、想定外のカテゴリ、nullが来た場合にどちらへ流れるかも試します。件名に似た単語が入った場合に誤分類するなら、単純な部分一致では足りないと分かるので、より明確な入力項目や人による確認を追加します。

data mappingは、前nodeのoutputに実在するfield名を使います。fieldが見えない場合は、nodeが実行されていないのか、dataがbranchを通っていないのか、mappingで古いnode名を参照していないかを確認します。expressionをコピーする前に、input paneで対象fieldの値とtypeを見ます。文字列と数字、timezone付き日時と日付文字列を同じものとして扱わないことも重要です。

外部serviceをつなぐ前の確認

Google Sheets、Gmail、Slackなどを接続するときは、nodeを追加する前に何を読み、どこへ書くかを明記します。外部サービスへの接続にcredentialsが必要なら、API keyを本文やexpressionに直書きせず、n8nのcredential機能を使います。OAuthの接続先account、許可scope、共有先、credentialを利用できるworkflow collaboratorを確認します。

まずテスト用sheetやsandbox accountを選び、sample data一件で読み取りから試します。write nodeを使う場合は、追加先と重複時の挙動を決め、dry-run相当の確認後に実データへ進みます。workflow共有は関連credentialsを使える人の範囲にも関わるため、共有前にroleとcredential権限を見直します。

まずは使ってみる

記事の文脈に合うToolへ進めます。報酬の有無で見た目は変えていません。

testと自動起動を分ける

Manual Triggerでの成功は、scheduleやwebhookによる自動実行ができたことを意味しません。自動化へ進むときは、Schedule TriggerやWebhook等へ置き換え、発火条件、timezone、request認証、重複event、rate limitを別に確認します。

本番有効化の前に、少なくとも次を試します。

  • 正常な入力で、期待したbranchへ進む。

  • 条件に合わない入力でも、誤ったwriteや送信がない。

  • 必須fieldが欠けたとき、workflowがどこで止まり、どう記録される。

  • 同じeventが二度届いたとき、二重処理を防げるか。

  • 外部serviceが一時失敗したとき、retryや人への通知が適切か。

  • execution logに個人情報やsecretが過剰に残らない。

automatic triggerを設定したあとも、実行履歴とerror通知を確認できる担当者を決めます。テストが通ったことと、継続運用の監視ができることは別の完了条件です。

よくあるつまずき

表は横にスクロールできます

症状確認する箇所対応
IFの条件がいつもfalseproperty名、大小文字、空白、data typeinput paneで実際の値を見て条件を調整
次nodeにfieldが見えない直前nodeのoutput、保持設定、mapping一つ前のoutputを確認し、必要fieldを残す
testは成功するが自動起動しないtrigger種類、activation/publish状態、URL使うtriggerの現行設定手順を再確認
APIが401/403credential、scope、接続先accountsecretを表示せず権限と接続先を確認
同じデータが重複処理されるtriggerの再送、retry、dedup keyevent ID等で重複判定を設計
誤った相手へ送信されるtest/production接続、宛先field、分岐外部write前にsandboxと承認stepを使う

練習を終える条件

手動実行で二種類のsubjectを試し、どちらも期待したcategoryへ進み、各nodeでinput/outputを説明できたら、この練習は完了です。次に自動起動を試すときは、ScheduleかWebhookのどちらを使うか決め、テスト専用の接続先で一度動かします。外部へのwriteを有効にする前に、重複実行・権限・失敗時の扱いを確認します。

test caseを残す

同じworkflowで少なくとも次の三入力を試し、expectedとactualを記録します。

表は横にスクロールできます

入力条件期待する分岐確認するoutput
subjectに「見積もり」を含むtruecategoryが見積もり対応
subjectが別の問い合わせfalsecategoryが通常問い合わせ
subjectが空定義した例外処理停止するか、要確認へ送る

三件目の扱いを決めていないなら、本番向け自動triggerへ進む前に条件を追加します。成功件数だけでなく、誤判定を検出できる入力と、データ不足時に安全に止まる経路をテストします。入力、期待結果、実際の結果、直した条件を記録すれば、別担当者が再確認できます。

AIものさしの判断

最初に覚えるのは、node名の暗記ではなく「何がきっかけで動き、どのdataを受け取り、どこで条件を決め、何を出すか」です。sample inputとexpected outputを用意し、nodeごとに結果を照合できれば、より複雑なAPIやAI workflowへ進む土台ができます。

workflowが手動testを通したら、まず安全なtest accountで自動triggerを確認します。外部へのwrite、個人情報、AIによる分類が加わる場合は、権限、失敗時の処理、human reviewを追加するまで本番へ有効化しません。

次の一手

記事の内容を踏まえて、公式とTool詳細から続けられます。

次に読む・使う

この記事の次に必要な情報へ進めます。

ツールの詳細