Hoàn thành bài "Lesson 5: Error Handling Strategies and the Error Trigger" trước để mở khoá bài này.Đến bài trước

Giới thiệu

Ở 5 bài trước bạn đã học riêng lẻ từng mảnh ghép: IF/Switch để rẽ nhánh, Loop để lặp qua danh sách, Merge để gộp luồng dữ liệu, Error Trigger và Retry để xử lý lỗi. Bài này ghép tất cả lại thành một workflow hoàn chỉnh có khả năng chạy ổn định trong thực tế. Mục tiêu không phải workflow chạy được một lần, mà là workflow chạy được hàng ngày, hàng tuần mà không cần bạn ngồi canh.

Chúng ta sẽ xây dựng một workflow cụ thể: đồng bộ đơn hàng mới từ một hệ thống (giả lập qua webhook) sang Google Sheets, đồng thời gửi thông báo Slack cho nhóm vận hành, và phải có cơ chế xử lý khi API bên thứ ba chết.

Phân tích yêu cầu workflow

Trước khi mở n8n, hãy liệt kê bằng văn xuôi các yêu cầu của workflow này. Đầu vào là một webhook nhận payload đơn hàng gồm các trường: order_id, customer_email, amount, currency. Đầu ra gồm ba việc: ghi một dòng vào Google Sheets, gửi tin nhắn Slack với nội dung tóm tắt đơn hàng, và nếu amount lớn hơn 1000 thì gắn nhãn đơn VIP để nhóm vận hành ưu tiên xử lý.

Tiếp theo, liệt kê các chỗ có thể hỏng. Webhook có thể nhận payload thiếu trường. Google Sheets API có thể trả lỗi rate limit khi đơn hàng dồn dập. Slack API có thể timeout. Mỗi chỗ đó cần một cơ chế xử lý tương ứng.

sơ đồ tổng quan workflow gồm 4 nhánh xử lý từ webhook đầu vào đến 3 đầu ra và 1 nhánh error

Xây dựng workflow từng bước

Bước đầu tiên là node Webhook nhận POST request. Cấu hình đường dẫn là /new-order và bật chế độ Response Code ngay lập tức để không giữ kết nối. Payload mẫu trông như sau.

json
{
"order_id": "ORD-2025-001",
"customer_email": "khach@example.com",
"amount": 1500,
"currency": "VND"
}

Bước hai là một node IF kiểm tra đầu vào có hợp lệ không. Điều kiện kiểm tra là order_id tồn tại, customer_email tồn tại, amount là số và lớn hơn 0. Nhánh false dẫn đến node Respond trả về mã 400 kèm thông báo lỗi để hệ thống gửi đơn biết payload bị lỗi.

javascript
{
"conditions": [
{
"leftValue": "={{ $json.order_id }}",
"operator": "exists",
"rightValue": ""
},
{
"leftValue": "={{ $json.amount }}",
"operator": ">",
"rightValue": 0
}
],
"combineOperation": "AND"
}

Bước ba, từ nhánh true, thêm một node Switch để tách theo mệnh giá tiền. Case 1 là amount lớn hơn 1000, case 2 là còn lại. Đây là điểm mà branch và merge gặp nhau: ta sẽ gộp lại sau khi thêm nhãn VIP hoặc thường.

javascript
{
"rules": [
{
"conditions": [
{
"leftValue": "={{ $json.amount }}",
"operator": ">",
"rightValue": 1000
}
],
"outputKey": "vip"
}
],
"fallbackOutput": "standard"
}

Bước bốn, node Set đặt trường priority bằng VIP hoặc STANDARD tùy theo nhánh Switch. Sau đó dùng node Merge chế độ Combine để gộp hai nhánh lại thành một luồng duy nhất. Merge với Combine sẽ ghép các item từ cả hai input vào cùng một danh sách, phù hợp khi bạn muốn xử lý tiếp cùng một cách bất kể VIP hay không.

Bước năm, thêm node Google Sheets. Bật Retry on Fail với 3 lần thử và khoảng cách 5000 ms giữa các lần. Đây là lớp phòng thủ đầu tiên cho lỗi mạng thoáng qua. Nếu sau 3 lần vẫn thất bại, workflow sẽ dừng ở đây và Error Trigger sẽ bắt được.

Bước sáu, node Slack gửi thông báo. Đặt Continue on Fail thành true cho node này vì nếu Slack chết thì workflow vẫn nên ghi Sheets thành công. Đây là điểm tinh tế: bạn muốn workflow thất bại toàn bộ khi Sheets lỗi (vì đó là dữ liệu cốt lõi), nhưng vẫn hoàn tất khi chỉ Slack lỗi.

Bước cuối, node Respond trả về 200 OK cho hệ thống gửi đơn.

Xử lý lỗi tổng thể

Tạo một workflow riêng chỉ chứa một node Error Trigger. Cấu hình nó lắng nghe workflow chính vừa xây xong. Trong Error Trigger bạn sẽ nhận được thông tin chi tiết về node nào lỗi, lỗi gì, lúc nào. Sau Error Trigger thêm một node Slack gửi cảnh báo vào kênh alerts kèm tóm tắt lỗi.

javascript
{
"channel": "#alerts",
"text": "Workflow that-s sync-đon-hang lỗi: {{ $json.execution.error.message }} tại node {{ $json.execution.lastNodeExecuted }}"
}

Ngoài Error Trigger, hãy bật Workflow Settings có Error Workflow trỏ đến workflow xử lý lỗi trên. Khi đó bất kỳ lần chạy nào thất bại sẽ tự động kích hoạt workflow lỗi mà không cần bạn vào xem lịch sử thủ công.

Tổng kết

Một workflow production-ready có ba lớp phòng thủ: validate đầu vào bằng IF để loại payload xấu ngay từ đầu, Retry on Fail cho từng node gọi API bên ngoài để chịu được lỗi mạng thoáng qua, và Error Workflow riêng để thông báo khi mọi thứ thực sự vỡ. Thêm vào đó là Switch kết hợp Merge để vừa phân nhánh theo logic nghiệp vụ vừa không bị phân mảnh luồng dữ liệu, cùng Continue on Fail có chọn lọc cho các node không quan trọng như thông báo. Khi đã có đủ ba lớp này, bạn có thể bật workflow chạy nền và yên tâm nó xử lý hàng ngàn đơn mà không cần can thiệp.

Bước tiếp theo sau bài này là thử cố tình gửi payload thiếu trường, tắt mạng giả lập để xem Retry có hoạt động không, rồi xóa quyền truy cập Google Sheets để xem Error Workflow có bắt được không. Chỉ khi cả ba tình huống đều đúng kỳ vọng thì workflow mới thực sự resilient.

Luyện tập sau buổi học

Bài kiểm tra cuối bài

Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.

0/1
Đã trả lời · 0/1