佇列與發佈狀態

ANKK APP 透過非同步背景佇列處理所有發佈任務，以確保彈性的多頻道營運。發佈請求被接受的時刻與貼文在外部社群網路上線的時刻是不同的。

預定貼文

☷ 清單

ANKK launch update@ankk_demo · Instagram預定於: 2026-09-01 · 09:00

編輯取消日程

ANKK APP UI preview · 預定貼文 · zh-Hant

📑 營運畫面

在單一頻道或所有頻道檢視中，選擇符合目前工作的畫面。

畫面	可檢視與管理的內容
預定貼文	未來要發佈的內容；可在清單、週或月檢視中編輯、重新排程或取消
需要採取行動	失敗、重新授權、權限或供應商結果等需要判斷的項目
已發表	由 ANKK APP 發佈或從 SNS 同步的內容，包含原始貼文連結與已收集指標
收件匣	各頻道的留言與回覆，以及回覆送達狀態
分析	整個品牌或單一頻道的期間指標與熱門貼文

預定貼文的檢視方式

預定畫面會以清單、週曆和月曆顯示相同內容。檢視方式不是內容狀態；可從任何檢視編輯、重新排程或取消預定內容。

🔄 內容生命週期（狀態圖）

stateDiagram-v2
    [*] --> scheduled : Scheduled publish (scheduled_for set)
    [*] --> pending : Immediate publish (queued immediately)
    scheduled --> pending : Target time reached
    scheduled --> deleted : Cancelled (soft-deleted)
    pending --> publishing : Worker processes job
    publishing --> published : SNS publish succeeded
    publishing --> failed : SNS publish failed (temporary API error)
    failed --> pending : Retry executed
    published --> unavailable : Source post deleted on SNS

📊 核心內容狀態

狀態	意義	描述
`scheduled`	已排程	等待未來的發佈時間戳。可以編輯或取消。
`publishing`	處理中	ANKK worker 正在積極上傳媒體並與 SNS API 通訊。
`published`	已發佈	已成功在 SNS 上線。移至已發佈內容。
`failed`	失敗	由於暫時性平台錯誤而失敗。可透過失敗與重試進行重試。
`deleted`	已刪除	排程貼文被使用者取消或移除。
`unavailable`	無法使用	原始貼文在提供者平台上被刪除或權限被撤銷。

⚠️ 了解已接受 (HTTP 202) 與正式上線成功的區別

收到 HTTP 202 Accepted 回應或在 UI 中提交貼文確認了：

✅ 身分驗證和 API 金鑰驗證通過
✅ 方案配額和排程時段限制已檢查
✅ 有效載荷驗證（文字長度、媒體格式）成功
✅ 背景任務已放入佇列

最終的傳送確認必須透過佇列狀態更新或 Webhook 事件 (sns.publish.succeeded) 進行驗證。