Khắc phục sự cố & câu hỏi thường gặp

Lỗi đăng nhập SSO

Triệu chứng: Nhấn “Đăng nhập” bị chuyển về trang lỗi hoặc thông báo “Tài khoản này đã bị vô hiệu hóa.”

Nguyên nhân & cách xử lý:

Thông báo lỗi	Nguyên nhân	Cách xử lý
Tài khoản bị vô hiệu hóa	Quản trị viên đã vô hiệu hóa tài khoản	Liên hệ quản trị viên để kích hoạt lại
Đăng nhập sai quá nhiều lần	Tài khoản bị khóa tạm thời	Chờ vài phút hoặc đặt lại mật khẩu
Vui lòng xác nhận email	Email chưa được xác minh	Kiểm tra hộp thư và nhấn liên kết xác minh
Lỗi phiên IdP / OIDC	Phiên IdP hết hạn hoặc cookie bị xóa	Đóng trình duyệt, mở lại và thử đăng nhập

Mẹo

Nếu tổ chức dùng SSO và bạn không có quyền đặt lại mật khẩu, hãy liên hệ bộ phận IT nội bộ — AgentFlow không quản lý thông tin xác thực của nhà cung cấp danh tính.

Cửa sổ popup OAuth bị chặn

Triệu chứng: Nhấn “Kết nối” trong mục Tích hợp nhưng không có cửa sổ nào xuất hiện.

Nguyên nhân: Trình duyệt chặn popup tự động.

Cách xử lý:

1. Tìm biểu tượng chặn popup trên thanh địa chỉ trình duyệt.
2. Chọn “Luôn cho phép popup từ trang này” rồi nhấn Kết nối lại.
3. Nếu dùng trình chặn quảng cáo (uBlock Origin, AdGuard…), tạm tắt cho domain AgentFlow.

Không thể xuất bản quy trình (lỗi xác thực)

Triệu chứng: Nhấn Xuất bản nhưng có thông báo lỗi đỏ, một số bước bị đánh dấu.

Nguyên nhân: Quy trình còn thiếu thông tin bắt buộc hoặc có cấu hình không hợp lệ.

Cách xử lý:

1. Nhấn vào từng bước bị đánh dấu đỏ trong thiết kế để xem chi tiết lỗi.
2. Các lỗi thường gặp:

Lỗi	Cách sửa
Bước chưa được nối	Kiểm tra mọi bước (trừ End) đều có ít nhất một cạnh đầu ra
Biểu mẫu chưa được chọn	Mở bước Công việc người dùng (Human) và chọn Biểu mẫu
Thiếu điều kiện nhánh	Mở bước Quyết định (Decision) và điền đầy đủ điều kiện cho mỗi nhánh
Tham chiếu biến không hợp lệ	Dùng bộ chọn biến thay vì nhập tay đường dẫn

Ghi chú

Trong ví dụ “Đề xuất mua sắm”, nếu bước Quyết định thiếu nhánh “Từ chối”, quy trình sẽ không qua được kiểm tra và không thể Xuất bản.

Không nhận được công việc

Triệu chứng: Phiên chạy đang ở bước Công việc người dùng (Human) nhưng bạn không thấy công việc trong danh sách.

Nguyên nhân & cách xử lý:

Nguyên nhân	Cách xử lý
Bạn không nằm trong danh sách người được giao	Liên hệ người thiết kế quy trình để kiểm tra cấu hình Phân công
Bạn chưa có quyền truy cập nhóm	Quản trị viên thêm bạn vào Nhóm được giao
Bộ lọc Hộp thư đang ẩn công việc	Xóa bộ lọc hoặc chuyển sang tab “Tất cả”
Phiên chạy đang chờ bước trước	Kiểm tra xem bước trước đó đã hoàn thành chưa

Khóa bí mật đang được sử dụng

Triệu chứng: Thông báo lỗi khi cố xóa hoặc thay thế một Khóa bí mật.

Nguyên nhân: Khóa đang được tham chiếu bởi ít nhất một Tích hợp hoặc kết nối đang hoạt động.

Cách xử lý: Vào danh sách Tích hợp, tìm kết nối đang dùng khóa đó, ngắt kết nối hoặc cập nhật sang khóa mới, rồi thử xóa lại.

Kết nối tích hợp “Cần kết nối lại”

Triệu chứng: Trạng thái kết nối hiển thị “Cần kết nối lại” (needs reconnect).

Nguyên nhân: Token truy cập của nhà cung cấp bên ngoài đã hết hạn hoặc bị thu hồi (ví dụ: người dùng đổi mật khẩu HubSpot, hoặc quản trị viên thu hồi quyền của ứng dụng).

Cách xử lý:

1. Vào Cài đặt → Tích hợp.
2. Nhấn Kết nối lại trên kết nối bị ảnh hưởng.
3. Hoàn thành luồng OAuth trong cửa sổ popup.

Các phiên chạy đang tạm dừng do lỗi kết nối sẽ tự tiếp tục sau khi kết nối được khôi phục thành công.

Lỗi xung đột phiên bản (409 Stale version)

Triệu chứng: Khi lưu bản nháp, nhận thông báo lỗi xung đột hoặc “phiên bản cũ”.

Nguyên nhân: Hai người đang chỉnh sửa cùng một quy trình, hoặc tab trình duyệt của bạn bị mở quá lâu mà không tải lại.

Cách xử lý:

1. Tải lại trang để lấy phiên bản mới nhất.
2. Áp dụng lại các thay đổi của bạn.
3. Lưu ngay để tránh xung đột tiếp theo.

Chú ý

Nếu đội nhóm cùng chỉnh sửa quy trình quan trọng, hãy thống nhất chỉ một người chỉnh sửa tại một thời điểm để tránh mất dữ liệu.

Cần thêm trợ giúp?

Nếu vấn đề của bạn không có trong danh sách trên, hãy liên hệ quản trị viên hệ thống hoặc xem thêm tại Thuật ngữ.