תצורת סקריפט פרסום

עמוד זה מתעד את פרמטרי התצורה עבור סקריפט post המשמש ליצירת משימות.

סקירה כללית

סקריפט post משמש לפרסום תוכן אוטומטי (סרטונים או תמונות) ל-TikTok או Instagram. הוא תומך במספר שיטות פרסום, מקורות חומר ואפשרויות אודיו.

פרמטרי בקשה

בעת יצירת משימה, ניתן לציין את הפרמטרים הבאים ברמה העליונה:

פרמטר	סוג	נדרש	ברירת מחדל	תיאור
serials	string[]	מותנה	[]	רשימת מספרי סידור של מכשירים (מצב 1: מבוסס מכשיר)
usernames	string[]	מותנה	[]	רשימת שמות משתמש ליצירת משימות עבורם (מצב 2: מבוסס שם משתמש)
script_name	string	כן	-	שם הסקריפט להפעלה (למשל, "post")
script_config	object	כן	-	פרמטרי תצורת הסקריפט (ראה להלן)
enable_multi_account	boolean	לא	false	הפעל מצב חשבונות מרובים (צור משימה לכל חשבון במכשיר)
start_time	string	לא	-	זמן התחלה אופציונלי בפורמט "HH:MM"
platform	string	מותנה*	auto	פלטפורמת היעד: `tiktok`, `instagram`. ראה הערה למטה

הערה: יש לספק serials או usernames.

*התנהגות פרמטר Platform:

TikMatrix ו-IgMatrix: פרמטר platform מתעלם אם מסופק. הפלטפורמה נקבעת אוטומטית משם האפליקציה (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: פרמטר platform נדרש ויש לציין אותו במפורש כ-tiktok או instagram.

פרמטרים כלליים

פרמטר	סוג	נדרש	תיאור
content_type	integer	לא	0=וידאו, 1=תמונה
captions	string	לא	כיתוב הפוסט
material_list	string[]	לא	רשימת נתיבי קבצים
post_way	string	לא	שיטת פרסום
caption_format	string	לא	כיצד לטפל בכיתובים מרובי שורות: `multiline` (הכנסת שורות חדשות אמיתיות) או `singleline` (החלפת `\n` ברווחים)
ai_label	boolean	לא	האם להוסיף תווית תוכן שנוצר על ידי AI לפוסט
save_draft	boolean	לא	שמור את הפוסט כטיוטה במקום לפרסם מיד
upload_wait_time	integer	לא	זמן המתנה להעלאה (שניות)

upload_wait_time חל גם על פרסום רגיל וגם על מצב save_draft. גם בשמירה כטיוטה, TikTok/Instagram עדיין צריך זמן כדי להשלים את העלאת הווידאו ברקע.

פרמטרים ספציפיים ל-TikTok

פרמטר	סוג	תיאור
add_product_link	integer	האם להוסיף קישור מוצר/קניות: `0` = לא, `1` = כן

פרמטרים ספציפיים ל-Instagram

פרמטר	סוג	תיאור
placement	string	reel או story
enable_schedule_reels	boolean	האם לתזמן את ה-Reel לזמן עתידי
schedule_reels_time	string	זמן פרסום מתוזמן בפורמט `YYYY-MM-DD HH:MM` (נדרש כאשר enable_schedule_reels = true)
story_link	string	כתובת URL לצירוף כקישור מדבקה ב-Story (חל רק כאשר placement = "story")

דוגמאות

פרסום בסיסי

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "סרטון חדש!",
      "material_list": ["C:/Videos/video1.mp4"]
    }
  }'

פרסום עם בחירת פלטפורמה מפורשת

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

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "מפרסם ב-Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

ראה גם

API ניהול משימות

סקירה כללית​

פרמטרי בקשה​

פרמטרים כלליים​

פרמטרים ספציפיים ל-TikTok​

פרמטרים ספציפיים ל-Instagram​

דוגמאות​

פרסום בסיסי​

פרסום עם בחירת פלטפורמה מפורשת​

ראה גם​