- 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 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. Khi Hub có bản dịch
tiếng Việt, API thêm bản dịch đó sau
· Tạm dịch:, còn màn hình Đăng bài hiển thị bản dịch
thay cho câu tiếng Anh. 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ý:
- 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.
- 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.
- 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 bên dưới. Nối lại không gỡ được trường hợp đó.
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.
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/mp4Google Drive URL does not point to a video file. Content-Type: text/htmlVideo URL is not accessible
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ý:
- Đặt quyền chia sẻ thành bất kỳ ai có đường liên kết đều xem được.
- Dùng link tải trực tiếp, không dùng link xem trước.
- 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 đó.
- 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.Mastodon status is too long (724 characters). This instance allows a maximum of 500 characters.Invalid platforms for photo upload: ['youtube']
<platform>_caption, <platform>_title, hoặc một ô “Riêng từng nền tảng”
trong trình soạn bài. Chữ đó được gửi đúng như bạn viết. Mastodon là trường hợp hay gặp: 500 chỉ là
mức mặc định, mỗi máy chủ tự đặt giới hạn riêng, và máy chủ từ chối chữ vượt mức đó.
Cách xử lý: rút ngắn chữ bạn đã viết riêng cho nền tảng đó. Với Mastodon, hãy rút ngắn theo
con số trong thông báo, hoặc quay về một caption dùng chung, vì caption này được cắt còn 500 cho
Mastodon. Tiêu đề hoặc mô tả quá dài có trường riêng trong
tùy chọn theo nền tảng. 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).
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 để 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_DOWNLOADX API request failed during video upload: 401 Client Error: UnauthorizedRequest failed (502)
Idempotency-Key để 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ợ kèm thời điểm và nền tảng.
Một số nền tảng thất bại
Bạn thấy: từng nền tảng đã từ chối kèm lý do riêng, ví dụ- ở cột Kết quả của màn hình Đăng bài:
Mastodon: Bài đăng Mastodon quá dài (724 ký tự). Máy chủ Mastodon này cho phép tối đa 500 ký tự. - qua API, và ở trang Tổng quan:
Mastodon: Mastodon status is too long (724 characters). This instance allows a maximum of 500 characters. · Tạm dịch: Bài đăng Mastodon quá dài (724 ký tự). Máy chủ Mastodon này cho phép tối đa 500 ký tự. TikTok: Nền tảng từ chối bài đăng.khi nền tảng không nêu lý doMột số nền tảng thất bại: tiktok, youtubeở các bài từ trước 01/10/2026
POST /v1/posts/retry kèm request_id của bài, lấy từ
câu trả lời lúc đăng, thư báo lỗi hoặc GET /v1/posts/history. Cả hai cách đều
không tính thêm lượt đăng. Nếu một luồng tự động (n8n, Make,
code của bạn) gửi lại bài bằng cách gọi lại endpoint đăng bài, bài sẽ lên thêm một bản ở mọi nơi bản
đầu đã lên. Hãy cho luồng đó gọi retry.
Khi mọi nền tảng đều từ chối, bài được ghi nhận là “Không đăng được”: không có gì được đăng,
nên sửa nội dung rồi gửi lại cả bài là an toàn.
Thư báo bài lỗi
Khi có bài không đăng được, Hub gửi thư cho chủ tài khoản, thường mỗi ngày một lần vào khoảng 08:30 giờ Việt Nam. Mỗi dòng trong thư nêu lý do, số bài gặp lỗi đó và giờ từng bài bị lỗi theo giờ Việt Nam (bài đã lên lịch thì là giờ đã lên lịch đăng), kèmrequest_id để gọi retry với bài đã lên được
một số nền tảng. Thư có thể đến sau lúc lỗi nhiều giờ, và thư không biết những bài bạn đã tự đăng lại:
bài nào bạn đã đăng lại thành công thì bỏ qua dòng của bài đó. Bài đã lên được một số nền tảng thì chỉ
gửi lại những nền tảng đã lỗi, như mục Một số nền tảng thất bại. Bài không
lên được nền tảng nào thì sửa lỗi rồi gửi lại cả bài.