# TikTok

Управление видео, аналитика аккаунта и взаимодействие с аудиторией

## Сценарии

### Публикация ролика
Агент выложит готовое видео по ссылке или загрузит файл частями, а затем дождётся статуса публикации вместо вас.

### Черновик в inbox автора
Агент отправит ролик в inbox аккаунта черновиком, чтобы вы дописали подпись и опубликовали его вручную из приложения.

### Статистика последних видео
Агент соберёт просмотры, лайки, комментарии и репосты по последним роликам и покажет, какой формат собирает отклик.

### Проверка ограничений аккаунта
Агент запросит creator info перед публикацией и скажет, какие уровни приватности и настройки комментариев доступны этому аккаунту.

## Как подключить

### Создайте приложение на developers.tiktok.com
Войдите под тем аккаунтом, чьи ролики нужно вести, откройте меню профиля → «Manage apps» → «Connect an app». Владельцем выбирайте организацию, а не личный профиль: заявку на ревью от организации рассматривают.

### Добавьте продукты и отметьте нужные scope
Кнопка «Add products» → Login Kit и Content Posting API, в его настройках включите Direct Post. В разделе «Scopes» отметьте video.publish, video.list, user.info.basic и user.info.stats: без video.publish проверка подключения падает.

### Задайте redirect URI и отправьте на ревью
Redirect URI регистрируется в настройках Login Kit и при обмене кода должен совпасть посимвольно. Отправьте приложение на ревью: статус идёт Draft → In review → Live, а у неаудированного клиента все посты видны только автору (SELF_ONLY).

### Скопируйте Client key и Client secret
Оба значения лежат в App details, раздел «Credentials». Client secret показывается там же — храните его отдельно: пара ключей нужна, чтобы обновлять токен без повторной авторизации аккаунта.

### Авторизуйте аккаунт и получите access token
Пройдите авторизацию по своему redirect URI и обменяйте полученный code на токен на https://open.tiktokapis.com/v2/oauth/token/. Нужный вам user access token начинается с act. и живёт 24 часа, refresh token — 365 дней.

## Частые вопросы

### Как подключить TikTok?
Токеном доступа аккаунта. Создайте приложение на developers.tiktok.com, добавьте Content Posting API и Login Kit, отметьте scope video.publish, video.list и user.info, авторизуйте аккаунт и обменяйте код на токен.

### Что агент видит в TikTok?
Профиль авторизованного аккаунта со статистикой, список последних роликов и их метрики, детали видео по ID и ограничения публикации для этого автора.

### Пишет ли агент в TikTok?
Да: публикует видео по ссылке или загрузкой файла, собирает фото-посты и отправляет черновики в inbox автора. Опубликованное он не удаляет.

### Почему пост виден только мне?
Пока приложение не прошло ревью TikTok, все посты неаудированного клиента публикуются с приватностью SELF_ONLY. После перевода в статус Live ограничение снимается.

[Открыть TikTok](https://developers.tiktok.com)
