> ## Documentation Index
> Fetch the complete documentation index at: https://learn.cleeksy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mã lỗi & thông báo lỗi (Error messages)

> Tra cứu lỗi thường gặp và hướng xử lý nhanh.

Trang này tổng hợp **lỗi phổ biến** theo nhóm và hướng xử lý nhanh. Mục tiêu là giúp tự chẩn đoán trước khi cần hỗ trợ.

***

## 1) Lỗi quyền (permissions)

**Triệu chứng**

* Không thấy view/entity/record
* Không sửa được field
* Không chạy được bước workflow

**Nguyên nhân thường gặp**

* Chưa được mời vào app hoặc role sai
* View/record bị giới hạn theo role
* Workflow step yêu cầu role khác

**Cách xử lý**

* Kiểm tra theo checklist: [Quyền & truy cập (Permissions & access)](/troubleshooting/permissions-access)

***

## 2) Lỗi dữ liệu (data/validation)

**Triệu chứng**

* Không lưu được record
* Field báo thiếu hoặc sai định dạng
* Formula lỗi hoặc cho kết quả trống

**Nguyên nhân thường gặp**

* Field bắt buộc chưa nhập
* Date/number sai format
* Công thức tham chiếu field không tồn tại/không phù hợp kiểu dữ liệu

**Cách xử lý**

* Kiểm tra field type và giá trị nhập
* Kiểm tra ràng buộc bắt buộc và validation trong UI cấu hình

***

## 3) Lỗi workflow & automation

**Triệu chứng**

* Workflow không kích hoạt
* Step không được gán người phụ trách
* Automation rules chạy lặp hoặc tạo spam

**Nguyên nhân thường gặp**

* Điều kiện entry/trigger không thoả
* Trạng thái (Status) không đúng
* Rule thiếu điều kiện chặn vòng lặp

**Cách xử lý**

* Xem lại điều kiện và status
* Áp dụng guardrails chống spam trong: [Thông báo & giao việc](/build-apps/notifications-tasks)

***

## 4) Lỗi Data Connection / publish-consume

**Triệu chứng**

* Không chọn được data source
* Data Connection/Lookup/Rollup không thấy dữ liệu
* Dữ liệu liên kết sai hoặc trống

**Nguyên nhân thường gặp**

* App nguồn chưa publish dataset hoặc chưa chia sẻ đúng data source
* Field liên kết cấu hình sai
* Quyền xem dữ liệu nguồn bị chặn

**Cách xử lý**

* Checklist: [Liên kết dữ liệu (Data connections)](/troubleshooting/data-connections)

***

## 5) Lỗi portal/webhook/API

**Triệu chứng**

* Webhook nhận 401/403/timeout
* API trả lỗi token hoặc rate limit
* Submission không tạo record

**Nguyên nhân thường gặp**

* Token sai/hết hạn
* Payload thiếu field bắt buộc
* Endpoint/URL sai

**Cách xử lý**

* Kiểm tra token và cấu hình data source
* Dùng cách xử lý lỗi và idempotency: [Webhook portal (cổng webhook)](/build-apps/integrations/webhook-portal)

***

## Khi nào cần hỗ trợ?

* Lỗi xảy ra ngẫu nhiên, không tái hiện được
* Có rủi ro dữ liệu (mất dữ liệu, sai dữ liệu hàng loạt)
* Liên quan đến tích hợp ngoài với lỗi xác thực/giới hạn phức tạp

Gợi ý: ghi lại **triệu chứng + bước tái hiện + ảnh chụp cấu hình** để hỗ trợ nhanh hơn.