כשלי פרסום ב-TikTok: spam_risk_too_many_posts, picture_size_check_failed ושאר סיבות הכשל
TikTok מציינת את סיבת הכשל של פוסט בשדה reason בנקודת הקצה של הסטטוס ב-API for Business, או בשדה fail_reason ב-Content Posting API. כשלי בדיקה כמו picture_size_check_failed משמעותם שהקובץ שובר כלל פורמט ודורש שינוי; video_pull_failed משמעותו ש-TikTok לא הצליחה להוריד אותו תוך שעה; spam_risk_too_many_posts משמעותו יותר מדי פוסטים דרך ה-API ב-24 שעות. כשל המסומן internal אפשר פשוט לנסות אותו שוב.
easyCoexistence עוקבת אחרי כל פוסט של TikTok שהיא מפרסמת, עד ש-TikTok משלימה אותו או מכשילה אותו, בין אם זה עבור Claude, ChatGPT או פלטפורמה משלכם.
השדה בנקודת הקצה /business/publish/status/ מוחזר רק כשהסטטוס הוא FAILED, עם ערכים כמו frame_rate_check_failed.
השם של אותו שדה ב-Content Posting API, בתגובות של /v2/post/publish/status/fetch/
זמן הורדה מקסימלי, שאחריו TikTok מכשילה פוסט עם video_pull_failed או photo_pull_failed
חלון הזמן שמאחורי spam_risk_too_many_posts: TikTok מציעה לפרסם את אותו פוסט מאפליקציית המובייל שלה במקום.
בדרך כלל easyCoexistence שולחת לבעל החשבון מייל על פוסטים שנכשלו בערוץ אחד, והפוסט ממתין תחת Needs attention
היכן TikTok מדווחת מדוע פוסט נכשל?
אחרי קריאת הפרסום, שרק מתחילה את המשימה, והקוד 0 שלה אומר ש-TikTok קיבלה אותה, ולא שהפוסט יעלה לאוויר. GET /business/publish/status/ מחזיר אז FAILED עם reason, ואפליקציה שנרשמה לוובהוק (Webhook) של פרסום מקבלת post.publish.failed עם אותה סיבה ועם publish_id. ב-/v2/post/publish/status/fetch/ של Content Posting API השדה מוחזר כשדה fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}מה כל סיבת כשל אומרת, ומה מתקן אותה?
הסיבות של TikTok, כפי שמתוארות במסמך ההפניה לאירועי פרסום הפוסטים שלה, לצד התיקון שאליו כל אחת מפנה. ארבע הראשונות הן בדיקות ש-TikTok מריצה על הקובץ אחרי ההורדה, וכולן מסומנות כלא ניתנות לניסיון חוזר. בטבלת הכשלים של TikTok עדיין מופיעות 60 שניות כאורך הסרטון המרבי ל-duration_check_failed, בעוד נקודת הקצה של הסרטונים מתעדת 600, או הערך max_video_post_duration_sec של החשבון עצמו:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
אילו כשלים אפשר לנסות שוב?
אלה שנגרמו מההורדה או מ-TikTok עצמה. השאר דורשים קובץ או כיתוב אחר, השהיה, או פשוט כלום:
- ניסיון חוזר ללא שינוי: internal, וכן
video_pull_failedאוphoto_pull_failedכשהכתובת ציבורית ומהירה מספיק. - ניסיון חוזר עם קובץ חדש:
file_format_check_failed,duration_check_failed,frame_rate_check_failedו-picture_size_check_failed. - ניסיון חוזר עם כיתוב חדש:
spam_risk_text. - להמתין, או לפרסם מאפליקציית TikTok:
spam_risk_too_many_posts. - לא לנסות שוב:
auth_removedו-spam_risk, כפי ש-TikTok ממליצה, וגםspam_risk_user_banned_from_posting.
במה כשלי Content Posting API שונים?
אותן סיבות, אבל עם שדה ונקודת קצה אחרים, וסירובים שמגיעים לפני שהעיבוד מתחיל. /v2/post/publish/status/fetch/ מחזיר fail_reason, מאפשר 30 בקשות בדקה לכל אסימון משתמש, ומוסיף הנחיה לא לנסות שוב עבור spam_risk_user_banned_from_posting ו-spam_risk_text. כמה סירובים מגיעים במקום זאת בקריאת האתחול, עם HTTP 403:
spam_risk_too_many_posts: היוצר הגיע למכסת הפוסטים היומית של ה-API.unaudited_client_can_only_post_to_private_accounts: אפליקציה שלא עברה ביקורת ניסתה לפרסם לחשבון ציבורי.url_ownership_unverified:PULL_FROM_URLמדומיין או מקידומת שהאפליקציה לא אימתה.privacy_level_option_mismatch:privacy_levelחסר או מחוץ לאפשרויות של היוצר.reached_active_user_cap: האפליקציה הגיעה למכסה היומית של משתמשים פעילים לפרסום.
מה נכשל לפני ש-TikTok רואה את הפוסט?
מה ש-easyCoexistence יכולה לתפוס ראשונה, עם הודעה משלה במקום סיבה של TikTok. המדיה של פוסט מתוזמן מועתקת בעת התזמון, וקישור שמחזיר דף אינטרנט, שגיאה 404, סוג שגוי, או קובץ מעל 30 MB לתמונה או 1 GB לסרטון נדחה כבר אז. קישורי תמונה שמסתיימים ב-.png, .gif, .bmp, .heic, .avif או .svg נדחים לפני ששום דבר נשלח, ערוץ שדורש חיבור מחדש בזמן הפרסום נכשל כ-reconnect, והסרת ערוץ מבטלת את הפוסטים המתוזמנים שלו.
איך easyCoexistence מדווחת על פוסט TikTok שנכשל?
דרך תור הפרסום שלה, שעוקב אחרי כל פוסט של TikTok אחרי קריאת הפרסום ובודק את /business/publish/status/ בערך כל 20 שניות עד PUBLISH_COMPLETE. סטטוס FAILED מכשיל את הפוסט, והשגיאה שלו מציינת את סיבת TikTok בסוגריים, כמו frame_rate_check_failed, ולכל כשל יש failure_kind:
- refused: TikTok ענתה לא, כמו בסטטוס FAILED עם הסיבה שלו.
- uncertain: לקריאת הפרסום לא הגיעה תשובה ברורה, או ש-TikTok לא אישרה תוך שעתיים, ולכן הפוסט עשוי להיות כבר באוויר (
may_be_published). - reconnect: TikTok דחתה את האסימון של החשבון, והחשבון צריך כניסה חדשה.
- internal: easyCoexistence נכשלה לפני שמסרה את הפוסט הלאה, ולכן שום דבר לא יצא.
איך מוצאים ומנסים שוב פוסט שנכשל?
בעל החשבון מקבל מייל על כשל שנמצא ברקע, לכל היותר אחד לכל ערוץ בכל 3 שעות, וכתובת האירועים של הפלטפורמה מקבלת post.failed. הפוסט מופיע תחת Needs attention במסך Posts, עם Retry, Reconnect ו-Dismiss, והכלי list_scheduled_posts מחזיר אותו ל-Claude או ל-ChatGPT. retry_scheduled_post מפרסם אותו שוב, עכשיו, מהקבצים שנשמרים 7 ימים אחרי כשל. כאשר השדה may_be_published הוא true, בודקים קודם את list_social_posts, ומעבירים את confirm רק אם הפוסט חסר. פוסט שצריך קובץ או כיתוב חדש מתוזמן מחדש במקום זאת.
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }טעויות נפוצות
- ניסיון חוזר של בדיקה כושלת עם אותו קובץ. TikTok מסמנת את כשלי הפורמט, משך הזמן, קצב הפריימים וגודל התמונה כלא ניתנים לניסיון חוזר.
- ניסיון חוזר מיידי של spam_risk_too_many_posts. TikTok סופרת פוסטים שנעשו דרך ה-API מעל 24 שעות ומציעה לפרסם מאפליקציית המובייל.
- ניסיון חוזר לפוסט שמסומן may_be_published בלי לבדוק. TikTok אולי כבר פרסמה אותו; בדקו את הפוסטים האחרונים של החשבון, אחרת הוא יוצא פעמיים.
- חיפוש fail_reason ב-API for Business. נקודת הקצה של הסטטוס שם את השדה reason, והשדה fail_reason שייך ל-Content Posting API
כשל מגיע עם הסיבה של TikTok במייל, במסך Posts וכאירוע post.failed, מוכן לניסיון חוזר. US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.
שאלות נפוצות
מה משמעות picture_size_check_failed ב-TikTok?
TikTok הורידה את הפוסט ומצאה שהתמונה נמוכה מהמינימום של 360 פיקסלים בגובה וברוחב. צריך קובץ גדול יותר, כי TikTok מסמנת את הכשל כלא ניתן לניסיון חוזר.
מה זה video_pull_failed?
TikTok לא הצליחה להוריד את הסרטון מהכתובת שלו, או שלא הצליחה תוך פסק הזמן של שעה אחת. בדקו שהכתובת ציבורית ולא מוגבלת ברוחב פס, ואז נסו שוב.
כמה זמן נמשך spam_risk_too_many_posts?
TikTok סופרת פוסטים שנעשו דרך ה-API ב-24 השעות האחרונות, כ-15 ביום לכל חשבון, ובינתיים מציעה לפרסם מאפליקציית המובייל של TikTok.
האם easyCoexistence מנסה שוב לבד פוסט של TikTok שנכשל?
לא, אחרי ש-TikTok מדווחת FAILED: הפוסט ממתין תחת Needs attention ובעל החשבון מקבל מייל, ו-Retry או retry_scheduled_post שולחים אותו שוב.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-