twenty/packages/twenty-docs/l/vi/user-guide/workflows/workflow-troubleshooting.mdx

---
title: Xử lý sự cố quy trình làm việc
info: Gỡ lỗi và tối ưu hóa quy trình làm việc của bạn với các kỹ thuật khắc phục sự cố và mẹo tối ưu hóa hiệu suất.
image: /images/user-guide/what-is-twenty/20.png
sectionInfo: Tự động hóa quy trình và tích hợp với các công cụ bên ngoài
---

<Frame>
  <img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
</Frame>

## Gỡ lỗi với quá trình chạy quy trình làm việc

Sử dụng giao diện **Chạy Quy trình làm việc** để gỡ lỗi các vấn đề:

- Truy cập thông qua bảng **Chạy** trong trình chỉnh sửa quy trình làm việc
- Nhấp vào các lần chạy riêng lẻ để xem dữ liệu đầu vào/đầu ra cho từng bước
- Kiểm tra trạng thái thực thi, thông báo lỗi và luồng dữ liệu giữa các bước

## Các vấn đề và giải pháp thường gặp

### Quy trình làm việc không kích hoạt

**Vấn đề**: Quy trình làm việc không thực thi như mong đợi.

**Giải pháp**:

- Xác minh rằng quy trình làm việc đang **Hoạt động** (không ở chế độ Nháp)
- Kiểm tra cấu hình kích hoạt khớp với cấu trúc dữ liệu của bạn
- Đối với các kích hoạt Hồ sơ, đảm bảo đối tượng và trường chính xác được chọn
- Đối với các kích hoạt Webhook, xác minh URL và định dạng dữ liệu mong đợi
- Đối với các kích hoạt Lên lịch, kiểm tra cấu hình thời gian

### Biểu mẫu không thể truy cập

**Vấn đề**: Hành động biểu mẫu khó tìm hoặc truy cập trong các quy trình tự động.

<Warning>
Hiện tại các biểu mẫu được thiết kế chỉ cho các kích hoạt thủ công. Đối với các quy trình làm việc với các kích hoạt khác (Hồ sơ Được tạo, Cập nhật, v.v.), biểu mẫu chỉ có thể truy cập thông qua giao diện và không mang lại trải nghiệm người dùng như mong đợi. Một trung tâm thông báo sẽ được phát hành vào năm 2026 để hỗ trợ đúng đắn cho các biểu mẫu trong các quy trình tự động.
</Warning>

**Giải pháp tạm thời**: Sử dụng kích hoạt thủ công khi cần biểu mẫu, hoặc cấu trúc lại quy trình làm việc để tránh sử dụng biểu mẫu trong các quy trình tự động.

### Tiêu thụ tín dụng cao

**Vấn đề**: Quy trình làm việc sử dụng nhiều tín dụng hơn dự kiến.

**Nguyên nhân phổ biến & Giải pháp**:

- **Gọi API kém hiệu quả**: Gộp các cuộc gọi API khi có thể thay vì các yêu cầu riêng lẻ
- **Cấu hình kích hoạt thủ công sai**: Sử dụng `Bulk` để xử lý nhiều bản ghi trong một lần chạy quy trình làm việc
- **Thiếu bộ lọc**: Thêm logic điều kiện để dừng quy trình khi không đáp ứng tiêu chí
- **Bước không cần thiết**: Loại bỏ các hành động dư thừa và tối ưu hóa logic quy trình làm việc
- **Real-time vs. Scheduled**: Use scheduled workflows for non-urgent processes

### Giới hạn quy trình làm việc đồng thời

**Vấn đề**: Đạt đến giới hạn 100 quy trình làm việc đồng thời trên mỗi không gian làm việc.

<Warning>
You cannot run more than 100 workflows in parallel at any given time per workspace.
</Warning>

**Giải pháp**:

- Sử dụng `Bulk` trong kích hoạt thủ công để xử lý nhiều bản ghi trong một lần chạy
- Triển khai trì hoãn giữa các lần thực thi quy trình làm việc bằng cách sử dụng kích hoạt lên lịch
- Tối ưu hóa quy trình làm việc để chạy nhanh hơn và giảm thời gian thực thi đồng thời
- Cân nhắc xử lý hàng loạt trong thời gian không cao điểm

### Giới hạn tỷ lệ API

**Vấn đề**: Cuộc gọi API bên ngoài thất bại do giới hạn tỷ lệ.

**Giải pháp**:

- Sử dụng quy trình làm việc được lên lịch thay vì kích hoạt thực tế khi có thể
- Triển khai trì hoãn giữa các cuộc gọi API trong các hành động Mã
- Tổng hợp yêu cầu API khi dịch vụ bên ngoài hỗ trợ
- Theo dõi các lần chạy quy trình làm việc để phát hiện lỗi giới hạn tỷ lệ và điều chỉnh thời gian

### Vấn đề Trình lặp

**Vấn đề**: Các hành động Trình lặp không hoạt động như mong đợi.

**Giải pháp**:

- **Chú ý**: Trình lặp hiện đang trong phiên bản beta. Kích hoạt nó trong Cài đặt → Phát hành → Phòng thí nghiệm
- Xác minh rằng đầu vào là một mảng bản ghi từ bước trước
- Kiểm tra xem các hành động trong Trình lặp được cấu hình đúng không
- Sử dụng Trình lặp với `Bulk` cho hiệu suất tối ưu

### Thiếu quyền

**Vấn đề**: Không thể truy cập vào phần quy trình làm việc.

<Warning>
Nếu bạn không thấy phần Quy trình làm việc, đây là do vấn đề quyền. Liên hệ với quản trị viên không gian làm việc của bạn để cấp quyền truy cập vào các quy trình làm việc.
</Warning>

## Mẹo Tối ưu hóa

### Thực tiễn Tốt nhất về Hiệu suất

- **Bắt đầu đơn giản** và tăng dần độ phức tạp
- **Sử dụng `Bulk`** cho các kích hoạt thủ công để xử lý hiệu quả nhiều bản ghi
- **Thêm bộ lọc sớm** để dừng quy trình khi không đáp ứng tiêu chí
- **Gộp các cuộc gọi API** và sử dụng quy trình làm việc được lên lịch cho các quy trình không khẩn cấp
- **Ẩn các lần chạy quy trình làm việc** khỏi các trang hiển thị tất cả các quy trình làm việc để cải thiện hiệu suất tải
- **Theo dõi sử dụng tín dụng** thường xuyên trong Cài đặt → Hóa đơn

### Ngăn ngừa lỗi

- **Kiểm tra trong chế độ nháp** trước khi kích hoạt quy trình làm việc
- **Xác nhận phản hồi API** và thực hiện các hành động dự phòng
- **Sử dụng tên bước mô tả** để dễ bảo trì hơn
- **Tài liệu logic phức tạp** cho các thành viên trong nhóm

## Nhận trợ giúp

### Tài nguyên tự phục vụ

- Xem [Tính năng Quy trình làm việc](/l/vi/user-guide/workflows/workflow-features) để biết thông tin chi tiết kỹ thuật
- Kiểm tra [Tín dụng Quy trình làm việc](/l/vi/user-guide/workflows/workflow-credits) cho mẹo tối ưu hóa
- Khám phá [Tự động hóa nội bộ](/l/vi/user-guide/workflows/internal-automations) và [Tích hợp Công cụ Bên ngoài](/l/vi/user-guide/workflows/external-tool-integration) cho ví dụ

### Hỗ trợ chuyên nghiệp

- Liên hệ với [Dịch vụ Chuyên nghiệp](/l/vi/user-guide/workflows/professional-services) của chúng tôi để khắc phục sự cố phức tạp
- Liên lạc với bộ phận hỗ trợ qua contact@twenty.com để được hỗ trợ kỹ thuật