מדריך Threads

תזמון פוסטי טקסט ותמונה ב-Threads עם SosoAPI

תזמנו פוסט טקסט או תמונה לחשבון Threads מחובר אחד, ואז בדקו אם פורסם. הדוגמאות משתמשות במצייני מקום ואינן רצות מהעמוד הזה. חוזה הפרסום נבדק ב-20 באוקטובר 2026.

קריאה בפורמט Markdown

נבדק על ידי צוות SosoAPI · 2026-10-20

1. חברו ובדקו את היעד

חברו את חשבון Threads המיועד ב-SosoAPI. הסכמת הספק דורשת threads_content_publish לפרסום. הגורם הקורא ב-SosoAPI צריך גם סביבת עבודה מותרת, גישת editor ויכולת agent:publish לצורך תזמון.

בדקו ש-SosoAPI החזיר את חשבון Threads שבו אתם מתכוונים להשתמש. הריצו בדיקת התאמה לטיוטה מלאה עם התוכן והשעה לפני התזמון. יכולות כגון תשובות, מיקומים ושיתוף חוצה פלטפורמות דורשות הרשאות ותנאי התאמה נוספים.

בדיקת מטריצת יכולות הפלטפורמות

2. תזמנו פוסט טקסט שנבדק

השתמשו בעזר השרת מתיעוד ה-API, החליפו את מצייני המקום ובחרו זמן עתידי ב-ISO-8601 עם היסט. הרצת הבקשה יוצרת תזמון אמיתי, לכן אשרו את החשבון, הניסוח והשעה לפני השליחה.

לפוסט TEXT, השאירו media ריק. שמרו מפתח אידמפוטנטיות אחד לבקשה ושמרו את post.id שהוחזר כדי לבדוק את הסטטוס. השתמשו ב-provider_payload של Threads עם החשבון הזה.

await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<threads-account-uuid>",
  "caption": "A reviewed update from our team.",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-intent>"
});

תיעוד API הפרסום

3. השתמשו בתמונה רשומה ומוכנה

לתמונה מקומית, השתמשו ב-sosoapi_upload_asset. ל-URL ציבורי של תמונה, קראו ל-sosoapi_import_asset_url ובדקו sosoapi_get_asset_import_status עד ready. השתמשו במזהה הנכס הרשום וב-URL הקנוני שלו בפוסט.

בבקשת create הרגילה, הגדירו post_type ל-IMAGE והוסיפו את התמונה המוכנה ל-media. הקטע שלהלן מחליף את שני השדות האלה בדוגמת הטקסט. שמרו על הכיתוב, החשבון והשעה, והשתמשו במפתח יציב חדש לפוסט הזה שאושר מחדש.

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

{
  "media": [{
    "kind": "image",
    "asset_id": "<ready-image-asset-id-as-number>",
    "url": "<canonical-image-asset-url>"
  }],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {"post_type": "IMAGE"}
  }
}

4. אמתו פרסום ומנעו שליחות כפולות

קראו את Scheduled Post המקורי ובדקו את תוצאת הפרסום הסופית שלו. מזהה, תזמון שהתקבל או container מדיה של Threads מוכיחים שהבקשה קיימת; הם אינם מאשרים פרסום. הציגו את מזהה הפוסט אצל הספק או קישור קבוע כשהם זמינים.

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

לאחר ש-Threads מתחיל לפרסם פוסט טקסט, ייתכן שכבר אי אפשר לבטל את השלב אצל הספק. פעלו לפי הפעולות הזמינות ש-SosoAPI מחזיר במקום לשלוח שוב את הפוסט. זמן העיבוד עשוי להשתנות.