把社交發佈加入產品。

操作步驟

1. 01

   先設計 API 呼叫前的用戶確認

   在 SosoAPI 前往此頁

   • 在 SosoAPI app 選擇目標工作區並檢查已連接帳戶。在產品原型中亦要顯示用戶所選的工作區及帳戶，不可暗中代選。

   • 確認畫面須列出確切文案、帳戶、本地時間及時區。必須由用戶選擇 Schedule 才提交；打開表單不可自動送出。

   預期結果

   用戶能在寫入前查看目的地及時間。虛構產品原型只是設計練習，不代表已有客戶整合。

2. 02

   由伺服器讀取目前已排程帖文

   • 把 <workspace-uuid> 換成所選工作區 ID，再於伺服器執行以下唯讀請求：

   • 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

   只有用戶明確確認後才提交

   • 打開 Calendar 並選 New Post，對照 App 中同一操作的審閱步驟。

   • 先替換所有佔位符，填入已授權 ID、附時區偏移的未來 ISO 時間及唯一 idempotency key。執行以下伺服器請求前，先審閱帳戶、文案及時間。

   • 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": "留一句給稍後的自己：Harborlight Journal 正為每日短短的反思騰出空間。記下一個想法，其他留待明天。",
       "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 key 暴露於瀏覽器。

   預期結果

   有效的接納回應會識別新建的 Scheduled Post，但不代表平台已發佈。能力遭拒、範圍／帳戶無效、不支援的負載或排程被拒，都應顯示為錯誤，不可報稱成功。

4. 04

   呈現回傳狀態，並提供安全跟進方法

   在 SosoAPI 前往此頁

   • 儲存回傳的 Scheduled Post ID，並在產品顯示目前狀態、目的地及排程時間。

   • 連結至相應 Scheduled Post 詳情。如發佈需要人手處理，連結至 Needs Attention 項目，而不是靜默重交。

   • 只有記錄到平台最終確認狀態後，才可把請求標示為已發佈。

   預期結果

   產品須分清請求收據、已排程、發佈中、已發佈、失敗及未知。結果未知時，先核對原有帖文狀態，再考慮新寫入。