Thiết kế luồng Adaflow: khối chức năng, đường nối và dữ liệu

I. Các Nguyên Tắc Cốt Lõi Khi Thiết Kế Luồng

Trước khi bắt tay vào xây dựng luồng, người dùng cần ghi nhớ 4 nguyên tắc vận hành của Flow Builder:

1. Nguyên tắc “1 Trigger khởi phát duy nhất”: Mỗi luồng tự động bắt buộc phải bắt đầu bằng duy nhất 1 khối kích hoạt (Trigger Node). Khối này đóng vai trò lắng nghe sự kiện để kích nổ chuỗi hành động.
2. Nguyên tắc “Dòng chảy một chiều tuần tự (Directional Wiring)”: Dữ liệu di chuyển từ cổng xuất (Output port - chấm tròn bên phải) của node trước vào cổng nhận (Input port - chấm tròn bên trái) của node sau.
3. Nguyên tắc “Kế thừa biến đầu ra (Output Inheritance)”: Bất kỳ node hành động nào nằm phía sau đều có thể truy cập và sử dụng lại các trường dữ liệu được sinh ra từ các node phía trước thông qua cơ chế Dynamic Tags.
4. Nguyên tắc “Xác thực trước khi xuất bản (Mandatory Validation)”: Mọi node trong luồng đều phải điền đầy đủ các trường bắt buộc (được đánh dấu sao đỏ *). Nếu còn bất kỳ trường bắt buộc nào bỏ trống, hệ thống sẽ chặn xuất bản và báo lỗi trực quan.

---

II. Hướng Dẫn Thao Tác Từng Bước

Đường dẫn truy cập: Truy cập https://app.ucall.vn/dashboard/<company_id>/auto_flow và bấm nút + Thêm luồng ở góc trên bên phải màn hình.

---

1. Khởi Tạo Luồng Tự Động Mới

Bước 1: Mở modal Tạo luồng tự động hoá mới

Từ màn hình danh sách, nhấp vào nút + Thêm luồng màu xanh đậm ở góc trên bên phải. Hộp thoại khởi tạo sẽ xuất hiện ngay giữa màn hình.

Bước 2: Nhập tên luồng và nhấn Lưu

• Tên luồng tự động hoá (* Bắt buộc): Nhập tên mô tả rõ ràng mục tiêu nghiệp vụ của luồng (Ví dụ: Phân bổ Lead mới & Kích hoạt Callbot xác nhận).
• Nhấn nút Lưu (màu xanh đậm) để khởi tạo canvas. Nếu muốn thoát, nhấn nút Huỷ hoặc dấu X.

[!IMPORTANT] Trường Tên luồng tự động hoá là trường bắt buộc duy nhất tại bước khởi tạo ban đầu. Bạn nên đặt tên theo cấu trúc: [Hành động chính] - [Đối tượng áp dụng] - [Mục tiêu] để dễ quản lý và tra cứu sau này.

---

2. Khám Phá Không Gian Làm Việc Canvas (Builder Interface)

Sau khi nhấn Lưu, hệ thống chuyển sang màn hình Flow Builder với không gian thiết kế mở.

Không gian làm việc được chia thành 4 khu vực chức năng chính:

1. Thanh Header trên cùng:
   • Nút Quay lại (<): Trở về màn hình danh sách luồng.
   • Tên luồng & Biểu tượng sửa (Bút chì): Cho phép nhấp trực tiếp để đổi tên luồng bất kỳ lúc nào.
   • Biểu tượng liên kết (Xích): Sao chép đường dẫn truy cập trực tiếp đến luồng.
   • Nhãn trạng thái lưu: Hiển thị thời gian lưu tự động gần nhất (Ví dụ: Lưu lúc 28/09/2026 09:07).
   • Cảnh báo thay đổi: Huy hiệu màu xanh dương Có thay đổi chưa được xuất bản thông báo luồng đang có phiên bản nháp mới hơn bản đang chạy.
   • Nút Báo cáo chi tiết: Mở bảng lịch sử các phiên chạy của luồng.
   • Nút Kiểm thử: Mở giao diện chạy thử nghiệm luồng với dữ liệu giả lập.
   • Nút Xuất bản: Đưa toàn bộ cấu hình mới nhất vào vận hành thực tế.
2. Thanh Công Cụ Thêm Node (Menu Dọc Bên Trái):
   • Trigger (Biểu tượng sấm sét màu vàng): Mở danh mục các khối kích hoạt ban đầu.
   • CRM (Biểu tượng thẻ nhân viên màu xanh dương): Các khối thao tác với thực thể CRM (Liên hệ, Công ty, Đơn hàng, Cơ hội, Công việc, Lịch hẹn, Phiếu ghi, Gán nhân viên).
   • Đa kênh (Biểu tượng tin nhắn màu ngọc lam): Các khối gửi thông tin ra kênh bên ngoài (Email, Thông báo).
   • Logic (Biểu tượng rẽ nhánh màu cam): Các khối xử lý quy trình logic (Hẹn giờ, Rẽ nhánh điều kiện, AI Agent, HTTP Request).
3. Mặt Bàn Vẽ Canvas Trung Tâm: Khu vực hiển thị trực quan các thẻ node (Node cards) và các đường nối dây dẫn thể hiện trình tự thực thi.
4. Bộ Điều Hướng Canvas (Góc Dưới Bên Phải):
   • Bản đồ thu nhỏ (Minimap): Cung cấp góc nhìn toàn cảnh khi luồng có kích thước lớn.
   • Hoàn tác (↶) / Làm lại (↷): Phục hồi thao tác vừa thực hiện.
   • Tự động căn chỉnh bố cục: Căn thẳng hàng các node trên màn hình tự động.
   • Thu phóng (- / +): Điều chỉnh tỷ lệ xem từ 25% đến 200%.
   • Vừa màn hình (Fit to screen): Tự động căn chỉnh toàn bộ các node vừa vặn trong tầm mắt.

---

3. Thêm Node Và Kỹ Thuật Nối Dây (Wiring Nodes)

Bước 1: Đặt Node Kích Hoạt (Trigger) Lên Canvas

Bấm vào biểu tượng Trigger ở thanh công cụ bên trái > Chọn loại thực thể (Ví dụ: Liên hệ). Một card node hình chữ nhật màu trắng bo góc có icon xanh và nhãn số thứ tự 1 sẽ xuất hiện trên canvas.

Bước 2: Kéo Dây Kết Nối Sang Node Tiếp Theo

• Di chuột vào chấm tròn (Output handle) ở mép phải của Node 1. Con trỏ chuột chuyển sang dạng chữ thập.
• Nhấn giữ chuột trái và kéo dây dẫn hướng sang phía bên phải.
• Thả chuột vào chấm tròn (Input handle) ở mép trái của Node 2 (Ví dụ: Node Hẹn giờ hoặc Node Gán nhân viên).
• Dây dẫn sẽ tự động khóa lại thành một đường uốn cong mềm mại kết nối hai node.

---

4. Cấu Trúc Bảng Cấu Hình Node (Panel 3 Tab)

Khi nhấp chuột vào bất kỳ node nào trên canvas, một thanh trượt cấu hình (Drawer panel) sẽ mở ra từ cạnh phải màn hình. Tất cả các node đều tuân theo chuẩn mực 3 tab thống nhất:

1. Tab Hành động:
   • Cho phép chọn hành động cụ thể mà node sẽ thực hiện (Ví dụ: với node Liên hệ, chọn Liên hệ mới được tạo, Liên hệ được cập nhật, hay Lấy dữ liệu liên hệ).
2. Tab Cài đặt:
   • Nơi nhập toàn bộ tham số, quy tắc nghiệp vụ, bộ lọc dữ liệu và ánh xạ trường.
   • Các trường có dấu hoa thị đỏ * là bắt buộc phải chọn hoặc nhập giá trị.
3. Tab Đầu ra (Output):
   • Hiển thị cây danh mục toàn bộ các biến dữ liệu mà node này sẽ trích xuất và truyền cho các bước phía sau.

---

5. Cơ Chế Ánh Xạ Biến Động (Dynamic Tags & Data Mapping)

Một trong những sức mạnh cốt lõi của Autoflow là khả năng lấy dữ liệu từ bước trước để làm điều kiện hoặc giá trị cho bước sau mà không cần viết mã (No-Code):

Bước 1: Mở phần cấu hình cần ánh xạ dữ liệu

Ví dụ: Tại Node 3 (Liên hệ - Lấy dữ liệu liên hệ), mở tab Cài đặt > Mục Bộ lọc Liên hệ.

Bước 2: Thiết lập điều kiện lọc với Dynamic Tags

• Chọn trường dữ liệu cần so sánh: Danh sách số điện thoại.
• Chọn toán tử logic: Bằng với.
• Tại ô giá trị so sánh, bấm nút + để mở danh mục biến từ các node phía trước.
• Chọn [Kích hoạt liên hệ 1] > Danh sách số điện thoại. Hệ thống sẽ chèn một thẻ biến màu xanh dương nổi bật vào ô giá trị.

Bước 3: Tra cứu cấu trúc biến tại Tab Đầu ra

Nếu bạn không chắc node hiện tại cung cấp những trường dữ liệu nào, hãy chuyển sang tab Đầu ra. Toàn bộ cấu trúc JSON schema được hiển thị dưới dạng cây thư mục trực quan kèm kiểu dữ liệu (Str, List, Date).

---

6. Cơ Chế Bắt Lỗi Xác Thực Khi Thiếu Trường Bắt Buộc

Hệ thống tích hợp bộ kiểm tra an toàn tự động (Automated Validation Engine). Khi bạn thêm một node hành động nhưng chưa cấu hình đủ các trường bắt buộc, hệ thống sẽ cảnh báo bằng viền đỏ và thông báo lỗi cụ thể:

• Trường * Chọn chiến dịch có viền đỏ bao quanh.
• Dòng chữ thông báo lỗi xuất hiện ngay bên dưới: Vui lòng chọn chiến dịch.
• Nếu người dùng cố tình nhấn nút Xuất bản, hệ thống sẽ chặn hành động và cuộn màn hình đến đúng node bị lỗi để yêu cầu hoàn tất thông tin.

---

7. Quy Trình Kiểm Thử Và Xuất Bản Luồng (Publish Flow)

Bước 1: Kiểm thử luồng (Testing)

Bấm nút Kiểm thử trên thanh header. Chọn một bản ghi mẫu trong CRM hoặc nhập payload giả lập để chạy thử. Hệ thống sẽ mô phỏng dữ liệu đi qua từng node để bạn xem trước kết quả đầu ra.

Bước 2: Bấm Xuất bản (Publish)

Khi tất cả các node đều hiển thị trạng thái hợp lệ và không còn viền đỏ cảnh báo:

• Nhấn nút Xuất bản (màu xanh đậm có icon đĩa mềm) ở góc trên bên phải.
• Hệ thống tiến hành xác thực toàn luồng. Khi xuất bản thành công, một thông báo xanh xuất hiện, huy hiệu đổi thành Đã xuất bản kèm mã phiên bản mới (Ví dụ: Phiên bản 7d1f38).
• Luồng chính thức chuyển sang trạng thái Hoạt động và tự động thực thi khi có sự kiện thực tế phát sinh.

---