Action Node - Integration - Send Email

I. Tổng quan

Node Send Email dùng để gửi email từ flow. Đây là node mẫu bám trực tiếp ý tưởng từ Figma node Email trong page AdaFlow.

1. Vấn đề

  • Nhiều flow cần gửi email xác nhận, chăm sóc hoặc thông báo nội bộ sau một trigger nhất định. Nếu không có action email chuẩn trong builder thì việc gửi email phải cấu hình ở hệ thống ngoài.

2. Giải pháp

  • Cung cấp action Send Email cho phép chọn người gửi, người nhận, nội dung và file đính kèm ngay trong flow.

3. Đối tượng

  • Người cấu hình marketing automation, CRM automation hoặc flow thông báo.

4. Tầm nhìn/insight

  • Tương lai có thể mở rộng thêm tracking mở mail, click mail, A/B template hoặc nhiều nhà cung cấp email.

II. Yêu cầu chức năng

1. Danh sách tính năng

  • Chọn email người gửi.
  • Chọn hoặc map email người nhận.
  • Chọn dùng mẫu có sẵn hoặc soạn mới.
  • Nhập tiêu đề và nội dung.
  • Đính kèm file nếu hệ thống hỗ trợ.

2. Đặc tả chi tiết

  • Use case 1.1 (Dùng mẫu có sẵn): User thêm node Send Email -> Chọn email người gửi -> Map email người nhận -> Chọn Sử dụng mẫu có sẵn -> Chọn mẫu -> Lưu node -> Khi flow chạy, hệ thống gửi email theo template đã chọn.
  • Use case 1.2 (Soạn mới): User chọn Soạn mới -> Nhập tiêu đề, nội dung -> Tùy chọn đính kèm file -> Khi flow chạy, hệ thống gửi email theo nội dung vừa cấu hình.
  • Use case 1.3 (Exception - Thiếu người nhận): User không cấu hình email người nhận -> Node ở trạng thái không hợp lệ và flow không được xuất bản.

3. Danh sách nghiệp vụ

  • Node phải có email người gửi hợp lệ hoặc account gửi hợp lệ theo integration đang dùng.
  • Email người nhận phải lấy được từ input của flow hoặc từ cấu hình tĩnh.
  • Theo Figma, node hỗ trợ tối thiểu các field:
    • Email người gửi
    • Email người nhận
    • Chọn Sử dụng mẫu có sẵn hoặc Soạn mới
    • Tiêu đề
    • Nội dung
    • File đính kèm
  • Output của node nên ghi nhận kết quả gửi email hoặc mã định danh message nếu integration cung cấp.

4. Giao diện

  • Figma tham chiếu:
    • https://www.figma.com/design/tBBrdtHlG1LAYJUfJsvyS3/UCALL-2026–Ant-Design-5.10.1-?node-id=4-154796&m=dev
  • Lưu ý: Hình dưới đây chỉ mang tính minh họa cho panel cấu hình node Send Email, không phải ảnh thiết kế giao diện chính thức trích xuất trực tiếp từ Figma.
  • Thiết kế giao diện chính thức xem tại:
    • https://www.figma.com/design/tBBrdtHlG1LAYJUfJsvyS3/UCALL-2026–Ant-Design-5.10.1-?node-id=4-154796&m=dev

Minh họa panel Send Email

  • Card node hiển thị nhãn Email.
  • Panel cấu hình hiển thị các field giống frame Email trên Figma.

III. Yêu cầu phi chức năng

  • Việc gửi email cần ghi log đủ để đối chiếu khi fail.
  • Nội dung email và file đính kèm phải tuân theo giới hạn của nhà cung cấp gửi mail nếu có.

IV. Dependency (liên quan & phụ thuộc)

  • flow.md
  • Service gửi email
  • Mẫu email hoặc thư viện template nếu có

V. API Contract (dev viết)

  • Chưa chốt API chi tiết.

VI. Test case (BA hoặc tester viết)

  • TC1: Chọn sender, recipient và dùng template hợp lệ -> Email được gửi thành công.
  • TC2: Chọn chế độ soạn mới và nhập đủ tiêu đề/nội dung -> Email được gửi thành công.
  • TC3: Bỏ trống email người nhận -> Node không hợp lệ.