> ## Documentation Index
> Fetch the complete documentation index at: https://docs.madiad.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Vì sao bài không đăng được
> Danh mục các thông báo lỗi thật khi đăng bài, vì sao nó xảy ra và cách xử lý từng loại.
Trang này liệt kê những câu báo lỗi bạn thực sự nhìn thấy khi một bài không lên được, kèm nguyên
nhân và cách xử lý. Nội dung lấy từ nhật ký đăng bài thật của hệ thống, không phải câu hỏi tự nghĩ ra.
Cần phân biệt hai thứ:
* **Trang này** nói về việc **một bài cụ thể không đăng được**, thường do nền tảng đích từ chối.
* [Bảng mã lỗi](/vi/concepts/errors) nói về **mã lỗi API** (`401`, `429`, `platform_not_connected`...)
mà code của bạn nhận được. Nếu bạn đang viết tích hợp thì đọc trang đó.
Câu báo lỗi hiển thị nguyên văn từ nền tảng đích, thường bằng tiếng Anh, kèm phần **Tạm dịch**
khi Hub dịch được. Tìm nhanh: bấm Ctrl+F (hoặc Cmd+F) rồi dán vài chữ trong câu lỗi của bạn.
## Profile chưa nối tài khoản của nền tảng đó
**Bạn thấy:** `None of the requested platforms are valid for profile ... has no Instagram account configured`
Đây là nguyên nhân phổ biến nhất, bỏ xa các loại còn lại.
**Vì sao:** bài được gửi tới một nền tảng mà Profile đó chưa nối tài khoản, hoặc đã nối nhưng kết nối
bị mất hiệu lực. Kết nối rụng là chuyện bình thường: bạn đổi mật khẩu, thu hồi quyền, nền tảng
yêu cầu xác thực lại, hoặc chính nền tảng huỷ quyền sau một thời gian.
**Cách xử lý:**
1. Mở **Kết nối** trên dashboard và chọn đúng Profile đang dùng. Một tài khoản có nhiều Profile thì
rất dễ gửi bài bằng Profile khác với Profile đã nối.
2. Nếu nền tảng đó không xuất hiện trong danh sách đã nối, hãy nối lại và cấp quyền.
3. Nếu vừa nối lại mà vẫn hỏng, xem mục [Nền tảng đang hạn chế tài khoản](#nền-tảng-đang-hạn-chế-tài-khoản)
bên dưới. Nối lại không gỡ được trường hợp đó.
Gửi lại y nguyên request sẽ hỏng y như cũ. Phải nối tài khoản hoặc bỏ nền tảng đó khỏi `platforms`
trước khi thử lại.
## Nền tảng đang hạn chế tài khoản
**Bạn thấy:**
* `Instagram: Action suspected as spam. Activity is restricted.`
* `You have reached the daily posting cap on tiktok. Used 15/15 in the last 24 hours.`
**Vì sao:** nền tảng đang giới hạn chính tài khoản của bạn, không phải Hub gặp sự cố. Instagram hạ
tốc độ khi thấy hành vi giống spam (đăng dày, nội dung lặp, tài khoản mới). TikTok có trần số bài
trong 24 giờ.
**Cách xử lý:** giãn nhịp đăng, đa dạng nội dung, và với trần theo ngày thì dùng
[lên lịch](/vi/concepts/scheduling) để rải sang hôm sau. Không có cách nào từ phía Hub gỡ được giới
hạn này, và nối lại tài khoản cũng không giúp gì.
## File nguồn không hợp lệ
**Bạn thấy:**
* `Google Drive URL does not point to a video file. Content-Type: audio/mp4`
* `Google Drive URL does not point to a video file. Content-Type: text/html`
* `Video URL is not accessible`
**Vì sao:** Hub tải file từ link bạn gửi. Link chia sẻ của Google Drive thường trả về **trang xem
trước** (`text/html`) chứ không phải file, hoặc trả về luồng chỉ có tiếng (`audio/mp4`) khi file gốc
không đúng định dạng video. Link riêng tư thì Hub cũng không mở được.
**Cách xử lý:**
1. Đặt quyền chia sẻ thành **bất kỳ ai có đường liên kết đều xem được**.
2. Dùng link tải trực tiếp, không dùng link xem trước.
3. Tự kiểm nhanh trước khi gửi: mở link ở cửa sổ ẩn danh, nếu ra trang xem trước thì Hub cũng sẽ
nhận đúng trang đó.
4. Chắc chắn nhất là để file trên một nơi trả thẳng file video (S3, R2, CDN, hosting của bạn).
## Vượt giới hạn của nền tảng
**Bạn thấy:**
* `X: Tweet creation failed (403): This user is not allowed to post a video longer than 2 minutes.`
* `Pinterest description is too long (509 characters). Maximum allowed is 500.`
* `Pinterest title is too long (509 characters). Maximum allowed is 100.`
* `Tiêu đề gửi cho TikTok dài 784 ký tự, vượt giới hạn 90 của nền tảng này.`
* `Facebook title is too long (575 characters). Maximum allowed is 255.`
* `Invalid platforms for photo upload: ['youtube']`
**Vì sao:** mỗi nền tảng có giới hạn riêng về độ dài chữ, thời lượng video và loại nội dung được
nhận. Hub gửi đúng những gì bạn soạn, nền tảng từ chối thì Hub báo lại nguyên văn.
**Cách xử lý:** dùng [tùy chọn theo nền tảng](/vi/concepts/platform-options) để đặt tiêu đề và mô tả
RIÊNG cho nơi có giới hạn chặt, thay vì rút ngắn nội dung ở mọi nơi. Video quá dài với X thì cắt
riêng một bản cho X, hoặc bỏ X khỏi lần đăng đó và giữ các nền tảng còn lại. Bài chỉ có ảnh thì
không gửi tới YouTube, vì YouTube chỉ nhận video (xem [Kênh](/vi/concepts/channels)).
## Thiếu trường bắt buộc
**Bạn thấy:** `Title is required for Youtube. Provide a title.`
**Vì sao:** YouTube bắt buộc có tiêu đề riêng và không tự lấy từ nội dung bài.
**Cách xử lý:** điền tiêu đề trong phần tùy chọn riêng của YouTube trước khi gửi. Xem
[tùy chọn theo nền tảng](/vi/concepts/platform-options) để biết trường nào bắt buộc ở đâu.
## Lỗi tạm thời
**Bạn thấy:**
* `TikTok photo upload timed out or failed. Last seen status: PROCESSING_DOWNLOAD`
* `X API request failed during video upload: 401 Client Error: Unauthorized`
* `Request failed (502)`
**Vì sao:** nền tảng đích hoặc đường truyền gặp trục trặc nhất thời. Không phải do nội dung của bạn.
**Cách xử lý:** thử lại sau ít phút. Nếu gọi qua API, hãy gửi
[`Idempotency-Key`](/vi/concepts/idempotency) để lần thử lại không tạo ra bài trùng. Lặp lại nhiều
lần thì [liên hệ hỗ trợ](mailto:info@madiad.com) kèm thời điểm và nền tảng.
Riêng `upstream_timeout` thì **kết quả chưa xác định**: bài có thể đã lên. Kiểm tra lịch sử đăng
hoặc kiểm tra trực tiếp trên nền tảng trước khi gửi lại. Chi tiết ở [Bảng mã lỗi](/vi/concepts/errors).
## Một số nền tảng thất bại
**Bạn thấy:** `Một số nền tảng thất bại: tiktok, youtube`
**Vì sao:** đây là câu tổng hợp của Hub khi một lần đăng lên nhiều nền tảng chỉ hỏng ở vài nơi. Bài
đã lên ở những nền tảng còn lại, **đừng gửi lại toàn bộ** vì sẽ tạo bài trùng ở nơi đã thành công.
**Cách xử lý:** mở chi tiết lần đăng đó để xem nền tảng nào hỏng và vì sao, rồi tra đúng mục tương
ứng ở trên. Gửi lại CHỈ những nền tảng đã hỏng.
## Vẫn chưa rõ
Gửi cho chúng tôi thời điểm đăng, Profile, các nền tảng đã chọn và nguyên văn câu báo lỗi, qua
[info@madiad.com](mailto:info@madiad.com) hoặc hotline trong mục **Trợ giúp** trên dashboard.
Người thật trả lời.