接入指南
坐席与账号绑定
开户后把 TikTok / TikTok Shop 账号绑进坐席,拿到发布所需的账号 ID
坐席与账号绑定
什么是坐席
- 1 个 TikTok 账号 = 1 个坐席(计费按"坐席 × 月")。
- 坐席是预生成的槽位:开户 5 坐席 → 「坐席」页就有 5 个槽位格子,绑定就是往格子里填账号。
- 同一坐席可绑同一账号的两种能力:TikTok 发视频(TT)+ TikTok Shop 挂车(TTS)。两种能力只占 1 个坐席。
- 解绑后槽位恢复空闲,可重新绑定。
绑定流程(管理后台)
- 登录后台 → 左侧「坐席」
- 空槽点「绑定」→ 弹框选能力:
- TikTok:发视频能力
- TikTok Shop:挂车能力(需选店铺类型:本土店/跨境店/欧区本土店/创作者橱窗)
- 用手机扫码(或复制链接到已登录 TikTok 的浏览器打开)→ 完成授权
- 回到坐席页,槽位显示已绑定的账号信息
授权链接 10 分钟内有效;过期回坐席页重新打开弹框即可。 手机授权完成后,电脑端弹框会在几秒内自动检测并关闭。 不同店铺类型(本土店/跨境店/欧区本土店/创作者橱窗)的能力面由官方账号权限决定(如商品/音乐接口的可用性随店铺类型与地区而异)——平台不做额外限制,能力是否可用以官方接口返回为准。
绑定规则(重要)
- 同一账号不能同时占两个坐席(
1006);第二能力请追加到原坐席 - 同一坐席的两个能力必须是同一个 TikTok 账号(按 username 校验),不一致会被拒(
1008) - 同坐席同能力重复绑定 = 换绑(先清后填)
授权健康状态
坐席页每行绑定带授权状态:正常为 active;若发布/状态查询时官方报告授权失效(或账号被平台限制),
该行会显示**「授权已失效」警告徽标**——点该坐席的「重新授权」重走一遍 OAuth 即可恢复(换绑分支自动复位为 active)。
绑定后拿到什么 ID
发布接口需要的账号 ID 可以在坐席页直接复制,也可以通过 API 获取:
curl -H "Authorization: Bearer $TOKEN" $BASE/v1/seats返回的每个坐席带 bindings 数组:
| capability | capabilityAccountId 的含义 | 用于 |
|---|---|---|
TT | TikTok businessId | TikTok 发布接口的 account(/v1/tiktok/v1.3/business/video/publish,也可直接传 username) |
TTS | creatorUserOpenId | /v1/publish/tts、/v1/products/query 的 accountId |