TikTok 评论与私信
评论管理与私信收发——对接 TikTok 账号的互动能力
TikTok 评论与私信
在视频发布之外，平台还提供 TikTok 账号的互动能力：评论管理、私信收发。相关：数据洞察 · 事件推送（webhook）。
路径与官方文档的对照
本组端点的路径与 TikTok 官方文档一一对应——把官方文档里的 https://business-api.tiktok.com/open_api/ 换成本平台地址（https://cli.haina.io/v1/tiktok/）即可，路径其余部分（含 v1.3）逐字符相同：
| TikTok 官方文档 | 本平台 |
|---|---|
GET /open_api/v1.3/business/comment/list/ | GET /v1/tiktok/v1.3/business/comment/list |
POST /open_api/v1.3/business/comment/reply/create/ | POST /v1/tiktok/v1.3/business/comment/reply/create |
POST /open_api/v1.3/business/message/send/ | POST /v1/tiktok/v1.3/business/message/send |
与官方文档的三点差异：
account取代business_id：你只传账号引用（username 如steve72920，或平台 businessId），平台凭据由系统自动关联；- 参数名 camelCase（
video_id→videoId、max_count→maxCount），枚举值与官方文档一致（如LIKE、HIDE、PUBLIC）； - 响应统一为 envelope
{ code, message, data }，错误码见认证与约定。
评论管理
| 能力 | 端点 | CLI |
|---|---|---|
| 评论列表 | GET /v1/tiktok/v1.3/business/comment/list | haina tt comment list --account <id> --video-id <postId> |
| 回复列表 | GET …/comment/reply/list | haina tt comment replies --account <id> --video-id <postId> --comment-id <id> |
| 发顶层评论 | POST …/comment/create | haina tt comment create --account <id> --video-id <postId> --text <t> |
| 回复评论 | POST …/comment/reply/create | haina tt comment reply … |
| 点赞/取消 | POST …/comment/like（action=LIKE/UNLIKE） | haina tt comment like … |
| 隐藏/恢复 | POST …/comment/hide（action=HIDE/UNHIDE） | haina tt comment hide … |
| 删除评论 | POST …/comment/delete | haina tt comment delete … |
参数细节：videoId 为官方数字 postId（非视频库 uuid）；maxCount ≤30；status（PUBLIC/ALL）；includeReplies=true 每条顶层评论附带 ≤3 条回复；commentIds 精确过滤 ≤30 个。响应评论对象字段（commentId/parentCommentId/owner/status/username 等）与官方同义，id 均为字符串。
平台规则（删除仅限自评、UNHIDE 不保证生效、spam 频率等）见评论规则。
私信
| 能力 | 端点 | CLI |
|---|---|---|
| 会话列表 | GET /v1/tiktok/v1.3/business/message/conversation/list?account=&conversationType= | haina tt message conversations --account <id> --type SINGLE|STRANGER |
| 消息列表 | GET …/message/content/list?account=&conversationId= | haina tt message list --account <id> --conversation-id <id>（官方固定最近 20 条） |
| 发送消息 | POST …/message/send（{account, conversationId, text?…}） | haina tt message send --account <id> --conversation-id <id> --text <t>（另支持 --image-file/--share-post/--qa-card/--typing/--mark-read/--reply-to） |
| 图片上传/下载 | POST …/message/media/upload · /media/download | haina tt message upload-image / haina tt message download |
| 会话能力自检 | GET …/message/capabilities/get | haina tt message capabilities |
前置条件：坐席账号需在 TikTok App 内开启「接收所有人私信」（否则新会话不会进入列表）；私信 API 需开发者应用通过 TikTok 的 Advanced Access 审查（未批时官方返回 40001——自动消息面实测也可能是 401/405，一律按透传的官方 message 处理，勿按错误码自行分支；事件通知不受影响）。发送窗口、媒体有效期、地区限制等见私信规则。
自动消息（Automatic Messages）
账号级的自动应答配置，三种类型：欢迎语（WELCOME_MESSAGE，≤1 条）、常见问题（SUGGESTED_QUESTION，≤3 条，问答对）、输入框提示按钮（CHAT_PROMPT，≤6 条，可排序）。创建/更新后进入官方审核（REVIEWING → APPROVED/REJECTED）。
| 能力 | 端点（全 POST） | CLI |
|---|---|---|
| 查询（含整类开关与审核状态） | POST …/message/auto_message/get | haina tt message auto get --account <id> --type <类型> [--id <mid>] |
| 创建 | POST …/message/auto_message/create | haina tt message auto create --account <id> --type <类型> …（welcome 带 --content；suggested 带 --question --answer；chat_prompt 带 --title --content） |
| 更新 | POST …/message/auto_message/update | haina tt message auto update --account <id> --id <mid> --type <类型> …（内容参数同 create） |
| 删除 | POST …/message/auto_message/delete | haina tt message auto delete --account <id> --id <mid> --type <类型>（欢迎语不可删） |
| 排序 | POST …/message/auto_message/sort | haina tt message auto sort --account <id> --ids id1,id2,…（仅 CHAT_PROMPT） |
| 整类开关 | POST …/message/auto_message/status/update | haina tt message auto status --account <id> --type <类型> --action ENABLE|DISABLE |
参数细节：autoMessageType/operationStatus 大小写不敏感（归一官方大写）；内容长度上限由官方校验、报错透传；欢迎语只能 DISABLE 关闭（官方不支持删除）。审核状态机与各类型上限见私信规则。