Điều kiện phê duyệt TikTok Shop Customer Service API: Checklist 2026

Để được phê duyệt TikTok Shop Customer Service API, ứng dụng phải đáp ứng một phạm vi quyền tùy chỉnh có xét duyệt; đây không phải API tin nhắn trực tiếp dùng chung cho TikTok. Tài liệu hiện tại của TikTok yêu cầu bằng chứng về chat trong ứng dụng đang hoạt động, tích hợp Order, Fulfillment và After-Sales, cùng một trong hai ngưỡng: 1.000 nhà bán hàng đã ủy quyền hoặc 1 triệu lệnh gọi API mỗi ngày. Ứng dụng TikTok Shop Seller do doanh nghiệp tự phát triển có thể được xét duyệt đặc biệt, nhưng vẫn cần từng nhà bán hàng ủy quyền trước khi truy cập dữ liệu cửa hàng.

Điểm cần nhớ

• Customer Service API phục vụ hội thoại giữa người mua và nhà bán hàng trên TikTok Shop. API này không cung cấp mọi tin nhắn trực tiếp mà một tài khoản TikTok thông thường nhận được.
• Việc xét duyệt bắt đầu từ bằng chứng về sản phẩm: giao diện chat trực tiếp, lịch sử hội thoại và ngữ cảnh vận hành cho đơn hàng, giao hàng, đổi trả và hoàn tiền.
• Ngưỡng quy mô TikTok công bố là 1.000 nhà bán hàng đã ủy quyền hoặc 1 triệu lệnh gọi API mỗi ngày; ứng dụng do chính nhà bán hàng phát triển có thể được xem xét phê duyệt đặc biệt.
• Phê duyệt phạm vi quyền tùy chỉnh và ủy quyền của từng nhà bán hàng là hai cổng riêng biệt. Ứng dụng phải vượt qua cả hai mới đọc được hội thoại của cửa hàng đó.
• Nếu nhu cầu thực tế là nhận tin nhắn đến của tài khoản thông thường, thay vì hỗ trợ người mua trên TikTok Shop, hãy đánh giá đó như một quyết định kiến trúc riêng.

Ai đủ điều kiện đăng ký TikTok Shop Customer Service API?

TikTok mô tả Customer Service API là API tùy chỉnh dành cho nhà cung cấp phần mềm độc lập (ISV) và nhà bán hàng tự xây dựng công cụ hỗ trợ. Trong Partner Center, đối tác hoặc ISV chọn Customer Service cho cả business category lẫn app or service category, sau đó yêu cầu quyền truy cập phạm vi tùy chỉnh.

Tài liệu chính thức Tổng quan Customer Service API nêu bốn lớp xét duyệt thực tế:

Lớp xét duyệt	Bằng chứng TikTok yêu cầu	Vì sao quan trọng
Sản phẩm hỗ trợ đang hoạt động	Cửa sổ chat người dùng nhìn thấy được, danh sách và chi tiết hội thoại, dấu thời gian, người tham gia, cùng luồng gửi và nhận thực tế	API được thiết kế để mở rộng một sản phẩm hỗ trợ hiện có, không phải làm thành phần đầu tiên của bản thử nghiệm
Ngữ cảnh thương mại	Các màn hình Order, Fulfillment và After-Sales được liên kết với hội thoại	Nhân viên cần xem được trạng thái đơn hàng, tiến độ giao hàng, đổi trả và hoàn tiền khi hỗ trợ người mua
Quy mô đối tác	Ít nhất 1.000 nhà bán hàng đã ủy quyền hoặc 1 triệu lệnh gọi API mỗi ngày	Customer Service là phạm vi tùy chỉnh bị giới hạn, không phải danh mục API mặc định
Ủy quyền	Ứng dụng được cấp phạm vi tùy chỉnh và từng nhà bán hàng cho phép truy cập	Phê duyệt phạm vi không tự động cấp quyền vào mọi cửa hàng

TikTok cho biết ứng dụng thuộc danh mục TikTok Shop Seller — tức nhà bán hàng có đội ngũ phát triển riêng — có thể được phê duyệt đặc biệt. Hãy xem đây là một lộ trình xét duyệt, không phải ngoại lệ được bảo đảm. Trang chính thức không cam kết phê duyệt chỉ vì ứng dụng thuộc sở hữu của một nhà bán hàng duy nhất.

Đây là điểm khác biệt cốt lõi so với câu hỏi rộng hơn về tiktok dm api. Nền tảng TikTok dành cho nhà phát triển hiện vẫn không cung cấp endpoint hộp thư đến trực tiếp cho tài khoản thông thường. Shop Customer Service API là lộ trình hẹp, có xét duyệt, dành cho hội thoại thương mại giữa người mua và nhà bán hàng.

Phạm vi được phê duyệt thực sự cung cấp gì?

Sau khi ứng dụng được phê duyệt và nhà bán hàng ủy quyền, API chính thức có thể liệt kê hội thoại, truy xuất và gửi tin nhắn, đánh dấu đã đọc, quản lý thiết lập nhân viên, tải ảnh dùng trong tin nhắn của người mua lên, đồng thời nhận webhook New Conversation và New Message. Tài liệu tham chiếu của TikTok quy định phạm vi bắt buộc là seller.customer_service.

Ví dụ, thao tác Get Conversation Messages chính thức sử dụng:

GET /customer_service/202309/conversations/{conversation_id}/messages
Required scope: seller.customer_service

Endpoint này thuộc TikTok Shop và yêu cầu access token của nhà bán hàng. Nó không thể dùng thay cho các sản phẩm Login Kit, Content Posting, Research hoặc Data Portability của TikTok for Developers. Bài bản đồ năng lực API thương mại TikTok giải thích ranh giới sản phẩm rộng hơn; checklist này chỉ tập trung vào cách nhận phạm vi Customer Service bị giới hạn.

Checklist bằng chứng cho hồ sơ đăng ký

Hãy chuẩn bị đầy đủ bộ hồ sơ xét duyệt trước khi yêu cầu phạm vi tùy chỉnh:

1. Trình bày toàn bộ sản phẩm chat. Ghi lại màn hình không cắt xén, thể hiện danh sách và chi tiết hội thoại, danh tính người tham gia, dấu thời gian, lịch sử, cùng luồng gửi và nhận. TikTok yêu cầu ảnh chụp màn hình và một video quay màn hình ngắn; bản mô phỏng có thể không chứng minh được sản phẩm đang vận hành.
2. Liên kết hội thoại với dữ liệu thương mại. Cho thấy chi tiết đơn hàng, trạng thái giao hàng, trạng thái đổi trả hoặc hoàn tiền liên quan, cùng cách nhân viên sử dụng chúng trong một cuộc hội thoại thực tế.
3. Chứng minh ngưỡng quy mô mà hồ sơ dựa vào. Cung cấp bằng chứng về 1.000 nhà bán hàng đã ủy quyền hoặc báo cáo thể hiện 1 triệu lệnh gọi API mỗi ngày. Với ứng dụng Seller tự phát triển, cần mô tả nhà bán hàng, đội ngũ phát triển và quy trình hỗ trợ nội bộ, thay vì mặc định rằng ứng dụng được miễn trừ.
4. Yêu cầu đúng phạm vi tùy chỉnh. Hướng dẫn access scope của TikTok cho biết phạm vi tùy chỉnh phải được yêu cầu tại Partner Console → App & Service → Manage → Manage API. Hãy xác nhận seller.customer_service đã được bật cho ứng dụng.
5. Kiểm thử riêng bước ủy quyền của nhà bán hàng. Ứng dụng được xét duyệt không đồng nghĩa đã có seller token. Hãy xác minh quy trình cài đặt và ủy quyền, lưu mã định danh cửa hàng cùng phạm vi đã cấp, đồng thời xử lý trường hợp thu hồi quyền.
6. Kiểm tra lại trang chính thức trước khi nộp. Quy định về phạm vi tùy chỉnh có thể thay đổi theo thị trường và tài khoản. Bài viết này ghi lại tài liệu hiển thị vào ngày 18 tháng 7 năm 2026; Partner Center là nguồn quyết định cuối cùng cho hồ sơ được trình bày trong tài khoản của bạn.

Xác định đúng bề mặt nhắn tin cần tích hợp

Nhu cầu	Bề mặt phù hợp	Ràng buộc chính
Hỗ trợ người mua TikTok Shop trong hệ thống chăm sóc khách hàng thương mại điện tử hiện có	TikTok Shop Customer Service API	Xét duyệt phạm vi tùy chỉnh, bằng chứng sản phẩm, quy mô và ủy quyền nhà bán hàng
Gửi nội dung tiếp cận thương mại đã được duyệt tới người mua cũ đủ điều kiện	TikTok Shop Customer Engagement API	Quyền tính năng riêng, điều kiện người nhận, mẫu nội dung và quy tắc tần suất
Xuất dữ liệu TikTok mà người dùng đã cho phép	TikTok Data Portability API	Xét duyệt, khu vực được hỗ trợ, sự đồng ý của người dùng và tác vụ xuất dữ liệu — không phải hộp thư đến trực tiếp
Nhận tin nhắn đến được hỗ trợ từ tài khoản thông thường đã kết nối	Giao diện không chính thức của UnifyPort	Mô hình kết nối tài khoản và vận hành webhook riêng; không có đặc quyền TikTok Shop

Hãy hoàn thành bước phân loại này trước khi viết code. Đội ngũ cần hội thoại Shop gắn với đơn hàng nên theo đuổi Customer Service API chính thức. Với đội kỹ thuật thương mại điện tử xuyên biên giới tại Việt Nam chỉ cần luồng tin nhắn đến trực tiếp của tài khoản thông thường, không nên xây thêm màn hình Order và Fulfillment chỉ để khiến một sản phẩm khác trông có vẻ đủ điều kiện.

UnifyPort phù hợp ở đâu?

UnifyPort không cấp seller.customer_service, không phê duyệt ứng dụng Partner Center, không ủy quyền cửa hàng, không cung cấp dữ liệu đơn hàng Seller Center, cũng không cung cấp chỉ số nhân viên và dịch vụ chính thức của TikTok. Hãy dùng API chính thức khi các năng lực thương mại đó là yêu cầu bắt buộc.

UnifyPort phù hợp với trường hợp riêng: nhận tin nhắn đến của tài khoản thông thường. Hướng dẫn phát hành UnifyPort Exporter mô tả cách chuyển phiên TikTok có sự hỗ trợ của trình duyệt, còn API chuyển lưu lượng đến được hỗ trợ qua webhook envelope chuẩn message.received. Ví dụ sự kiện đến giả định dưới đây dùng đúng các trường đã được tài liệu hóa như những provider khác:

{
  "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"
    }
  }
}

Khi webhook endpoint có signing_secret, hãy xác minh X-Device-Timestamp và X-Device-Signature trên raw body trước khi lưu sự kiện. Tài liệu tham chiếu loại sự kiện và payload chuẩn là nguồn chi tiết nhất về envelope; hãy kiểm tra tài liệu năng lực provider hiện tại trước khi phụ thuộc vào bất kỳ thao tác gửi đi nào.

Giới hạn và đánh đổi

Lộ trình TikTok Shop chính thức phù hợp hơn khi nhân viên cần danh tính người mua trên Shop, liên kết đơn hàng, vòng đời hội thoại, hành vi gửi đi đã được duyệt hoặc nghiệp vụ dịch vụ gốc của nền tảng. Lộ trình này giữ cơ chế ủy quyền thương mại và chính sách nền tảng trong mô hình được TikTok hỗ trợ.

Giao diện không chính thức không thể giúp ứng dụng đủ điều kiện dùng Customer Service API, biến tin nhắn trực tiếp thông thường thành hội thoại Shop, khởi chạy chiến dịch người mua chính thức hoặc tái tạo dữ liệu Seller Center. Giá trị hẹp hơn của nó là luồng sự kiện đến chuẩn hóa cho các tài khoản đã kết nối và được hỗ trợ. Chỉ lưu hồ sơ đơn hàng và fulfillment trong hệ thống của bạn khi đã có nguồn dữ liệu hợp pháp, đáng tin cậy cho các thông tin đó.

Câu hỏi thường gặp

Điều kiện phê duyệt TikTok Shop Customer Service API là gì?

TikTok hiện yêu cầu cửa sổ chat trong ứng dụng đang hoạt động, tích hợp Order, Fulfillment và After-Sales có thể quan sát được, cùng 1.000 nhà bán hàng đã ủy quyền hoặc 1 triệu lệnh gọi API mỗi ngày. Ứng dụng phải yêu cầu phạm vi Customer Service tùy chỉnh và từng nhà bán hàng phải cho phép truy cập.

Một nhà bán hàng TikTok Shop riêng lẻ có thể dùng Customer Service API không?

Có thể, nhưng không tự động. TikTok cho biết ứng dụng tự phát triển thuộc danh mục TikTok Shop Seller có thể được phê duyệt đặc biệt. Nhà bán hàng nên nộp bằng chứng về đội ngũ phát triển, sản phẩm chat đang vận hành, ngữ cảnh thương mại và quy trình hỗ trợ dự kiến.

Customer Service API có phải API tin nhắn trực tiếp dùng chung cho TikTok không?

Không. API này chỉ bao phủ hội thoại chăm sóc khách hàng giữa người mua và nhà bán hàng trên TikTok Shop. Nó không cung cấp mọi tin nhắn trực tiếp mà creator hoặc tài khoản TikTok thông thường nhận được.

Ứng dụng được phê duyệt rồi có còn cần nhà bán hàng ủy quyền không?

Có. Phê duyệt phạm vi tùy chỉnh làm cho năng lực đó khả dụng với ứng dụng; ủy quyền của nhà bán hàng cho phép ứng dụng truy cập một cửa hàng cụ thể. Cả hai điều kiện đều bắt buộc.

Nên làm gì nếu ứng dụng chưa đủ điều kiện?

Hãy xác định chính xác nhu cầu. Dùng Seller Center để hỗ trợ Shop chính thức, hoàn thiện bằng chứng sản phẩm còn thiếu trước khi đăng ký lại, hoặc đánh giá giao diện nhận tin nhắn đến của tài khoản thông thường nếu thực tế không cần danh tính, đơn hàng và năng lực nhân viên dành riêng cho Shop.

Bước tiếp theo

Nếu sản phẩm thực sự phụ trách hỗ trợ người mua trên Shop, hãy dùng Tổng quan Customer Service API của TikTok làm checklist đăng ký và xác nhận yêu cầu trong tài khoản Partner Center. Nếu nhu cầu là định tuyến tin nhắn đến của tài khoản thông thường, hãy đọc tài liệu tham chiếu sự kiện webhook chuẩn của UnifyPort trước khi chọn lộ trình kết nối riêng.

Nguồn

Các nguồn chính thức của TikTok được kiểm tra ngày 18 tháng 7 năm 2026:

• Tổng quan Customer Service API và quy định phê duyệt
• Phạm vi truy cập API TikTok Shop
• Tài liệu tham chiếu Get Conversation Messages