TikTok 商业账号连接指南：核对套餐授权、内容洞察与私信消息权限启用条件

概览

TikTok 通道用于连接一个 TikTok 商业账号（Business account），让你在 WAthink 中管理账号运营 — 查看洞察、发布视频与图片、运营 TikTok Shop，并把来自 TikTok 广告的线索表单提交直接捕获到联系人。它通过 TikTok Login 连接，复用同一套联系人，并（对广告线索而言）复用与其它渠道相同的捕获管线。

私信功能已开发完成 — 但受 TikTok 审核门槛限制。WAthink 中的私信收件箱已端到端接通（连接、凭据存储、地区校验、入站 Webhook、收件箱线程与回复）。WAthink 无法提供的是访问权限本身：TikTok 的私信 API 属于 Partner 审核制（partner-gated）的 Business Messaging 计划，仅向 TikTok 选定的合作伙伴开放审批，并且有地区限制（美国、欧洲经济区、瑞士与英国不可用）。在你持有 TikTok 批准的 Business Messaging Partner 应用之前，私信通道保持关闭；获批后可按账号启用 — 见启用私信收件箱。没有该批准时，请把 TikTok 用作内容、洞察、电商与线索捕获渠道。

当前能力

前提条件

平台管理员：TikTok 应用与凭据

由平台运营者一次性配置。最终你会得到一个 Client Key 和一个 Client Secret，用于粘贴到 WAthink。

1. 打开 TikTok for Developers。访问 developers.tiktok.com，登录并打开 Manage apps。
2. 创建一个应用并填写 TikTok 要求的业务信息。
3. 添加 Login Kit 及你需要的产品 — Display API（洞察）、Content Posting API（发布），以及使用时的 TikTok Shop。
4. 复制 Client Key 与 Client Secret。在应用的凭据页面获取。
5. 设置重定向 URI为 WAthink 的 TikTok 回调 URL（显示在 WAthink 管理后台 → Settings → WAthink Message 中）。
6. 把密钥粘贴到 WAthink。在 Admin → Settings → WAthink Message 中填写 TikTok Client Key 与 TikTok Client Secret，并打开 TikTok 通道。

Login Kit 连接请求的权限范围（scopes）：user.info.basic、user.info.profile、user.info.stats、video.list、video.upload。它们覆盖资料、洞察与发布 — 不包含消息功能。

用户：连接你的账号

1. 在 WAthink 中打开 TikTok 页面（/tiktok/accounts）— 通道启用后它会出现在菜单中。
2. 点击 Connect — 你会跳转到 TikTok Login（Login Kit OAuth）。
3. 授权商业账号所请求的权限。
4. 完成。资料、洞察与发布工具即可使用；广告线索表单开始流入联系人。

使用方式

• 洞察。无需离开 WAthink 即可查看账号资料与视频表现。
• 发布。通过 Content Posting API 创建并发布（或存为草稿）视频与图片。
• TikTok Shop。连接 Shop，把电商数据与其它店铺放在一起。
• 广告线索。当有人提交 TikTok 线索表单时，他们会被捕获为联系人，之后你可以通过 WhatsApp、Telegram、LINE 或短信联系他们。
• 统一社交。TikTok 帖子会加入统一的社交帖子与日历视图。

启用私信收件箱

私信收件箱在 WAthink 中已完整接通 — 连接、凭据存储、地区校验、入站 Webhook、收件箱线程与回复。只差 TikTok 的 Partner 访问权限即可开启。以下说明为什么有门槛，以及获批后如何启用。

为什么有门槛

• TikTok 仅通过 Business Messaging 计划开放私信，且必须由 TikTok 对你的开发者应用进行审批 — 它不像洞察或发布那样只是一个可申请的权限范围（scope）。
• 即使获批，消息功能也有地区限制（美国、欧洲经济区、瑞士与英国不可用），且仅支持被动回复：商家在用户首次发来消息后的 48 小时内最多可发送 10 条消息；此后，每次用户回复后的 48 小时内可无限量发送。

启用步骤

1. 获取 Messaging-Partner 批准。申请 TikTok 的 Messaging Partner 计划，并创建一个 TikTok API for Business 应用（business-api.tiktok.com）— 与 Login Kit 应用相互独立 — 以获取其 Client Key (app_id) 与 Client Secret。
2. 管理员：设置商业应用。在 Admin → Settings → WAthink Message 中填写 tiktok_business_app_id 与 tiktok_business_app_secret，并打开 tiktok_inbox_enabled。
3. 管理员：注册 Webhook。在开发者门户中为你的 TikTok 应用把 Webhook 回调设为 https://your-domain/webhooks/tiktok/business，并订阅 new_message 与 new_conversation 事件。（TikTok 没有按账号订阅的 API — Webhook 在应用级配置一次。）
4. 运营者：连接账号。在 TikTok 账号卡片上会出现 DM inbox 区域 — 粘贴来自 Partner 授权的 Business ID 与 access token，点击 Connect DM inbox。WAthink 会保存它们并检测账号所在地区。
5. 完成。若地区受支持，入站私信会进入团队收件箱，客服可在同一编辑器中回复。随后自动回复规则与流程也可限定到 TikTok。

底层实现：WAthink 调用 TikTok Business Messaging v1.3 端点 — /business/message/conversation/list/、/business/message/content/list/ 与 /business/message/send/ — 并把 access token 放在 Access-Token 请求头中。每次调用都会软失败（fail soft），因此未获批的账号不会导致页面出错：它只会把私信通道报告为关闭状态。

故障排查