סטוריז של עמוד Facebook דרך ה-API
ה-Stories API של Meta מפרסם סטוריז של תמונה וסרטון לעמוד Facebook. סטורי של תמונה נבנה מתמונה שהועלתה עם published שערכו false, ואז קריאת POST אל /{page-id}/photo_stories עם photo_id של התמונה מפרסמת אותו. סטורי של סרטון עובר דרך קריאות start, upload ו-finish על /{page-id}/video_stories, כשהאחרונה מפרסמת אותו. סרטוני סטוריז יכולים להגיע עד 60 שניות, ותמונות עד 10 MB בגודלן.
easyCoexistence מפרסם פוסטים של עמוד ב-Facebook בעזרת publish_facebook_post מ-Claude, מ-ChatGPT או מהקוד שלכם: טקסט, קישורים, תמונות וסרטונים.
האורך המרבי לסרטון סטורי בעמוד Facebook, כפי ש-Meta מתירה.
הגודל המרבי לקובץ תמונה לסטורי, בפורמטים JPEG, BMP, PNG, GIF או TIFF בלבד.
יחס גובה-רוחב של סטורי סרטון, עם רזולוציה מומלצת של 1080 x 1920 פיקסלים ומינימום 540 x 960 פיקסלים.
סטטוסים שמחזירה GET /{page-id}/stories; סטוריז בארכיון מופיעים רק כשארכיון הסטוריז של העמוד פעיל.
איך מפרסמים סטורי של תמונה?
בשתי קריאות. מעלים את התמונה אל POST /{page-id}/photos עם published שערכו false. הקריאה מחזירה את מזהה התמונה, ואז שולחים POST /{page-id}/photo_stories עם photo_id שהוא המזהה הזה. Meta עונה עם success שערכו true ועם post_id, מזהה הפוסט של הסטורי.
POST /{page-id}/photo_stories
{
"photo_id": "<PHOTO_ID>"
}
200 OK
{
"success": true,
"post_id": "<STORY_POST_ID>"
}איך מפרסמים סטורי של סרטון?
בשלושה שלבים, באותו מבנה של Reel. קריאת POST אל /{page-id}/video_stories עם upload_phase שערכו start מחזירה video_id וגם upload_url, שמצביע אל rupload.facebook.com הייעודי. הסרטון נשלח לשם, כבייטים של הקובץ עם כותרות offset וגם file_size, או בכותרת file_url לקובץ מאוחסן. אחר כך קריאת POST אל /{page-id}/video_stories עם video_id וגם upload_phase שערכו finish מפרסמת את הסטורי ומחזירה את post_id שלו.
איזו מדיה אפשר להשתמש בה לסטורי?
ההנחיות של Meta לסטוריז מגדירות מפרט לתמונה ומפרט לסרטון. תמונות הן קבצים מסוג .jpeg, .bmp, .png, .gif או .tiff עד 10 MB, וכדאי לשמור קובצי PNG מתחת ל-1 MB. סרטונים עוקבים אחרי מפרט ה-Reels, עם תקרה קצרה יותר:
- קובץ: .mp4 מומלץ, ביחס גובה-רוחב של 9 x 16 לפי התקן.
- רזולוציה: מומלץ 1080 x 1920 פיקסלים, ולכל הפחות 540 x 960 פיקסלים.
- קצב פריימים: 24 עד 60 פריימים בשנייה, קבוע, עם סריקה פרוגרסיבית.
- אורך: 60 שניות לכל היותר לסטורי סרטון.
- קודקים: H.264 או H.265, עם VP9 וגם AV1 נתמכים; אודיו ב-AAC Low Complexity, 48 kHz, סטריאו, 128 kbps ומעלה.
איזו מדיה אי אפשר להשתמש בה לסטורי?
אסור להשתמש בתמונה או בסרטון שכבר שימשו בפוסט שפורסם קודם. לפי הכלל של Meta, מדיה שמועלית לסטורי לא יכולה כבר לשמש בפוסט אחר. סרטון מאוחסן חייב גם להיות נגיש, כי Meta דוחה קבצים מאתרים שקובץ ה-robots.txt שלהם חוסם את סוכן המשתמש facebookexternalhit/1.1, וכן קבצים מה-CDN של Meta עצמה, כמו כתובות fbcdn הנפוצות.
איך מציגים את הסטוריז של עמוד?
GET /{page-id}/stories מחזירה אובייקט אחד לכל סטורי, וניתן לסנן את הרשימה לפי סטטוס או תאריך, עם since וגם until. כל אובייקט מכיל:
post_id: מזהה הפוסט של הסטורי.- status: PUBLISHED או ARCHIVED; סטוריז בארכיון דורשים שארכיון הסטוריז של העמוד יהיה פעיל.
creation_time: חותמת הזמן בפורמט UNIX של הרגע שבו הסטורי פורסם.media_typeוגםmedia_id: תמונה או סרטון, ומזהה אותה מדיה.- url: כתובת הסטורי ב-Facebook, תחת הנתיב facebook.com/stories/ שבו הוא נמצא.
אילו הרשאות נדרשות?
אסימון גישה (Access Token) של העמוד, שנוצר על ידי אדם שיכול לבצע את המשימה CREATE_CONTENT על העמוד, דרך Facebook Login או Facebook Login for Business, כשההרשאות pages_manage_posts, pages_read_engagement וגם pages_show_list מאושרות. בקשות שנעשות בשם משתמש מערכת עסקי דורשות גם את business_management, הרשאה נוספת. אלה שלוש ההרשאות שגם פרסום לפיד העמוד דורש.
מתי סטורי עולה?
הסטורי עולה ברגע שנשלחת הקריאה הרלוונטית: photo_stories לתמונה, או finish של video_stories לסרטון. ל-Stories API של Meta אין זמן פרסום: photo_stories מקבל photo_id, וקריאת finish מקבלת video_id, upload_phase ודגל is_ai_generated שאופציונלי. סטורי לשעה מאוחרת יותר דורש קריאה שתישלח באותו רגע, ממתזמן משלכם.
איך מפרסמים סטורי דרך easyCoexistence?
עדיין לא ניתן. publish_facebook_post מפרסם פוסטים ולא סטוריז, ול-easyCoexistence אין כלי עבור photo_stories או video_stories; אסימוני עמוד אינם נמסרים, ולכן אי אפשר להריץ את הקריאות גם מהקוד שלכם על החיבור שלו. את הסטוריז מפרסמים מ-Facebook או מ-Meta Business Suite.
טעויות נפוצות
- שימוש חוזר בתמונה מפוסט קודם. מדיה לסטורי לא יכולה להגיע מפוסט שפורסם קודם, ולכן מעלים אותה שוב, כשהשדה published שערכו false, כלומר לא מפורסמת.
- הפיכת Reel בן 90 שניות לסטורי. Reels יכולים להגיע ל-90 שניות, אבל סרטון סטורי מוגבל ל-60 שניות.
- ציפייה לסטוריז בארכיון ברשימה. הם מופיעים בתשובה של GET /{page-id}/stories רק כשארכיון הסטוריז של העמוד פעיל.
- שליחת הסרטון אל graph.facebook.com. ההעלאה צריכה להגיע אל upload_url, שמצביע אל rupload.facebook.com; הקריאות start, finish וגם status נשארות אצל graph.facebook.com, השרת הרגיל.
אין לו כלי ל-Stories API, ולכן סטוריז מפרסמים מ-Facebook או מ-Meta Business Suite. US$ 9 עד US$ 0.75 לחיבור בחודש, כשהמחיר יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
אפשר לשתף Reel כסטורי של עמוד Facebook?
כן, אם הוא נמשך 60 שניות או פחות: לפי המפרט של Meta, Reel שמפורסם כסטורי בעמוד לא יכול לחרוג מהאורך הזה.
אפשר לסמן סטורי סרטון כמיוצר בבינה מלאכותית?
כן. בקריאת finish של video_stories מגדירים את is_ai_generated שערכו true; ברירת המחדל היא false, כלומר לא מסומן.
מה קורה אם העלאת הסרטון לסטורי נקטעת?
שולחים שוב את ההעלאה עם offset שערכו 0 כדי להתחיל מחדש, או עם offset לפי ערך bytes_transfered מבדיקת הסטטוס, כדי להמשיך מאותה נקודה.
כמה עולה easyCoexistence לעמוד Facebook?
US$ 9 עד US$ 0.75 לחיבור בחודש, עם 3 הימים הראשונים בחינם. כל עמוד הוא חיבור אחד, והמחיר לכל חיבור יורד ככל שמוסיפים עוד חיבורים.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-