如何為你的 SaaS 加入 TikTok 發布功能
SaaS 可以這樣加入 TikTok 發布功能:透過託管連結連接每位客戶的 TikTok 帳戶,再呼叫 easyCoexistence 的 POST /channels/{id}/posts,附上一段影片或 1 至 35 張圖片及說明文字,可以立即發布,也可以在 publish_at 指定的時間發布,最遲可提前 90 天排程。貼文會透過 TikTok 的 API for Business 發出,每個帳戶每天最多 15 則貼文,你的後端會在貼文上線時收到通知。
TikTok 透過其 API for Business 為每個帳戶發布的影片貼文,速度不超過每分鐘 6 則。
TikTok 發布端點所接受的最大影片,格式為 MP4、MOV 或 WebM,長度為 3 至 600 秒。
一則 TikTok 圖片貼文最多可容納的圖片數目;每張須為 JPG、JPEG 或 WebP,最大 20 MB。
TikTok 圖片貼文標題可容納的 UTF-16 代碼單位數目。
easyCoexistence 的貼文端點可為 TikTok 貼文排程的最遠時間。
客戶如何連接 TikTok?
透過將 channel 設為 tiktok 的連接工作階段。託管頁面會顯示你的名稱及「Continue with TikTok」按鈕,點擊後會在同一個分頁開啟 TikTok 自己的同意畫面;客戶登入並授權後,會被導向你的 redirect_url,並附上 channel_id。請將它與客戶一同儲存,因為每次貼文呼叫都會指定該頻道。
TikTok 貼文的請求是什麼樣子?
向 /channels/{id}/posts 發送一次 POST,文字放在 text,檔案放在 media。若要立即發布,請省略 publish_at;若要稍後發布,請設定帶有時區偏移量的 ISO 8601 時間。立即發布的貼文會回傳 201;若失敗,則回傳 422 及 TikTok 的原因。
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: tt_video_5530" \
-d '{
"text": "Behind the scenes of our new store #opening",
"media": [{ "url": "https://cdn.example.com/store-tour.mp4", "type": "video" }],
"disable_comment": false,
"publish_at": "2026-11-10T18:00:00-05:00"
}'影片貼文與圖片貼文各需要什麼?
一則 TikTok 貼文只能是一段影片或一組圖片,兩者不可同時存在,且不含連結。文字(此處最多 2,200 個字元)會同時作為兩者的說明文字。貼文加入佇列前,會先檢查 TikTok 自己的檔案規則:
| Video post | Photo post | |
|---|---|---|
| Media | One video, MP4, MOV or WebM | 1 to 35 images, JPEG or WebP |
| Size | Up to 1 GB, 3 to 600 seconds, at least 360 px | Up to 20 MB per image |
| Title | None; the caption only | title, up to 90 characters |
| Comments | disable_comment turns them off | disable_comment turns them off |
媒體必須放在哪裡?
可放在任何 HTTPS 位址,或 easyCoexistence 的儲存空間。TikTok 只會從已為應用程式驗證的 URL 前綴下載檔案,因此 easyCoexistence 會透過自己已驗證的前綴提供每個檔案,你無需進行任何驗證。排程貼文的媒體會在你排程時複製,圖片最大 30 MB,影片最大 1 GB,因此在貼文時間前失效的連結不會影響發布。若要改為上傳檔案,可呼叫 POST /media,它會回傳 media_id。
如何得知貼文已上線?
可從貼文狀態及事件得知。貼文會由 scheduled 轉為 publishing,然後在 TikTok 下載並檢查檔案時進入 processing;easyCoexistence 每 20 秒向 TikTok 查詢一次狀態,直到 TikTok 回報貼文已完成。隨後,你的事件 URL 會收到 post.published(附上貼文及其頻道),若失敗則收到 post.failed(附上網絡回報的原因)。GET /posts/{id} 也會顯示相同資料,貼文上線後還會顯示 network_post_id 和 permalink。
編輯、取消和重試如何運作?
在 TikTok 尚未收到貼文前,可在貼文上執行以下操作。PATCH /posts/{id} 可更改已排程貼文的 publish_at、text 或 title;若要更換媒體,請使用 DELETE /posts/{id} 取消後重新建立。POST /posts/{id}/retry 會重新發布失敗的貼文。若 TikTok 在 2 小時內未給出確認,貼文會以 may_be_published 為 true 失敗,重試時須將 confirm 設為 true。
貼文後的留言會怎樣?
留言可以送達你的產品。PUT /channels/{id}/webhook 會將 TikTok 的 comment.update 事件附簽章轉發至你的端點,你的後端則可使用憑證呼叫所取得的存取權杖,透過 TikTok 的 business/comment/reply/create/ 在留言下回覆。TikTok 上的回覆皆為公開,因為 TikTok 連接沒有私訊功能。
常見錯誤
- 發送 PNG 圖片作為圖片貼文。TikTok 只接受 JPEG 或 WebP,因此貼文會在加入佇列前被拒絕。
- 為影片貼文加入標題。title 僅適用於圖片貼文,影片的文字只能放在說明文字中。
- 在未查看的情況下,以 may_be_published 為 true 重試貼文。TikTok 可能已經發布該貼文,因此使用 confirm 重試前,請先檢查帳戶。
- 為同一帳戶排定超過 15 則貼文。TikTok 限制每個帳戶的 API 貼文數量,因此請將客戶的排程分散到多天。
easyCoexistence 為你的 SaaS 加入 TikTok 發布功能:你的客戶透過託管連結連接 TikTok 帳戶,你的後端即可即時或稍後發布影片與圖片貼文,並在每則貼文上線時收到通知,同時接收留言。同一個 API 也涵蓋 WhatsApp、Instagram、Facebook、YouTube、LinkedIn 及更多頻道,每個連接均獲 24/7 全天候監察。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。
常見問題
我的 SaaS 可以把 TikTok 影片存為草稿嗎?
不可以。easyCoexistence 的貼文端點會立即將影片發布至帳戶,或於 publish_at 時發布。若要讓貼文等到客戶準備好才發布,請使用排程功能。
TikTok 是否允許我透過其 API 排程貼文?
TikTok 的發布端點會在被呼叫時立即執行。easyCoexistence 會將貼文保留在自己的佇列中,並在 publish_at 時呼叫 TikTok,最遲可提前 90 天。
我的 SaaS 可以關閉 TikTok 貼文的留言功能嗎?
可以。在貼文上將 disable_comment 設為 true。若帳戶本身的設定已關閉留言,TikTok 只接受 true。
easyCoexistence 每個 TikTok 帳戶的收費是多少?
客戶每連接一個 TikTok 帳戶,每月收費 US$ 9 至 US$ 0.75,按你的總連接數級別而定,並提供首 3 天免費試用。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期