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を組み立てる
-
n8n Cloudか自分のSelf-hosted instanceを開き、空のworkflowを作成します。初回はhostingの管理が少ないCloudを選べます。Self-hostedを使う場合はinstanceの更新とbackupを管理する人を決めます。
-
Manual Triggerを開始点にします。手動実行なら、外部eventが発生しても意図せず本番処理が始まりません。
-
Edit Fields / Set相当のnodeで、次のsample fieldsを作ります。画面の名称が異なる場合は、dataを設定する現行nodeを使います。
-
IF nodeをつなぎ、subjectに「見積もり」が含まれるかを条件にします。true / false両方のbranchを残し、結果を見比べます。
-
各branchにもう一つdata設定nodeを置き、categoryへ「見積もり対応」または「通常問い合わせ」を設定します。
-
workflow全体を手動実行し、各nodeのinput / outputを順番に確認します。出力が期待と違えば、最初にずれたnodeのmappingまたは条件を直します。
表は横にスクロールできます
| sample input | 値 |
|---|---|
| subject | 見積もりについて相談したい |
| receivedAt | 2026-10-08T09:30:00+09:00 |
| source | test |
期待する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へ進めます。報酬の有無で見た目は変えていません。
n8n
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の条件がいつもfalse | property名、大小文字、空白、data type | input paneで実際の値を見て条件を調整 |
| 次nodeにfieldが見えない | 直前nodeのoutput、保持設定、mapping | 一つ前のoutputを確認し、必要fieldを残す |
| testは成功するが自動起動しない | trigger種類、activation/publish状態、URL | 使うtriggerの現行設定手順を再確認 |
| APIが401/403 | credential、scope、接続先account | secretを表示せず権限と接続先を確認 |
| 同じデータが重複処理される | triggerの再送、retry、dedup key | event ID等で重複判定を設計 |
| 誤った相手へ送信される | test/production接続、宛先field、分岐 | 外部write前にsandboxと承認stepを使う |
練習を終える条件
手動実行で二種類のsubjectを試し、どちらも期待したcategoryへ進み、各nodeでinput/outputを説明できたら、この練習は完了です。次に自動起動を試すときは、ScheduleかWebhookのどちらを使うか決め、テスト専用の接続先で一度動かします。外部へのwriteを有効にする前に、重複実行・権限・失敗時の扱いを確認します。
test caseを残す
同じworkflowで少なくとも次の三入力を試し、expectedとactualを記録します。
表は横にスクロールできます
| 入力条件 | 期待する分岐 | 確認するoutput |
|---|---|---|
| subjectに「見積もり」を含む | true | categoryが見積もり対応 |
| subjectが別の問い合わせ | false | categoryが通常問い合わせ |
| subjectが空 | 定義した例外処理 | 停止するか、要確認へ送る |
三件目の扱いを決めていないなら、本番向け自動triggerへ進む前に条件を追加します。成功件数だけでなく、誤判定を検出できる入力と、データ不足時に安全に止まる経路をテストします。入力、期待結果、実際の結果、直した条件を記録すれば、別担当者が再確認できます。
AIものさしの判断
最初に覚えるのは、node名の暗記ではなく「何がきっかけで動き、どのdataを受け取り、どこで条件を決め、何を出すか」です。sample inputとexpected outputを用意し、nodeごとに結果を照合できれば、より複雑なAPIやAI workflowへ進む土台ができます。
workflowが手動testを通したら、まず安全なtest accountで自動triggerを確認します。外部へのwrite、個人情報、AIによる分類が加わる場合は、権限、失敗時の処理、human reviewを追加するまで本番へ有効化しません。
引用・データ出典
公式情報を編集部が見た内容です。Hands-on未実施の記述は本文かここに分けています。
確認日:2026-10-09
-
n8n Docs: quickstart | https://docs.n8n.io/try-it-out/quickstart/(新しいタブで開く)
-
n8n Docs: Manual Trigger | https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.manualworkflowtrigger/(新しいタブで開く)
-
n8n Docs: Edit Fields | https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.editfields/(新しいタブで開く)
-
n8n Docs: If node | https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.if/(新しいタブで開く)
