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

_2026-09-02 · מדריך מעשי לסוכן AI שמפיץ סרטון קצר דרך שַׁגֵּר: העלאה עם מידות ואורך, בחירת פורמט לכל רשת, כותרת ליוטיוב, כיתוב שונה לכל חשבון ופריסה מדורגת בין העמודים._

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

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

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

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

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

```json
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` של הפוסט.

כמה עובדות שכדאי שהסוכן יכיר. יוטיוב מסווג סרטון כשורט כשהוא ריבועי או אנכי ואורכו עד שלוש דקות, וסרטון רחב יותר נחשב סרטון רגיל, לפי [מרכז העזרה של יוטיוב](https://support.google.com/youtube/answer/15424877). באינסטגרם, פרסום דרך API עובר דרך [ממשק פרסום התוכן הרשמי של Meta](https://developers.facebook.com/docs/instagram-platform/content-publishing/), ושם מתועדות דרישות הווידאו העדכניות. אל תכניסו לפרומפט מספרים מהזיכרון; תנו לבדיקה של שַׁגֵּר להחזיר שגיאה ברורה אם משהו לא עומד בדרישות.

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

השדה `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` כדי לראות מצב, קישור חי או שגיאה לכל חשבון.

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

```json
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` מזהה את החשבון. כך, כשהלקוח שואל איזה עמוד הביא נרשמים לבית הפתוח, יש תשובה. על המבנה הזה בהרחבה כתבתי ב[מדריך לקישור בתגובה הראשונה עם סוכנים](/blog/first-comment-lead-links-with-agents).

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

כי אותו טקסט מילה במילה בשלושים עמודים נראה לרשתות ולגולשים כמו הפצה המונית, ובצדק. השדה `per_channel` קיים בדיוק בשביל זה, וְשַׁגֵּר ממליץ להשתמש בו. מודל שפה טוב יודע לכתוב עשרים וריאציות שנשמעות כמו אותו מותג אבל פונות לקהל של כל סניף. הפרומפטים שאני משתמש בהם לזה נמצאים ב[מאמר על גיוון כיתובים לכל חשבון](/blog/caption-variation-per-account-with-ai).

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

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

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

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

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

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

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

אותן פעולות זמינות גם בממשק REST, לפי [מפרט OpenAPI](https://app.shager.ai/api/v1/openapi.json). העלאת הסרטון:

```bash
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 שמופיע למעלה.

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

```text
יש לך גישה לשגר דרך 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](/auth.md), להעלות את הסרטון וליצור טיוטות, ואתם תאשרו את הפרסום כשתהיו מוכנים. משם הצעד הטבעי הוא [אסטרטגיית התזמון](/blog/scheduling-strategy-for-agents) שתקבע מתי הסרטונים האלה יוצאים.

## שאלות נפוצות

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

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

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

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

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

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

---
Source: https://shager.ai/blog/agent-short-video-distribution