סוכן שמפיץ וידאו קצר: רילס, שורטס ועמודי פייסבוק מקובץ אחד

סוכן יכול להפיץ סרטון קצר אחד לעשרות עמודי פייסבוק, חשבונות אינסטגרם וערוצי יוטיוב בתוך שיחה אחת, אם הוא עושה שלושה דברים נכון: מעלה את הקובץ עם המידות והאורך שלו, בוחר פורמט לכל רשת, וכותב כיתוב אחר לכל חשבון. בְּשַׁגֵּר זה רצף קצר של קריאות כלי, שהעיקריות בהן הן upload_media_from_url, create_post ואחר כך get_post לבדיקה.

המדריך הזה מיועד למי שכבר חיבר סוכן לְשַׁגֵּר (אם עוד לא, עמוד הסוכנים מסביר איך) ורוצה להפסיק להעלות את אותו סרטון שלושים פעם ביד.

מה הסוכן צריך לדעת על הקובץ לפני שהוא מעלה אותו?

הטעות הנפוצה היא להעלות סרטון ולגלות רק בזמן הפרסום שהוא לא מתאים לפורמט. שַׁגֵּר בודק כל פוסט מול הכללים של כל רשת לפני השליחה, אבל כדי שהבדיקה של רילס, שורטס וסטוריז תהיה מדויקת, הסוכן צריך למסור את המידות ואת האורך כבר בהעלאה.

הכלי upload_media_from_url מקבל url ציבורי של הקובץ, file_name, ובנוסף width, height וduration_ms. אם הסרטון נוצר בכלי עריכה שמחזיר את הנתונים האלה, כדאי שהסוכן יעביר אותם כמו שהם. אם לא, עדיף שיריץ ffprobe על הקובץ מאשר שינחש.

upload_media_from_url {
  "workspace_id": "ws_client_rehovot",
  "url": "https://cdn.example.co.il/videos/open-house-oct.mp4",
  "file_name": "open-house-oct.mp4",
  "width": 1080,
  "height": 1920,
  "duration_ms": 42000
}

התשובה מחזירה מזהה מדיה. הסוכן שומר אותו ומשתמש בו בmedia_ids של הפוסט.

כמה עובדות שכדאי שהסוכן יכיר. יוטיוב מסווג סרטון כשורט כשהוא ריבועי או אנכי ואורכו עד שלוש דקות, וסרטון רחב יותר נחשב סרטון רגיל, לפי מרכז העזרה של יוטיוב. באינסטגרם, פרסום דרך API עובר דרך ממשק פרסום התוכן הרשמי של Meta, ושם מתועדות דרישות הווידאו העדכניות. אל תכניסו לפרומפט מספרים מהזיכרון; תנו לבדיקה של שַׁגֵּר להחזיר שגיאה ברורה אם משהו לא עומד בדרישות.

איך בוחרים פורמט לכל רשת?

השדה format בcreate_post מקבל את הערכים FEED, REEL, STORY, SHORT וVIDEO. בלי השדה הזה שַׁגֵּר בוחר ברירת מחדל לכל רשת. כשרוצים שליטה, יש שתי דרכים: פורמט אחד לכל הפוסט, או פורמט לכל חשבון בתוך per_channel.

רשת	פורמט מתאים לסרטון אנכי קצר	שדות נוספים שכדאי למלא
עמוד פייסבוק	REEL	כיתוב, תגובה ראשונה עם קישור
אינסטגרם מקצועי	REEL או STORY	כיתוב שונה לכל חשבון
ערוץ יוטיוב	SHORT	youtube_title, youtube_privacy

ביוטיוב יש שני שדות ייעודיים. youtube_title הוא כותרת הסרטון, ואם לא מעבירים אותו שַׁגֵּר לוקח את השורה הראשונה של הכיתוב. youtube_privacy מקבל public, unlisted או private. לסוכן חדש אני ממליץ להתחיל בunlisted בערוץ אחד, לבדוק את התוצאה, ורק אז לעבור לpublic. שימו לב שתגובה ראשונה ביוטיוב יוצאת רק בסרטונים ציבוריים.

רצף הקריאות המלא

זה הרצף שאני נותן לסוכן כשהוא מפיץ סרטון קצר ללקוח עם שלוש רשתות:

1. whoami כדי לוודא שהמפתח לא בסנדבוקס ושיש לו הרשאת publish.
2. list_workspaces ובחירת סביבת העבודה של הלקוח.
3. list_channels כדי לקבל את מזהי החשבונות, הרשת של כל אחד והפורמטים שהוא תומך בהם.
4. upload_media_from_url עם מידות ואורך.
5. create_post בלי schedule_at, כטיוטה, עם per_channel.
6. אם סביבת העבודה דורשת אישור לקוח, request_approval. אחרת schedule_post.
7. אחרי מועד הפרסום, get_post כדי לראות מצב, קישור חי או שגיאה לכל חשבון.

הקריאה החשובה היא החמישית. ככה היא נראית עם שני עמודי פייסבוק, חשבון אינסטגרם וערוץ יוטיוב:

create_post {
  "workspace_id": "ws_client_rehovot",
  "label": "בית פתוח אוקטובר, וידאו",
  "campaign": "open-house-oct",
  "caption": "בית פתוח ביום שישי בבוקר. סיור בדירות לדוגמה ושיחה עם צוות המכירות.",
  "media_ids": ["med_7c1a"],
  "format": "REEL",
  "cta_url": "https://example.co.il/open-house",
  "youtube_title": "בית פתוח ברחובות: סיור של 40 שניות",
  "youtube_privacy": "public",
  "stagger_seconds": [45, 120],
  "per_channel": [
    { "channel_id": "ch_fb_rehovot", "caption": "רחובות, ביום שישי אנחנו פותחים את הדלתות. בואו לראות את הדירות לדוגמה מקרוב.", "first_comment": "פרטים והרשמה: https://example.co.il/open-house" },
    { "channel_id": "ch_fb_nesziona", "caption": "גרים בנס ציונה? הפרויקט עשר דקות נסיעה מכם, ובשישי יש בית פתוח.", "first_comment": "לשריון מקום: https://example.co.il/open-house" },
    { "channel_id": "ch_ig_brand", "caption": "40 שניות בתוך הדירה לדוגמה. בית פתוח בשישי, הקישור בביו." },
    { "channel_id": "ch_yt_brand", "format": "SHORT", "caption": "סיור קצר בדירה לדוגמה לפני הבית הפתוח.\nפרטים: https://example.co.il/open-house" }
  ]
}

כל כתובת שמופיעה בכיתוב או בתגובה הראשונה מוחלפת בזמן הפרסום בקישור מקוצר של שַׁגֵּר שייחודי לאותו חשבון, עם תגיות UTM שבהן utm_content מזהה את החשבון. כך, כשהלקוח שואל איזה עמוד הביא נרשמים לבית הפתוח, יש תשובה. על המבנה הזה בהרחבה כתבתי במדריך לקישור בתגובה הראשונה עם סוכנים.

למה כיתוב אחר לכל חשבון ולא העתקה?

כי אותו טקסט מילה במילה בשלושים עמודים נראה לרשתות ולגולשים כמו הפצה המונית, ובצדק. השדה per_channel קיים בדיוק בשביל זה, וְשַׁגֵּר ממליץ להשתמש בו. מודל שפה טוב יודע לכתוב עשרים וריאציות שנשמעות כמו אותו מותג אבל פונות לקהל של כל סניף. הפרומפטים שאני משתמש בהם לזה נמצאים במאמר על גיוון כיתובים לכל חשבון.

פריסה מדורגת: מה stagger_seconds עושה בפועל

שַׁגֵּר לא שולח את הסרטון לכל החשבונות באותה שנייה. בין חשבון לחשבון באותה רשת יש הפסקה אקראית בטווח stagger_seconds, וברירת המחדל היא [30, 90]. בסרטונים כדאי לשקול טווח רחב יותר, כי העלאת וידאו לוקחת זמן בצד הרשת. החשבון פשוט: עם ממוצע של דקה וחצי בין חשבונות, עשרים עמודי פייסבוק יתפרסו על פני חצי שעה בערך. אם זה חשוב ללקוח שהכל יעלה לפני תשע בבוקר, הסוכן צריך לתזמן בהתאם.

איך הסוכן בודק שהכל עלה?

get_post מחזיר את מצב הפוסט ואת המצב של כל חשבון: מתי פורסם, הקישור החי, או הודעת שגיאה. הסוכן צריך לקרוא את זה ולא רק לדווח "תוזמן". הוראה שאני מוסיף לכל סוכן:

אחרי מועד הפרסום, הרץ get_post. אם יש חשבון במצב שגיאה, אל תנסה לפרסם מחדש בעצמך.
דווח לי את שם החשבון, את הודעת השגיאה כלשונה, והצע תיקון.

אם חשבון דורש חיבור מחדש, למשל כי ההרשאה בפייסבוק פגה, הפתרון הוא קישור חיבור ללקוח דרך create_connect_link ולא ניסיון חוזר.

דוגמת REST למי שמריץ את זה מקוד

אותן פעולות זמינות גם בממשק REST, לפי מפרט OpenAPI. העלאת הסרטון:

curl -X POST "https://app.shager.ai/api/v1/workspaces/ws_client_rehovot/media" \
  -H "Authorization: Bearer $SHAGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://cdn.example.co.il/videos/open-house-oct.mp4","file_name":"open-house-oct.mp4","width":1080,"height":1920,"duration_ms":42000}'

והפוסט עצמו נשלח לPOST /workspaces/{workspace_id}/posts עם אותו גוף JSON שמופיע למעלה.

פרומפט מלא להפצת סרטון

יש לך גישה לשגר דרך MCP. סביבת העבודה: "רחובות פרויקט צפוני".
הסרטון: https://cdn.example.co.il/videos/open-house-oct.mp4 (אנכי, 1080x1920, 42 שניות).
1. העלה את הסרטון עם המידות והאורך.
2. צור טיוטה אחת לכל החשבונות בקבוצה "סניפים מרכז" ולערוץ היוטיוב.
3. פייסבוק ואינסטגרם כרילס, יוטיוב כשורט עם כותרת עד 60 תווים.
4. כתוב כיתוב שונה לכל חשבון, שמזכיר את העיר של הסניף. בלי סימני קריאה כפולים.
5. בפייסבוק שים את הקישור https://example.co.il/open-house בתגובה הראשונה.
6. אל תתזמן. הראה לי טבלה של חשבון, פורמט וכיתוב, וחכה לאישור.

השלב האחרון הוא העיקר. סוכן שמראה טבלה לפני שהוא מתזמן חוסך לכם את רוב הטעויות.

אם אתם עדיין בלי מפתח, הסוכן יכול לפתוח סנדבוקס בעצמו לפי המתכון שבקובץ auth.md, להעלות את הסרטון וליצור טיוטות, ואתם תאשרו את הפרסום כשתהיו מוכנים. משם הצעד הטבעי הוא אסטרטגיית התזמון שתקבע מתי הסרטונים האלה יוצאים.

שאלות נפוצות

האם הסוכן יכול לפרסם את אותו סרטון גם כרילס וגם כסטורי באינסטגרם?

כן, אבל כשני פוסטים נפרדים או כשתי שורות בper_channel לחשבונות שונים. לחשבון אחד יש פורמט אחד בכל פוסט. אם רוצים את שניהם באותו חשבון, הסוכן יוצר פוסט נוסף עם format של STORY.

מה קורה אם הסרטון ארוך מדי לשורטס?

שַׁגֵּר בודק את הפוסט מול כללי הרשת ומחזיר שגיאה עם הסבר לפני השליחה, ולכן חשוב להעביר duration_ms בהעלאה. הסוכן צריך לדווח על השגיאה ולהציע לפרסם ביוטיוב כסרטון רגיל עם format של VIDEO, או לקצר את הקובץ.

אפשר להפיץ לטיקטוק או ללינקדאין?

עוד לא. טיקטוק ולינקדאין בפיתוח בְּשַׁגֵּר. היום הפרסום זמין לעמודי פייסבוק, לחשבונות אינסטגרם מקצועיים ולערוצי יוטיוב.