Mục tiêu Workflow
Nhận lead, validate, lưu Sheet và gửi thông báo.
Điều kiện đầu vào
- Webhook/Form: phải có nguồn, người cập nhật và trạng thái xác minh.
- Google Sheet: phải có nguồn, người cập nhật và trạng thái xác minh.
- Telegram/Email: phải có nguồn, người cập nhật và trạng thái xác minh.
- Field schema: phải có nguồn, người cập nhật và trạng thái xác minh.
Công cụ và kết nối
- n8n
- Google Sheets
- Telegram
Nguyên tắc cấu hình: lưu credential trong kho bí mật/credential manager của nền tảng; không ghi API key trực tiếp trong Prompt, Sheet hoặc log công khai.
Đầu ra cần nghiệm thu
- Workflow node map
- Data schema
- Error path
- Log
Quy trình triển khai chi tiết
- Nhận webhook
Tập hợp Webhook/Form, Google Sheet và Telegram/Email; đặt tên file/record thống nhất, loại bản trùng và đánh dấu mục thiếu. Chỉ chuyển bước khi nguồn, người sở hữu và thời điểm cập nhật đã được ghi rõ.
- Validate trường
Đối chiếu dữ liệu với nguồn gốc, chuẩn hóa định dạng và tạo danh sách lỗi. Mục không xác minh được phải gắn trạng thái CẦN BỔ SUNG, không để AI tự suy đoán.
- Chuẩn hóa dữ liệu
Đối chiếu dữ liệu với nguồn gốc, chuẩn hóa định dạng và tạo danh sách lỗi. Mục không xác minh được phải gắn trạng thái CẦN BỔ SUNG, không để AI tự suy đoán.
- Kiểm tra trùng
Thực hiện “Kiểm tra trùng” bằng n8n, Google Sheets và Telegram; ghi rõ dữ liệu vào, dữ liệu ra, điều kiện thành công và nhánh lỗi. Kiểm tra kết quả mẫu trước khi xử lý hàng loạt.
- Append Sheet
Thực hiện “Append Sheet” bằng n8n, Google Sheets và Telegram; ghi rõ dữ liệu vào, dữ liệu ra, điều kiện thành công và nhánh lỗi. Kiểm tra kết quả mẫu trước khi xử lý hàng loạt.
- Gửi thông báo
Đẩy đầu ra qua n8n, Google Sheets và Telegram sau khi kiểm tra quyền truy cập và consent. Ghi response ID, URL/kết quả, thời điểm, trạng thái và mã lỗi; không đánh dấu hoàn thành nếu hệ thống đích chưa xác nhận.
- Trả response
Thực hiện “Trả response” bằng n8n, Google Sheets và Telegram; ghi rõ dữ liệu vào, dữ liệu ra, điều kiện thành công và nhánh lỗi. Kiểm tra kết quả mẫu trước khi xử lý hàng loạt.
- Log lỗi
Tổng hợp KPI, lỗi và ngoại lệ; so sánh số record đầu vào–đầu ra và cảnh báo chênh lệch. Báo cáo phải liên kết được về record nguồn để truy vết và xử lý lại.
Xử lý lỗi và chạy lại
- Lỗi dữ liệu: chuyển record sang trạng thái
NEEDS_INPUT, ghi trường thiếu và không gọi AI/API tiếp. - Lỗi API tạm thời: retry tối đa 3 lần với backoff; lỗi xác thực hoặc quota phải dừng và cảnh báo Admin.
- Lỗi từng record không được làm dừng toàn bộ lô; lưu record lỗi vào hàng đợi kiểm tra lại.
- Mỗi lần chạy phải có run ID, thời điểm, input reference, output reference và thông báo kết quả.
Quality Gate trước khi dùng thật
- Test tối thiểu 3 tình huống: dữ liệu chuẩn, thiếu dữ liệu và API trả lỗi.
- Đối chiếu số record đầu vào, thành công, bỏ qua và thất bại; tổng phải khớp.
- Kiểm tra quyền riêng tư, consent, bản quyền, claim và thông tin nhạy cảm theo đúng loại nội dung.
- Chạy thử với phạm vi nhỏ, có người duyệt; sau đó mới bật lịch hoặc xử lý hàng loạt.
Thời lượng dự kiến: 30–60 phút thiết lập · Độ khó: Cơ bản.
