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

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

פרסום TikTok Story

פרסם ישירות ב-TikTok Story. לאחר הגדרת הצליל, הסקריפט לוחץ על "Your Story" — ללא שלבי כותרת/קישור מוצר/תווית AI :

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,
      "placement": "story",
      "post_way": "addButton",
      "material_list": ["C:/Videos/story_video.mp4"],
      "upload_wait_time": 30
    }
  }'

סקירה כללית

סקריפט 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_min	integer	לא	הגבול התחתון של טווח ההמתנה. כששני הגבולות מוגדרים, הסקריפט בוחר ערך אקראי בטווח עבור כל משימה
upload_wait_time_max	integer	לא	הגבול העליון של טווח ההמתנה

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

upload_wait_time ו-sound_wait_time מקבלים גם טווח: שלחו upload_wait_time_min / upload_wait_time_max (או sound_wait_time_min / sound_wait_time_max), והסקריפט יבחר ערך אקראי חדש בתוך הטווח עבור כל משימה, כך שלא כל המשימות ימתינו אותו מספר שניות. כששני הגבולות קיימים, לטווח יש עדיפות; אחרת נעשה שימוש במפתח עם ערך יחיד.

שיטות פרסום (post_way)

הפרמטר post_way שולט באופן שבו הסקריפט פותח את מסך הפרסום:

ערך	תיאור
addButton	(ברירת מחדל) לוחץ על כפתור היצירה "+" בתוך האפליקציה, ואז בוחר מדיה מגלריית המכשיר. עובד עם כל המיקומים (reel, story, post). מומלץ לרוב המקרים.
share	מפעיל Android share intent ישירות מקובץ המדיה אל אפליקציית Instagram/TikTok. זו שיטה חלופית שעוקפת ניווט בתוך האפליקציה; שימושית כאשר תהליך addButton אינו אמין במכשיר מסוים או בגרסת אפליקציה מסוימת.
useSound	מנווט תחילה לרצועת אודיו מסוימת (באמצעות כתובת URL או מילת מפתח של sound_name), ואז מצרף את הווידאו לצליל הזה. עבור Reels / TikTok בלבד. מחייב להגדיר sound_name. אינו תואם ל-placement = "post" או placement = "story".

note

כאשר placement הוא post (פוסט בפיד של Instagram), אוטומציית סאונד אינה נתמכת ללא קשר ל-post_way. הסקריפט ידלג על שלב הסאונד באופן אוטומטי.

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

פרמטר	סוג	תיאור
placement	string	מיקום הפרסום ב-TikTok: "" (וידאו רגיל, ברירת מחדל) או "story" (TikTok Story). עם "story" הסקריפט לוחץ על "Your Story" לאחר הגדרת הצליל, ומדלג על שלבי הכותרת/קישור המוצר/תווית ה-AI.
add_product_link	integer	האם להוסיף קישור מוצר/קניות: 0 = לא, 1 = כן

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

פרמטר	סוג	תיאור
placement	string	מיקום הפרסום: reel (Reels), story (סטוריז) או post (פוסט רגיל בפיד). הערה: אפשרויות קול אינן נתמכות כאשר placement הוא post
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
    }
  }'

פוסט בפיד של Instagram (placement: post)

פרסום לפיד הרגיל של Instagram (לא Reel). אפשרויות קול אינן נתמכות במיקום זה:

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": "New post! #instagram",
      "placement": "post",
      "post_way": "addButton",
      "material_list": ["C:/Videos/my_video.mp4"],
      "upload_wait_time": 45
    }
  }'

ראה גם

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