HAiNA CLI docs
接入指南

坐席与账号绑定

开户后把 TikTok / TikTok Shop 账号绑进坐席,拿到发布所需的账号 ID

坐席与账号绑定

什么是坐席

  • 1 个 TikTok 账号 = 1 个坐席(计费按"坐席 × 月")。
  • 坐席是预生成的槽位:开户 5 坐席 → 「坐席」页就有 5 个槽位格子,绑定就是往格子里填账号。
  • 同一坐席可绑同一账号的两种能力:TikTok 发视频(TT)+ TikTok Shop 挂车(TTS)。两种能力只占 1 个坐席。
  • 解绑后槽位恢复空闲,可重新绑定。

绑定流程(管理后台)

  1. 登录后台 → 左侧「坐席」
  2. 空槽点「绑定」→ 弹框选能力:
    • TikTok:发视频能力
    • TikTok Shop:挂车能力(需选店铺类型:本土店/跨境店/欧区本土店/创作者橱窗)
  3. 用手机扫码(或复制链接到已登录 TikTok 的浏览器打开)→ 完成授权
  4. 回到坐席页,槽位显示已绑定的账号信息

授权链接 10 分钟内有效;过期回坐席页重新打开弹框即可。 手机授权完成后,电脑端弹框会在几秒内自动检测并关闭。 不同店铺类型(本土店/跨境店/欧区本土店/创作者橱窗)的能力面由官方账号权限决定(如商品/音乐接口的可用性随店铺类型与地区而异)——平台不做额外限制,能力是否可用以官方接口返回为准。

绑定规则(重要)

  • 同一账号不能同时占两个坐席(1006);第二能力请追加到原坐席
  • 同一坐席的两个能力必须是同一个 TikTok 账号(按 username 校验),不一致会被拒(1008)
  • 同坐席同能力重复绑定 = 换绑(先清后填)

授权健康状态

坐席页每行绑定带授权状态:正常为 active;若发布/状态查询时官方报告授权失效(或账号被平台限制), 该行会显示**「授权已失效」警告徽标**——点该坐席的「重新授权」重走一遍 OAuth 即可恢复(换绑分支自动复位为 active)。

绑定后拿到什么 ID

发布接口需要的账号 ID 可以在坐席页直接复制,也可以通过 API 获取:

curl -H "Authorization: Bearer $TOKEN" $BASE/v1/seats

返回的每个坐席带 bindings 数组:

capabilitycapabilityAccountId 的含义用于
TTTikTok businessIdTikTok 发布接口的 account(/v1/tiktok/v1.3/business/video/publish,也可直接传 username)
TTScreatorUserOpenId/v1/publish/tts、/v1/products/query 的 accountId

On this page