Gửi Email Với Node-RED

Hướng dẫn này chỉ cho bạn cách thiết lập thông báo email tự động từ camera OV10i bằng Node-RED. Bạn sẽ học cách cấu hình tích hợp Gmail và tạo các flow gửi cảnh báo kiểm tra, cập nhật trạng thái hệ thống và thông báo lỗi trực tiếp đến email của bạn.

Những Gì Bạn Sẽ Xây Dựng: Một hệ thống email tự động gửi kết quả kiểm tra, cảnh báo và thông báo từ OV10i đến các người nhận được chỉ định bằng Gmail SMTP.

Ứng Dụng Thực Tế: Nhận cảnh báo email tức thì khi quá trình kiểm tra thất bại, gửi báo cáo chất lượng hàng ngày cho ban quản lý, hoặc thông báo cho đội bảo trì về các vấn đề hệ thống - tất cả đều tự động từ hệ thống vision inspection của bạn.

Bỏ qua thiết lập thủ công

Mô tả bằng tiếng Anh thông thường loại thông báo email bạn cần và Auto-Integration Builder sẽ tạo ra một Node-RED flow hoàn chỉnh cho bạn trong vài giây.

Điều Kiện Tiên Quyết

• Camera OV10i có quyền truy cập Node-RED
• Tài khoản Gmail để gửi email
• Hiểu biết cơ bản về Node-RED flows
• Quyền truy cập vào cài đặt bảo mật Tài khoản Google

Tổng Quan Hướng Dẫn

Những gì chúng ta sẽ xây dựng: Một Node-RED flow tự động gửi thông báo email với kết quả kiểm tra và cảnh báo hệ thống.

Thời gian cần thiết: 20-30 phút (bao gồm thiết lập Gmail)

Kỹ năng đạt được: Thiết lập Gmail app password, cấu hình SMTP, thông báo email tự động

Bước 1: Thiết Lập Gmail App Password

1.1 Bật Xác Minh 2 Bước

1. Đăng nhập vào Tài khoản Google của bạn tại accounts.google.com
2. Nhấp "Security" trong menu điều hướng bên trái
3. Tìm phần "Signing in to Google"
4. Nhấp "2-Step Verification"
5. Làm theo hướng dẫn để bật Xác Minh 2 Bước nếu chưa được bật

note

Xác Minh 2 Bước là yêu cầu bắt buộc trước khi bạn có thể tạo app passwords.

1.2 Tạo App Password

1. Quay lại trang Security sau khi bật Xác Minh 2 Bước
2. Nhấp "App passwords" (dưới "Signing in to Google")
3. Chọn "Mail" làm loại ứng dụng
4. Chọn "Other" làm loại thiết bị
5. Nhập tên như "OV10i Node-RED Email"
6. Nhấp "Generate"

1.3 Lưu App Password Của Bạn

1. Sao chép mật khẩu 16 ký tự mà Google hiển thị
2. Lưu trữ an toàn - bạn sẽ cần nó cho cấu hình Node-RED
3. Lưu ý: Mật khẩu này chỉ được hiển thị một lần. Nếu bị mất, hãy tạo mật khẩu mới

Checkpoint: Bạn nên có một Gmail app password 16 ký tự được lưu để sử dụng cho Node-RED.

Bước 2: Cài Đặt Email Nodes (Nếu Cần)

2.1 Kiểm Tra Email Nodes

1. Mở Node-RED trên camera OV10i của bạn
2. Tìm trong palette bên trái một email node trong phần output
3. Nếu thiếu, bạn sẽ cần cài đặt gói email

2.2 Cài Đặt Gói Email (Nếu Yêu Cầu)

1. Nhấp menu hamburger (≡) trong Node-RED
2. Chọn "Manage palette"
3. Nhấp tab "Install"
4. Tìm kiếm "node-red-node-email"
5. Nhấp "Install" bên cạnh gói

Bước 3: Tạo Email Flow Cơ Bản

3.1 Thêm Các Nodes Cần Thiết

1. Điều hướng đến IO Block để truy cập Node-RED
2. Kéo các nodes này từ palette vào canvas của bạn:
   • Inject node (để kiểm tra)
   • Email node (từ phần output)
3. Kết nối đầu ra inject với đầu vào email

3.2 Cấu Trúc Flow Cơ Bản

Inject → Email

Mục đích của flow: Gửi email đơn giản để kiểm tra và thông báo cơ bản.

Bước 4: Cấu Hình Nội Dung Email

4.1 Thiết Lập Inject Node

1. Nhấp đúp vào inject node để mở thuộc tính
2. Thiết lập payload:
   • Loại payload: "string"
   • Giá trị payload: Nội dung email của bạn (ví dụ: "Inspection alert from OV10i")
3. Thêm tiêu đề email:

   • Nhấp "+ add" để thêm thuộc tính

   • Tên thuộc tính: "topic"

   • Giá trị thuộc tính: Tiêu đề email của bạn (ví dụ: "OV10i Inspection Alert")

     

4.2 Ví Dụ Cấu Hình Cơ Bản

Payload (nội dung email):

Inspection completed at Station 1
Status: Alert triggered
Time: Check timestamp for details

Topic (tiêu đề email):

OV10i Inspection Alert - Station 1

4.3 Lưu Cấu Hình Inject

1. Đặt tên cho node như "Email Trigger"
2. Nhấp "Done" để lưu cấu hình

Bước 5: Cấu Hình Thiết Lập SMTP Email

5.1 Thiết Lập Email Node

1. Nhấp đúp vào email node để mở thuộc tính
2. Cấu hình các thiết lập cơ bản:
   • Name: "Send Alert Email" (hoặc tên mô tả)
   • To: Địa chỉ email người nhận (ví dụ: quality@company.com)

5.2 Cấu Hình Gmail SMTP

1. Server: smtp.gmail.com
2. Port: 465
3. Đánh dấu "Use secure connection"
4. Auth type: Basic
5. Userid: Địa chỉ Gmail đầy đủ của bạn (ví dụ: alerts@company.com)
6. Password: Mật khẩu ứng dụng 16 ký tự từ Bước 1

5.3 Thiết Lập Bảo Mật

1. Đánh dấu "Check server certificate is valid"
2. Xác minh tất cả thiết lập đã được nhập chính xác
3. Nhấp "Done" để lưu cấu hình email node

Checkpoint: Email node của bạn không nên hiển thị bất kỳ chỉ báo lỗi nào và hiển thị địa chỉ người nhận.

Bước 6: Kiểm Tra Email Flow

6.1 Triển Khai và Kiểm Tra

1. Nhấp nút "Deploy" ở góc trên bên phải
2. Chờ thông báo "Successfully deployed"
3. Nhấp nút inject node (ô vuông màu xám ở phía bên trái)

6.2 Xác Minh Việc Gửi Email

1. Kiểm tra email người nhận để xem tin nhắn thử
2. Kiểm tra thư mục spam nếu email không xuất hiện trong hộp thư đến
3. Tìm bất kỳ thông báo lỗi nào trong bảng debug của Node-RED

6.3 Khắc Phục Sự Cố Nếu Cần

Các vấn đề thường gặp:

• Sai mật khẩu ứng dụng: Tạo lại mật khẩu ứng dụng Gmail
• Thiết lập SMTP: Xác minh server và port chính xác
• Firewall: Đảm bảo lưu lượng SMTP đi được cho phép

Bước 7: Tích Hợp Với Kết Quả Kiểm Tra

7.1 Kết Nối Với Inspection Flow

Để gửi email dựa trên kết quả kiểm tra:

1. Tìm inspection flow chính (bắt đầu với "All Block Outputs")
2. Thêm email flow như một nhánh từ quá trình xử lý kiểm tra
3. Kết nối sau logic kiểm tra nhưng song song với kết quả cuối cùng

7.2 Ví Dụ Flow Tích Hợp

All Block Outputs → [Inspection Logic] → Final Pass/Fail
                                      ↓
                              Format Email → Send Email

7.3 Nội Dung Email Động

Thay thế inject node bằng function node để tạo nội dung động:

// Dynamic email based on inspection results
const result = msg.payload.result ? "PASSED" : "FAILED";
const timestamp = new Date().toLocaleString();
const station = global.get("station_name") || "Unknown Station";

// Set email subject
msg.topic = `Inspection ${result} - ${station}`;

// Set email body
msg.payload = `Inspection Report:
Status: ${result}
Station: ${station}
Time: ${timestamp}
Image: ${msg.payload.image_url || "No image available"}

Please review and take appropriate action.`;

return msg;

Bước 8: Ví Dụ Flow Hoàn Chỉnh

8.1 Import Flow Có Sẵn

Bạn có thể import flow JSON hoàn chỉnh này:

[
  {
    "id": "email_node_1",
    "type": "e-mail",
    "name": "Send Inspection Alert",
    "server": "smtp.gmail.com",
    "port": "465",
    "secure": true,
    "authtype": "BASIC",
    "to": "quality@company.com"
  },
  {
    "id": "format_email",
    "type": "function",
    "name": "Format Email Content",
    "func": "const result = msg.payload.result ? 'PASSED' : 'FAILED';\nmsg.topic = `Inspection ${result}`;\nmsg.payload = `Status: ${result}\\nTime: ${new Date()}`;\nreturn msg;"
  }
]

8.2 Tùy Chỉnh Theo Nhu Cầu Của Bạn

1. Cập nhật địa chỉ email cho tổ chức của bạn
2. Chỉnh sửa nội dung email theo yêu cầu cụ thể
3. Điều chỉnh thời gian và điều kiện trigger
4. Kiểm thử kỹ lưỡng trước khi triển khai production

Xử Lý Sự Cố

Các Vấn Đề Thường Gặp

Vấn Đề	Triệu Chứng	Giải Pháp
Xác thực thất bại	Lỗi "Login failed"	Kiểm tra app password chính xác và đã bật xác thực 2 bước
Hết thời gian kết nối	Không gửi được email, lỗi timeout	Kiểm tra cài đặt firewall, xác minh SMTP server và port
Email vào spam	Email được gửi nhưng vào thư mục spam	Thêm người gửi vào safe list, cải thiện nội dung email
Flow không kích hoạt	Không có debug output	Kiểm tra kết nối flow và điều kiện trigger

Debug Email Flow Của Bạn

1. Thêm debug node sau mỗi bước để theo dõi dữ liệu
2. Kiểm tra Node-RED logs để xem thông báo lỗi chi tiết
3. Kiểm thử cài đặt SMTP bằng email client bên ngoài nếu cần
4. Xác minh kết nối mạng từ camera đến Gmail servers

Thành Công! Tích Hợp Email Của Bạn Đã Hoàn Tất

Camera OV10i của bạn hiện có thể:

✅ Gửi thông báo email tự động cho kết quả kiểm tra

✅ Cung cấp thông điệp định dạng phong phú với chi tiết kiểm tra

✅ Hỗ trợ nhiều người nhận và quy trình escalation

✅ Cung cấp báo cáo theo lịch và các bản tóm tắt

✅ Xử lý thông điệp có điều kiện dựa trên kết quả kiểm tra

Thực Tiễn Tốt Nhất

Quản Lý Email

• Sử dụng tiêu đề mô tả với chỉ báo trạng thái rõ ràng
• Giữ thông điệp ngắn gọn nhưng đầy đủ thông tin
• Bao gồm timestamp và định danh station
• Cung cấp thông tin có thể hành động trong thông báo

Bảo Mật và Độ Tin Cậy

• Bảo vệ app password - lưu trữ an toàn và thay đổi định kỳ
• Sử dụng tài khoản email riêng cho thông báo hệ thống
• Kiểm thử việc gửi email thường xuyên để đảm bảo độ tin cậy
• Giám sát các lỗi gửi và có phương thức thông báo dự phòng

Cân Nhắc Về Hiệu Suất

• Giới hạn tần suất gửi email để tránh bị phát hiện là spam
• Sử dụng danh sách người nhận phù hợp cho các loại cảnh báo khác nhau
• Triển khai giới hạn tốc độ (rate limiting) cho các hệ thống có lưu lượng cao
• Cân nhắc kích thước email khi đính kèm các tệp lớn

Các Bước Tiếp Theo

Sau khi thiết lập thông báo email:

1. Tạo các mẫu email cho các loại cảnh báo khác nhau
2. Thiết lập danh sách phân phối cho các bên liên quan
3. Triển khai quy trình leo thang (escalation workflows) cho các sự cố nghiêm trọng
4. Tạo báo cáo định kỳ cho ban quản lý
5. Tích hợp với các hệ thống thông báo khác (SMS, Teams, v.v.)

Bỏ qua thiết lập thủ công

Integration Builder có thể tạo ra các flow thông báo email hoàn chỉnh từ mô tả bằng tiếng Anh đơn giản. Mô tả những gì bạn muốn (ví dụ: "gửi email kèm hình ảnh kiểm tra khi phát hiện lỗi") và nhận được một Node-RED flow sẵn sàng sử dụng trong vài giây.

🔗 Xem Thêm

• Gửi Tin Nhắn Đến Microsoft Teams Với Node-RED
• Kiến Thức Cơ Bản Về Node-RED
• Các Custom Block Node-RED Của Overview
• Thiết Lập Metadata
• Thiết Lập Logic Digital Output