Bài 4 — Giao diện n8n: Workflow, Node, Trigger, Execution

Trước khi build Agent, bạn cần thuộc lòng 4 khu vực của editor và 3 thao tác cơ bản: thêm node, chạy thử, đọc kết quả. Bài này làm chậm, từng click, để bạn không bị lạc khi workflow phình to ở các phần sau.

Cấu trúc giao diện editor

• Canvas (vùng giữa) — nơi kéo thả và nối các node. Giữ phím Space + kéo chuột để di chuyển (pan); lăn chuột để zoom; bấm phím 1 để fit toàn bộ workflow vào màn hình.
• Nút + (góc trên phải canvas) hoặc dấu + trên đầu node — mở panel tìm kiếm node để thêm bước mới.
• Node panel (mở khi double-click 1 node) — chứa Parameters (tham số), Credentials, và nút Execute step để chạy riêng node đó.
• Executions tab (thanh trên cùng) — lịch sử mọi lần chạy, xem được input/output JSON của từng node, biết node nào xanh (thành công) hay đỏ (lỗi).
• Menu ba chấm (⋯) góc trên phải — chứa Settings (timezone, error workflow), Download, Duplicate và nút Save.
• Toggle Active/Inactive (góc trên phải) — bật thì trigger production mới tự chạy; khi học và test thì cứ để Inactive và dùng nút Execute.

Khái niệm cốt lõi (nhớ 5 từ này)

• Workflow — một quy trình automation hoàn chỉnh (sau này 1 Manager Agent = 1 workflow chính).
• Node — một bước xử lý (Telegram Trigger, Google Sheets, HTTP Request...). Nối node bằng cách kéo từ chấm tròn bên phải node này sang node kia.
• Item — một bản ghi JSON chạy qua node. Nếu có 5 sản phẩm thì có 5 item; node sẽ chạy logic cho từng item.
• Trigger — node khởi động workflow (Manual Trigger để test, Telegram message, Schedule, Webhook cho production). Mỗi workflow bắt đầu bằng đúng 1 trigger.
• Execution — một lần chạy. Manual = bạn tự bấm; Production = trigger thật kích hoạt.

Bài tập chính — dựng workflow sandbox đầu tiên

Làm đúng từng bước dưới đây trên workflow 00-sandbox đã tạo ở Bài 3. Đây là bộ khung mọi workflow sau này đều dùng lại.

1. Mở workflow 00-sandbox. Nếu canvas trống, bấm nút + lớn ở giữa (Add first step).
2. Trong ô tìm kiếm, gõ Manual → chọn Trigger manually (On clicking Execute). Node Manual Trigger xuất hiện trên canvas.
3. Kéo từ chấm tròn bên phải node Manual Trigger, thả ra khoảng trống → panel tìm node hiện lên → gõ Edit Fields → chọn Edit Fields (Set).
4. Double-click node Set để mở. Ở Mode chọn Manual Mapping. Bấm Add Field → cột Name gõ hello, cột Value gõ Auto Marketing. Bấm Add Field lần nữa → tạo field channel = telegram.
5. Đóng node (bấm ra ngoài hoặc phím Esc). Bấm nút Execute Workflow (nút hình play, thường màu đỏ ở giữa dưới màn hình).
6. Cả hai node chuyển sang viền xanh = chạy thành công. Bấm vào node Set để xem output: bạn sẽ thấy JSON { hello: Auto Marketing, channel: telegram }.
7. Bấm Ctrl/Cmd + S để Save.

• ✅ Checkpoint: node Set viền xanh và output panel bên phải hiện đúng 2 field hello + channel.

Đọc Execution log để tự debug

1. Bấm tab Executions ở thanh trên cùng → chọn lần chạy mới nhất.
2. Bấm vào từng node để xem 2 tab: INPUT (dữ liệu đi vào) và OUTPUT (dữ liệu đi ra). So sánh 2 tab này là cách nhanh nhất tìm ra node nào làm hỏng dữ liệu.
3. Chuyển qua lại giữa dạng Table (bảng) và JSON bằng nút chuyển ở góc trên panel — Table dễ nhìn, JSON để copy chính xác tên field.
4. Node viền đỏ = lỗi; bấm vào sẽ thấy tab Error với thông báo cụ thể (thường là sai tên field, thiếu credential, hoặc kiểu dữ liệu).

Debug với Pin Data (kỹ năng quan trọng nhất bài này)

Pin Data giúp bạn cố định (đóng băng) output của một node để test các node phía sau mà KHÔNG cần chạy lại trigger thật. Ví dụ: thay vì bắt Telegram gửi tin mỗi lần test, bạn pin sẵn một tin mẫu.

1. Sau khi node Set đã chạy ra output, bấm vào node đó → bấm biểu tượng ghim (Pin) ở góc trên panel output. Output chuyển sang màu tím = đã pin.
2. Giờ kéo thêm một node IF vào sau node Set (gõ IF khi tìm node).
3. Mở node IF → điều kiện: {{ $json.channel }} is equal to telegram. Bấm Execute step trên riêng node IF.
4. Node IF chạy ngay bằng dữ liệu đã pin, không cần bấm Manual Trigger lại — item đi ra nhánh true.
5. Khi muốn dùng lại dữ liệu thật, bấm lại biểu tượng ghim để bỏ pin. Lưu ý: production execution luôn bỏ qua pinned data.

Lỗi thường gặp ở Bài 4

• Bấm Execute nhưng không có gì chạy → workflow chưa có Trigger node, hoặc bạn chưa nối dây từ Manual Trigger sang node kế tiếp.
• Node báo No input data → node trước chưa chạy hoặc chưa nối dây; chạy node trước hoặc dùng Pin Data.
• Expression {{ $json.field }} trả về undefined → sai tên field (phân biệt hoa/thường); mở tab OUTPUT node trước để copy đúng tên.
• Lỡ xóa nhầm node → Ctrl/Cmd + Z để hoàn tác.

Bài tập thực hành (trên n8n Cloud)

1. Hoàn thành workflow 00-sandbox: Manual Trigger → Set (hello + channel).
2. Chạy Execute Workflow và mở Executions tab đọc JSON output.
3. Pin output node Set, thêm IF (channel = telegram) và Execute step chỉ riêng IF.
4. Thêm một Sticky Note (gõ Sticky, hoặc phím Shift+S) ghi chú Đây là sandbox test để tập tổ chức canvas.