> ## 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.

# Tích hợp (Integrations)

> Khắc phục lỗi tích hợp và các cổng dữ liệu.

Trang này tổng hợp lỗi phổ biến khi cấu hình và vận hành:

* Internal/Public portal
* Webhook portal
* API portal
* Connected app (kết nối giữa các app)

Liên quan:

* [Các loại cổng dữ liệu (Data source types)](/reference/data-source-types)
* [Bảo mật (Security)](/build-apps/integrations/security-tokens)

***

## Checklist nhanh

1. Đúng loại data source chưa? (portal/webhook/API/connected app)
2. Token/credentials đúng và còn hiệu lực không?
3. Payload/request có đủ field bắt buộc không?
4. Có lỗi quyền (permissions) ở entity/field không?
5. Có log/response để đối chiếu không?

***

***

## 2) Webhook: nhận 401/403/timeout

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

* Token sai/hết hạn
* URL endpoint sai hoặc bị chặn bởi mạng/proxy
* Timeout do payload lớn hoặc hệ thống ngoài retry không đúng

### Cách xử lý

* Xác nhận token và endpoint
* Giảm payload về mức tối thiểu cần thiết
* Thiết kế retry có idempotency ở mức dữ liệu (tránh tạo trùng)

Liên quan: [Webhook portal (cổng webhook)](/build-apps/integrations/webhook-portal)

***

## 3) API: gọi được nhưng dữ liệu “không đúng”

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

* Filter/parameter sai
* Quyền xem dữ liệu bị giới hạn theo role/visibility
* Endpoint thao tác nhầm entity/field

### Cách xử lý

* Thử gọi API với phạm vi nhỏ (1 record) để đối chiếu
* Kiểm tra quyền và điều kiện hiển thị record
* Kiểm tra mapping field type (date/number)

Liên quan: [API portal (cổng API)](/build-apps/integrations/api-portal)

***

## 4) Connected app: không thấy data source để chọn

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

* App nguồn chưa publish data source hoặc chưa chia sẻ cho consuming app
* Chưa cấu hình đúng cơ chế chia sẻ dữ liệu

### Cách xử lý

* Xem checklist tại: [Liên kết dữ liệu (Data connections)](/troubleshooting/data-connections)
* Tra cứu cơ chế tại: [Chia sẻ dữ liệu (Publish/Consume)](/reference/publish-consume)

***

## Chuẩn bị thông tin khi cần hỗ trợ

* Loại data source và tên data source
* Entity/field mapping
* Mã lỗi/HTTP status và response (nếu có)
* Ảnh chụp cấu hình token (che phần nhạy cảm)
* Thời điểm lỗi và request mẫu