Как получить одобрение TikTok Shop Customer Service API: чек-лист требований на 2026 год
Customer Service API в TikTok Shop — это доступ по индивидуально одобряемому scope, а не общий API для DM в TikTok. Для заявки TikTok просит показать рабочий чат в приложении, интеграции Order, Fulfillment и After-Sales, а также подтвердить 1 000 авторизованных продавцов или 1 миллион API-вызовов в день. Приложение, самостоятельно разработанное продавцом TikTok Shop, может пройти специальное рассмотрение, но для доступа к данным магазина всё равно нужна авторизация продавца.
Главное
- Customer Service API предназначен для переписки между покупателями и продавцами TikTok Shop. Он не открывает все личные сообщения обычного аккаунта TikTok.
- Для одобрения нужен уже работающий продукт: интерфейс живого чата, история переписки и контекст заказов, доставки, возвратов и возмещений.
- Опубликованный TikTok порог масштаба — 1 000 авторизованных продавцов или 1 миллион API-вызовов в день. Приложение самого продавца может быть рассмотрено по специальной процедуре.
- Одобрение custom scope и авторизация каждого продавца — разные этапы. Без обоих приложение не сможет читать переписку конкретного магазина.
- Если вам нужны входящие сообщения обычного аккаунта, а не поддержка покупателей TikTok Shop, это отдельная архитектурная задача.
Кто может получить одобрение TikTok Shop Customer Service API?
TikTok описывает Customer Service API как custom API для независимых поставщиков ПО и продавцов, создающих собственные инструменты поддержки. В Partner Center партнёр или ISV выбирает Customer Service одновременно как бизнес-категорию и как категорию приложения или сервиса, а затем запрашивает доступ к custom scope.
В официальном обзоре Customer Service API перечислены четыре практических уровня проверки:
| Уровень проверки | Какие подтверждения запрашивает TikTok | Почему это важно |
|---|---|---|
| Работающий продукт поддержки | Видимое пользователю окно чата, список и карточка диалога, временные метки, участники и реальный обмен сообщениями | API должен расширять существующий продукт поддержки, а не быть первым компонентом прототипа |
| Коммерческий контекст | Разделы Order, Fulfillment и After-Sales, связанные с перепиской | Во время помощи покупателю оператор должен видеть состояние заказа, ход доставки, возвраты и возмещения |
| Масштаб партнёра | Не менее 1 000 авторизованных продавцов или 1 миллион API-вызовов в день | Customer Service — ограниченный custom scope, а не стандартная категория API |
| Авторизация | Приложение получает custom scope, после чего каждый продавец отдельно разрешает доступ | Одобрение scope не открывает автоматически данные всех магазинов |
По данным TikTok, приложение в категории TikTok Shop Seller, то есть приложение продавца с собственной командой разработки, может получить специальное одобрение. Считайте это отдельным путём рассмотрения, а не гарантированным исключением: официальная страница не обещает одобрение только потому, что приложение принадлежит одному продавцу.
В этом и состоит ключевое отличие от общего вопроса об API для DM в TikTok. Обычная платформа TikTok для разработчиков по-прежнему не предоставляет endpoint живой входящей переписки для стандартного аккаунта. Customer Service API для Shop — узкий, проверяемый канал для коммерческих диалогов между покупателями и продавцами.
Какие возможности даёт одобренный scope
После одобрения приложения и авторизации продавца официальный API позволяет получать список диалогов и сообщения, отправлять сообщения и отмечать их прочитанными, управлять настройками операторов, загружать изображения из сообщений покупателей и получать webhook-события New Conversation и New Message. В справочнике TikTok необходимый scope указан как seller.customer_service.
Например, официальная операция Get Conversation Messages использует:
GET /customer_service/202309/conversations/{conversation_id}/messages
Required scope: seller.customer_serviceЭтот endpoint относится к TikTok Shop и требует access token продавца. Он не взаимозаменяем с Login Kit, Content Posting, Research или Data Portability на платформе TikTok for Developers. Существующая карта возможностей коммерческих API TikTok показывает общую границу между продуктами; здесь же мы рассматриваем только получение ограниченного scope Customer Service.
Чек-лист подтверждений для заявки
Подготовьте пакет для проверки до запроса custom scope:
- Покажите продукт для работы с чатами целиком. Приложите необрезанные изображения списка и карточки диалога, идентификаторы участников, временные метки, историю и реальный сценарий отправки и получения сообщений. TikTok запрашивает скриншоты и короткую запись экрана; макет может не подтвердить, что продукт действительно работает.
- Свяжите переписку с коммерческими данными. Покажите сведения о заказе, статус доставки, состояние возврата или возмещения и то, как оператор использует эти данные во время разговора с покупателем.
- Подтвердите выбранный порог масштаба. Предоставьте данные о 1 000 авторизованных продавцах или отчётность, подтверждающую 1 миллион API-вызовов в день. Самостоятельно разработанному Seller-приложению стоит описать продавца, команду разработки и внутренний процесс поддержки, а не рассчитывать на автоматическое исключение.
- Запросите правильный custom scope. Согласно руководству по scope доступа, custom scope запрашивается через Partner Console → App & Service → Manage → Manage API. Проверьте, что для приложения включён
seller.customer_service. - Отдельно проверьте авторизацию продавца. Успешная проверка приложения ещё не означает получение seller token. Проверьте установку и авторизацию, сохраните идентификатор магазина и выданный scope и предусмотрите отзыв доступа.
- Перед отправкой снова проверьте официальную страницу. Правила для custom scope могут различаться по рынкам и типам аккаунтов и со временем меняться. В этой статье зафиксирована документация, доступная 18 июля 2026 года; окончательные требования к вашей заявке показывает Partner Center.
Определите, какой канал сообщений вам действительно нужен
| Ваша задача | Подходящий канал | Главное ограничение |
|---|---|---|
| Поддерживать покупателей TikTok Shop в существующем коммерческом helpdesk | TikTok Shop Customer Service API | Проверка custom scope, подтверждение готовности продукта и масштаба, авторизация продавцов |
| Отправлять разрешённые коммерческие сообщения подходящим прежним покупателям | TikTok Shop Customer Engagement API | Отдельные разрешения, критерии получателя, шаблоны и ограничения частоты |
| Экспортировать данные пользователя TikTok с его разрешения | TikTok Data Portability API | Проверка приложения, поддерживаемый регион, согласие пользователя и экспорт вместо живой переписки |
| Получать поддерживаемые входящие сообщения подключённого обычного аккаунта | Неофициальный интерфейс UnifyPort | Отдельное подключение аккаунта и операционная модель webhook; без привилегий TikTok Shop |
Примите это решение до написания кода. Если команде нужны связанные с заказами диалоги Shop, следует проходить официальный путь Customer Service API. Если нужен живой поток входящих сообщений обычного аккаунта, не стоит разрабатывать разделы Order и Fulfillment только для того, чтобы попытаться представить другой продукт соответствующим требованиям.
Роль UnifyPort
UnifyPort не предоставляет seller.customer_service, не одобряет приложения Partner Center, не авторизует магазины, не открывает данные заказов Seller Center и не подменяет официальные метрики операторов и обслуживания TikTok. Если эти коммерческие возможности обязательны, используйте официальный API.
UnifyPort предназначен для отдельного сценария со входящими сообщениями обычного аккаунта. Руководство по UnifyPort Exporter описывает передачу сессии TikTok при помощи браузера, после чего API доставляет поддерживаемый входящий трафик в стандартной оболочке webhook-события message.received. Гипотетическое входящее событие использует те же документированные поля, что и для других провайдеров:
{
"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": "Этот товар есть в наличии в Таиланде?",
"direction": "inbound",
"sent_at": "2026-07-18T03:14:24Z"
}
}
}Если для endpoint webhook задан signing_secret, проверяйте X-Device-Timestamp и X-Device-Signature по исходному телу запроса до сохранения события. Справочник стандартных типов событий и payload — самый подробный источник по этой оболочке; прежде чем полагаться на исходящие действия, проверьте актуальную документацию о возможностях конкретного провайдера.
Ограничения и компромиссы
Официальный путь TikTok Shop подходит лучше, если операторам нужны идентификатор покупателя Shop, связь с заказом, жизненный цикл диалога, разрешённые исходящие действия или встроенные операции обслуживания. В этой модели коммерческая авторизация и соблюдение правил платформы остаются внутри поддерживаемой системы TikTok.
Неофициальный интерфейс не поможет приложению соответствовать требованиям Customer Service API, не превратит обычные DM в диалоги Shop, не запустит официальные кампании для покупателей и не воспроизведёт данные Seller Center. Его более узкая задача — стандартный поток входящих событий для поддерживаемых подключённых аккаунтов. Храните сведения о заказах и доставке в своей системе только при наличии законного и надёжного источника этих данных.
Частые вопросы
Каковы требования для одобрения TikTok Shop Customer Service API?
Сейчас TikTok требует рабочее окно чата в приложении, видимые интеграции Order, Fulfillment и After-Sales, а также 1 000 авторизованных продавцов или 1 миллион API-вызовов в день. Приложение должно запросить custom scope Customer Service, после чего каждый продавец отдельно авторизует доступ.
Может ли один продавец TikTok Shop получить доступ к Customer Service API?
Возможно, но не автоматически. TikTok указывает, что самостоятельно разработанное приложение в категории TikTok Shop Seller может пройти специальное рассмотрение. Продавцу стоит предоставить сведения о команде разработки, рабочем чате, коммерческом контексте и предполагаемом процессе поддержки.
Customer Service API — это общий API для DM в TikTok?
Нет. Он охватывает диалоги службы поддержки между покупателями и продавцами TikTok Shop, но не открывает все личные сообщения автора или обычного аккаунта TikTok.
Отменяет ли одобрение приложения необходимость авторизации продавца?
Нет. Одобрение custom scope делает возможность доступной приложению, а авторизация продавца открывает этому приложению конкретный магазин. Необходимы оба этапа.
Что делать, если моё приложение не соответствует требованиям?
Точно определите задачу. Используйте Seller Center для официальной поддержки Shop, соберите недостающие подтверждения готовности продукта перед повторной заявкой или рассмотрите интерфейс входящих сообщений обычного аккаунта, если вам на самом деле не нужны идентификаторы, заказы и функции операторов, доступные только в Shop.
Следующий шаг
Если ваш продукт действительно обслуживает покупателей Shop, используйте официальный обзор Customer Service API как чек-лист заявки и подтвердите требования в своём Partner Center. Если задача связана с маршрутизацией входящих сообщений обычного аккаунта, перед выбором отдельного способа подключения изучите справочник стандартных webhook-событий UnifyPort.
Источники
Официальные источники TikTok проверены 18 июля 2026 года: