Skip to main content
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 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 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 để 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 để đặ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).

​
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_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 để 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.
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.

​
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 hoặc hotline trong mục Trợ giúp trên dashboard. Người thật trả lời.