TikTok Shop 客服 API 审批要求:2026 资格检查清单
TikTok Shop Customer Service API 属于需要专项审批的自定义权限,并不是通用 TikTok 私信 API。TikTok 当前文档要求申请方提供可运行的应用内聊天、订单、履约和售后集成,并达到 1,000 个授权卖家或每日 100 万次 API 调用。商家自研的 TikTok Shop Seller 应用可以申请特别审批,但要读取店铺数据,仍须先取得对应卖家的授权。
核心结论
- Customer Service API 服务于 TikTok Shop 买家与卖家之间的客服会话,不会开放普通 TikTok 账号收到的所有私信。
- 审批先看产品证据:可实际使用的聊天界面、会话历史,以及与订单、物流、退货和退款相连的客服工作流。
- TikTok 公布的规模门槛是 1,000 个授权卖家或每日 100 万次 API 调用;商家自研应用可以进入特别审批流程。
- 自定义权限获批与逐个卖家授权是两道不同的门槛。两者都完成后,应用才能读取该店铺的会话。
- 如果出海或东南亚团队真正需要的是普通账号入站消息,而不是 TikTok Shop 买家客服,应把它当作另一项架构决策单独评估。
谁符合 TikTok Shop 客服 API 的申请资格?
TikTok 将 Customer Service API 定义为面向独立软件服务商(ISV)和自建客服工具商家的自定义 API。合作伙伴或 ISV 需要在 Partner Center 中,把业务类别及应用或服务类别都选择为 Customer Service,再申请对应的自定义权限。
官方 Customer Service API 概览列出了四层实际审批要求:
| 审批层级 | TikTok 要求的证据 | 为什么重要 |
|---|---|---|
| 可运行的客服产品 | 用户可见的聊天窗口、会话列表与详情、时间戳、参与者,以及真实的消息收发流程 | 这项 API 用于扩展已存在的客服产品,不是原型项目的第一个组件 |
| 电商上下文 | 与会话关联的订单、履约和售后界面 | 客服协助买家时,需要查看订单状态、物流进度、退货和退款信息 |
| 合作伙伴规模 | 至少 1,000 个授权卖家或每日 100 万次 API 调用 | Customer Service 是受限的自定义权限,并非默认 API 类别 |
| 授权 | 应用取得自定义权限,且每个卖家分别授权访问 | 权限获批不会自动开放所有店铺数据 |
TikTok 也说明,归入 TikTok Shop Seller 类别、由商家自己的研发团队开发的应用,可以获得特别审批。应把它理解为一条可申请的审核路径,而不是必然豁免;官方页面并没有承诺商家自有应用一定获批。
这正是它与更宽泛的 TikTok 私信 API 问题之间最关键的区别。通用 TikTok 开发者平台仍未向普通账号提供实时收件箱端点;Shop Customer Service API 只为买卖双方的电商客服会话提供一条范围有限、需要审批的官方路径。
获批权限实际包含哪些能力?
自定义权限获批且卖家完成授权后,官方 API 可以列出会话、获取消息、发送消息并标记已读、管理客服设置、上传买家消息图片,以及接收 New Conversation 和 New Message webhook。TikTok 参考文档把所需权限标记为 seller.customer_service。
例如,官方 Get Conversation Messages 操作使用:
GET /customer_service/202309/conversations/{conversation_id}/messages
Required scope: seller.customer_service
这个端点属于 TikTok Shop,并要求使用卖家 access token。它不能与 TikTok for Developers 的 Login Kit、Content Posting、Research 或 Data Portability 产品互换。已有的 TikTok 电商 API 能力边界说明梳理了更完整的产品范围;本文只聚焦如何取得受限的 Customer Service 权限。
申请材料检查清单
在申请自定义权限前,先准备好完整的审核材料:
- 展示完整的聊天产品。 提交未裁切的会话列表与详情页,清晰呈现参与者身份、时间戳、历史记录和消息收发流程。TikTok 要求截图和一段简短录屏;仅有设计稿通常不足以证明产品已经运行。
- 把会话与电商数据连起来。 展示订单详情、配送状态,以及相关退货或退款状态,并说明客服如何在真实会话中使用这些信息。
- 证明所采用的规模条件。 提供 1,000 个授权卖家的证据,或能证明每日 100 万次 API 调用的报表。商家自研 Seller 应用应说明商家主体、研发团队和内部客服流程,不要把特别审批当作自动豁免。
- 申请正确的自定义权限。 TikTok 的 access scope 指南说明,自定义权限须从 Partner Console → App & Service → Manage → Manage API 提交。确认应用已经启用
seller.customer_service。 - 单独测试卖家授权。 应用审核通过不等于已经拿到卖家 token。验证安装与授权流程,保存店铺标识和已授予权限,并处理授权撤销。
- 提交前再次核对官方页面。 自定义权限规则可能因市场和账号而变。本文记录的是 2026 年 7 月 18 日可见的文档;最终应以你的 Partner Center 账号实际展示的申请要求为准。
先判断你真正需要哪一种消息能力
| 真实需求 | 正确能力 | 主要限制 |
|---|---|---|
| 在现有电商客服系统中服务 TikTok Shop 买家 | TikTok Shop Customer Service API | 自定义权限审核、产品证据、规模条件和卖家授权 |
| 向符合资格的历史买家发送获批电商触达 | TikTok Shop Customer Engagement API | 独立的功能权限、收件人资格、模板和频率规则 |
| 导出用户已授权的 TikTok 数据 | TikTok Data Portability API | 审核、支持地区、用户同意和数据导出;不是实时收件箱 |
| 接收已连接普通账号所支持的入站消息 | UnifyPort 非官方接口 | 独立的账号连接与 webhook 运行模式;不包含 TikTok Shop 权限 |
写代码前先做完这项判断。需要订单关联 Shop 会话的团队,应申请官方 Customer Service API;需要普通账号实时入站消息流的团队,不应为了让另一类产品看起来符合资格而额外搭建订单与履约页面。
UnifyPort 适合放在哪一层?
UnifyPort 不会授予 seller.customer_service、审批 Partner Center 应用、代替店铺授权、开放 Seller Center 订单数据,也不会提供 TikTok 官方客服与服务指标。只要这些电商能力是硬性需求,就应使用官方 API。
UnifyPort 适合另一种场景:普通账号的入站消息。UnifyPort Exporter 发布与连接指南说明了由浏览器辅助完成 TikTok 会话连接的流程;随后,API 会通过标准 message.received webhook 事件结构投递所支持的入站消息。以下是假设性的入站事件示例,字段结构与其他 provider 的文档保持一致:
{
"id": "evt_7b9f2d41c6",
"type": "message.received",
"provider": "tiktok",
"account_id": "acc_4e81a7",
"occurred_at": "2026-07-18T03:14:25Z",
"data": {
"conversation": { "id": "7421183065", "type": "user" },
"sender": { "id": "7369021841", "type": "user", "name": "Mina" },
"message": {
"id": "msg_20260718_031425",
"type": "text",
"text": "Is this item available in Thailand?",
"direction": "inbound",
"sent_at": "2026-07-18T03:14:24Z"
}
}
}
当 webhook 端点配置了 signing_secret,应先使用原始请求体校验 X-Device-Timestamp 和 X-Device-Signature,再保存事件。标准事件类型与 payload 参考是查看事件结构的深入文档;任何出站操作都应先核对当前 provider 能力说明。
限制与取舍
如果客服必须获取 Shop 买家身份、订单关联、会话生命周期、获批出站行为或平台原生服务操作,TikTok Shop 官方路径更合适。它把电商授权与平台政策留在 TikTok 支持的体系内。
非官方接口不能让应用获得 Customer Service API 资格,不能把普通私信变成 Shop 会话,不能发起官方买家营销活动,也不能复现 Seller Center 数据。它更窄的价值,是为所支持的已连接账号提供标准入站事件流。只有在你已经拥有合法、可靠的数据来源时,才应在自己的系统中维护订单与履约记录。
常见问题
TikTok Shop 客服 API 的审批要求有哪些?
TikTok 当前要求提供可运行的应用内聊天窗口、可见的订单、履约和售后集成,并达到 1,000 个授权卖家或每日 100 万次 API 调用。应用还须申请 Customer Service 自定义权限,每个卖家也须分别授权。
单个 TikTok Shop 商家可以申请 Customer Service API 吗?
有可能,但不会自动获批。TikTok 表示,TikTok Shop Seller 类别下的商家自研应用可以获得特别审批。商家应提交研发团队、已运行聊天产品、电商上下文及预期客服流程的证据。
Customer Service API 是通用 TikTok 私信 API 吗?
不是。它只覆盖 TikTok Shop 买家与卖家之间的客服会话,不会开放创作者或普通 TikTok 账号收到的全部私信。
应用获批后还需要卖家授权吗?
需要。自定义权限审批让应用具备申请该能力的资格;卖家授权才允许应用访问某一家店铺。两道门槛缺一不可。
应用暂时不符合资格时应该怎么办?
先把需求范围说清楚:官方 Shop 客服可以继续使用 Seller Center;缺少产品证据的团队应补齐后再申请;如果并不需要 Shop 专属身份、订单和客服能力,则可评估普通账号入站接口。
下一步
如果你的产品确实承担 Shop 买家客服,请以 TikTok 的 Customer Service API 概览作为申请清单,并在自己的 Partner Center 账号中再次确认要求。如果需求是普通账号入站消息分流,请先阅读 UnifyPort 的标准 webhook 事件参考,再选择独立的账号连接路径。
来源
以下 TikTok 官方来源核验于 2026 年 7 月 18 日: