הוסיפו פרסום למוצר שלכם.

מדריך מעשי

1. 01

   תכננו אישור במוצר לפני קריאת ה-API

   פתיחת האזור הזה ב-SosoAPI

   • באפליקציית SosoAPI, בחרו את סביבת העבודה המיועדת ובדקו את החשבון המחובר. בהדמיית המוצר הציגו את אותה סביבה ואותו חשבון שהמשתמש בחר, במקום לבחור אותם בשקט.

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

   למה לצפות

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

2. 02

   קראו את Scheduled Posts הנוכחיים מהשרת שלכם

   • החליפו <workspace-uuid> במזהה סביבת העבודה שבחרתם, ואז הריצו את הבקשה הזו לקריאה בלבד בשרת:

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/list",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({"workspace_id":"<workspace-uuid>"})
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • השתמשו בנתונים שהוחזרו לרענון הרשימה במוצר. השאירו את אישור המשתמש בנפרד מהקריאה הזו.

   למה לצפות

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

3. 03

   שלחו רק לאחר אישור משתמש מפורש

   • פתחו את לוח השנה ובחרו ״פוסט חדש״ כדי להשוות את שלב הבדיקה לאותה פעולה באפליקציה.

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

   • const apiKey = process.env.SOSOAPI_API_KEY;
     if (!apiKey) throw new Error("Configure a SosoAPI API key on your server");
     const response = await fetch(
       "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/studio-api/scheduled-posts/create",
       {
         method: "POST",
         headers: {
           "Authorization": "Bearer " + apiKey,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
       "workspace_id": "<workspace-uuid>",
       "social_account_id": "<threads-social-account-uuid>",
       "caption": "A small note for later: Harborlight Journal is making room for shorter daily reflections. Keep one thought; leave the rest for tomorrow.",
       "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": "<unique-stable-key-for-this-intent>"
     })
       }
     );
     const result = await response.json();
     if (!response.ok) throw new Error("SosoAPI request failed: " + response.status);
     // Use result in your server response; never return or log the API key.

   • הרצת הבקשה יוצרת תזמון אמיתי. שלחו רק לאחר אישור המשתמש, ולעולם אין לחשוף את מפתח ה-API לדפדפן.

   למה לצפות

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

4. 04

   הציגו את המצב שהוחזר ותנו למשתמש המשך בטוח

   פתיחת האזור הזה ב-SosoAPI

   • שמרו את מזהה Scheduled Post שהוחזר והציגו במוצר את המצב הנוכחי, היעד והתזמון שלו.

   • קשרו את המשתמש לפרטי Scheduled Post המתאים. אם המסירה דורשת אדם, קשרו לפריט Needs Attention במקום לשלוח מחדש בשקט.

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

   למה לצפות

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