Платформа

TikTok

Подключение аккаунта, публикация роликов и передача черновиков в TikTok.

8 мин чтения

TikTok

Приложение TikTok подключает аккаунт к рабочему пространству Promto. Агент читает профиль и доступные сведения о роликах, отправляет видео или фотографии через Content Posting API и отслеживает состояние публикации. Токены остаются на сервере и не передаются агенту.

Назначение

TikTok подходит для следующих задач:

получить имя, описание и ссылку на профиль;
посмотреть количество подписчиков, подписок, отметок «Нравится» и роликов;
получить список видео и доступные для них счётчики просмотров, реакций, комментариев и репостов;
отправить видео или фотографии через Direct Post;
передать материал в черновики TikTok для проверки и публикации внутри приложения;
проверить состояние уже запущенной отправки.

Интеграция не управляет комментариями и модерацией и не получает retention, watch-time, демографию аудитории или другие поля, которых нет в ответе TikTok API.

Подключение

Перед подключением подготовьте приложение в TikTok for Developers, аккаунт TikTok и токены с правами для нужных задач:

user.info.basic, user.info.profile и user.info.stats — профиль и счётчики аккаунта;
video.list — список и сведения о роликах;
video.publish — Direct Post;
video.upload — отправка в черновики.

Для публикации по URL домен с медиафайлами должен быть подтверждён в настройках приложения TikTok.

Откройте TikTok → Настройки.
Вставьте действующий Access token.
Если нужно автоматическое обновление, заполните сразу все три поля: Client Key, Client Secret и Refresh token. Частичный набор сохранить нельзя.
Отметьте Приложение прошло ревью Content Posting API только если TikTok действительно одобрил ваше приложение.
Выберите видимость:

Личная — подключением пользуется только создавший его пользователь;
Организация — подключение доступно участникам выбранной организации.

Нажмите Проверить и подключить.
Включите Разрешить агенту читать профиль, доступную статистику и видео.

При подключении Promto проверяет профиль, доступ к списку видео и creator_info. Access token обычно действует до 24 часов, но у вставленного вручную токена фактический остаток может быть меньше. Refresh token действует до 365 дней; автоматическое обновление возможно только с полным набором Client Key, Client Secret и Refresh token.

Токены и Client Secret хранятся в зашифрованном виде. Они не возвращаются в интерфейс, рабочее окружение агента или поддержку.

Интерфейс

На странице Главная находятся карточка подключения и три готовых сценария:

Опубликовать видео или фото — подготовить Direct Post;
Отправить в черновики — создать Inbox Draft;
Профиль и доступная статистика — прочитать профиль и доступные поля роликов.

Нажатие на сценарий прикрепляет подготовленный запрос к чату с агентом. Само нажатие ничего не отправляет в TikTok.

На странице Настройки отображаются:

подключённый профиль и ссылка на него;
видимость подключения и Open ID;
отмеченное состояние ревью Content Posting API;
срок Access token и наличие полного набора для обновления;
выданные права;
состояние инструментов и доступ агента;
кнопки обновления подключения и отключения TikTok.

Отключение удаляет сохранённое подключение из Promto. При необходимости дополнительно отзовите доступ в настройках TikTok.

Возможности агента

Основной агент использует инструмент promto_tiktok. В терминальной сессии доступен его аналог promto tiktok <действие>.

Задача	Действия
Профиль	`get_profile`
Видео	`list_videos`, `get_videos`
Ограничения аккаунта	`get_creator_info`
Direct Post	`publish_video`, `publish_photos`
Черновики	`upload_video_draft`, `upload_photo_draft`
Состояние отправки	`get_publish_status`

Перед Direct Post агент заново вызывает get_creator_info. Ответ определяет доступные значения privacy_level, максимальную длительность видео и возможность комментариев, Duet и Stitch. Значение приватности выбираете вы: агент не подставляет его по умолчанию.

Для Direct Post также нужны:

явное подтверждение правил использования музыки;
указание, является ли материал коммерческим, продвигает собственный бренд или содержит branded content;
отдельные значения для комментариев, Duet и Stitch у видео;
признак is_aigc для видео;
настройка автоматического добавления музыки для публикации фотографий.

У Photo Post нет параметра is_aigc. Branded content нельзя отправить с приватностью SELF_ONLY.

Все четыре действия отправки требуют отдельного согласия пользователя и confirm=true. После запуска агент сохраняет publish_id и проверяет его через get_publish_status.

Примеры чтения в терминале:

promto tiktok get_profile
promto tiktok list_videos --params-json '{"max_count": 20}'
promto tiktok get_creator_info
promto tiktok get_publish_status --params-json '{"publish_id": "<publish-id>"}'

Для отправки терминальная команда дополнительно принимает --confirm, но использовать его можно только после проверки материала и явного согласия пользователя.

Сценарии

Опубликовать видео или фотографии

Передайте агенту публичную HTTPS-ссылку на видео или от одной до 35 ссылок на фотографии. Агент получает свежий creator_info, уточняет приватность, взаимодействия, коммерческое раскрытие, музыку и признак AI-контента для видео, затем показывает итоговые параметры. После подтверждения он запускает отправку и проверяет publish_id.

Отправить материал в черновики

Для видео достаточно публичного URL; для фотографий можно дополнительно указать заголовок, описание и индекс обложки. Агент показывает точные файлы и параметры и только после подтверждения создаёт Inbox Draft. Дальнейшую проверку и публикацию выполните в TikTok.

Собрать доступную статистику

Попросите агента получить профиль и список роликов. Он вернёт только поля API: общие счётчики аккаунта и доступные показатели видео. Отсутствующие retention, watch-time или демографию он не будет заменять предположениями.

Ограничения и безопасность

Медиа передаются только по публичным https://-ссылкам на подтверждённом домене. Локальный путь, localhost, приватный IP, URL с логином и паролем, нестандартным портом или фрагментом не принимается.
Агент не загружает локальный файл напрямую. Сначала готовому файлу нужен публичный URL.
За одну публикацию фотографий принимается от 1 до 35 URL; индекс обложки должен указывать на один из них.
Список и запрос по ID обрабатывают не более 20 видео за один вызов; длинный список читается постранично по курсору.
Длительность видео не может превышать значение из свежего creator_info. Время обложки должно находиться внутри ролика.
Комментарии, Duet и Stitch остаются выключенными, пока пользователь явно не включит доступный вариант.
Публикация выполняется асинхронно. Пока статус не завершён, нельзя повторно отправлять тот же материал: это может создать дубль.
Если во время записи произошёл тайм-аут или TikTok был недоступен, результат считается неизвестным. Сначала проверьте аккаунт и состояние по publish_id, затем решайте, нужен ли повтор.
Личное подключение нельзя использовать агентом в общем рабочем пространстве с другими участниками. Для совместной работы используйте организационную видимость.
Доступ агента можно выключить отдельно от подключения. Старая сессия или возможность агента перестаёт работать после переподключения, смены проекта или отключения.
Все операции журналируются, а provider-ответы ограничены по размеру. При ограничении частоты запросов дождитесь указанного времени.

Если что-то не работает

Подключение отклонено. Проверьте срок Access token и права user.info.basic, user.info.profile, user.info.stats, video.list и video.publish. Для черновиков отдельно нужен video.upload.

Автоматическое обновление не включается. Заполните Client Key, Client Secret и Refresh token одновременно. Если одного значения нет, оставьте все три поля пустыми и обновляйте подключение вручную.

Токен истёк или был отозван. Откройте Настройки → Подключить заново и сохраните новый набор. Не отправляйте токены агенту или в чат поддержки.

TikTok не принимает URL. Убедитесь, что файл доступен без авторизации по HTTPS и его домен подтверждён в TikTok Developer Portal.

Приватность отклонена. Получите свежий creator_info и выберите одно из фактически возвращённых значений. Не используйте старый список и не подставляйте значение по умолчанию.

Комментарии, Duet или Stitch недоступны. Эти возможности могут быть выключены в настройках автора или не разрешены для текущей публикации. Оставьте соответствующий параметр выключенным.

Direct Post принимает только SELF_ONLY. Проверьте фактическое состояние ревью Content Posting API, тип аккаунта и список тестовых пользователей. Не отмечайте прохождение ревью без одобрения TikTok.

Черновик не создаётся. Проверьте право video.upload и публичность URL. Черновик тоже является изменяющей операцией и требует подтверждения.

Статус долго остаётся незавершённым. Повторяйте только get_publish_status с тем же publish_id; не создавайте новую отправку.

Агент сообщает, что личное подключение недоступно в общем проекте. Переключите подключение на видимость Организация через пользователя с правами управления рабочим пространством.

Связанные материалы

← Документация

Платформа

TikTok

Подключение аккаунта, публикация роликов и передача черновиков в TikTok.

8 мин чтения

TikTok

Назначение

TikTok подходит для следующих задач:

получить имя, описание и ссылку на профиль;
посмотреть количество подписчиков, подписок, отметок «Нравится» и роликов;
получить список видео и доступные для них счётчики просмотров, реакций, комментариев и репостов;
отправить видео или фотографии через Direct Post;
передать материал в черновики TikTok для проверки и публикации внутри приложения;
проверить состояние уже запущенной отправки.

Подключение

Перед подключением подготовьте приложение в TikTok for Developers, аккаунт TikTok и токены с правами для нужных задач:

user.info.basic, user.info.profile и user.info.stats — профиль и счётчики аккаунта;
video.list — список и сведения о роликах;
video.publish — Direct Post;
video.upload — отправка в черновики.

Для публикации по URL домен с медиафайлами должен быть подтверждён в настройках приложения TikTok.

Откройте TikTok → Настройки.
Вставьте действующий Access token.
Если нужно автоматическое обновление, заполните сразу все три поля: Client Key, Client Secret и Refresh token. Частичный набор сохранить нельзя.
Отметьте Приложение прошло ревью Content Posting API только если TikTok действительно одобрил ваше приложение.
Выберите видимость:

Личная — подключением пользуется только создавший его пользователь;
Организация — подключение доступно участникам выбранной организации.

Нажмите Проверить и подключить.
Включите Разрешить агенту читать профиль, доступную статистику и видео.

Интерфейс

На странице Главная находятся карточка подключения и три готовых сценария:

Опубликовать видео или фото — подготовить Direct Post;
Отправить в черновики — создать Inbox Draft;
Профиль и доступная статистика — прочитать профиль и доступные поля роликов.

На странице Настройки отображаются:

подключённый профиль и ссылка на него;
видимость подключения и Open ID;
отмеченное состояние ревью Content Posting API;
срок Access token и наличие полного набора для обновления;
выданные права;
состояние инструментов и доступ агента;
кнопки обновления подключения и отключения TikTok.

Возможности агента

Основной агент использует инструмент promto_tiktok. В терминальной сессии доступен его аналог promto tiktok <действие>.

Задача	Действия
Профиль	`get_profile`
Видео	`list_videos`, `get_videos`
Ограничения аккаунта	`get_creator_info`
Direct Post	`publish_video`, `publish_photos`
Черновики	`upload_video_draft`, `upload_photo_draft`
Состояние отправки	`get_publish_status`

Для Direct Post также нужны:

явное подтверждение правил использования музыки;
указание, является ли материал коммерческим, продвигает собственный бренд или содержит branded content;
отдельные значения для комментариев, Duet и Stitch у видео;
признак is_aigc для видео;
настройка автоматического добавления музыки для публикации фотографий.

У Photo Post нет параметра is_aigc. Branded content нельзя отправить с приватностью SELF_ONLY.

Примеры чтения в терминале:

promto tiktok get_profile
promto tiktok list_videos --params-json '{"max_count": 20}'
promto tiktok get_creator_info
promto tiktok get_publish_status --params-json '{"publish_id": "<publish-id>"}'

Сценарии

Опубликовать видео или фотографии

Отправить материал в черновики

Собрать доступную статистику

Ограничения и безопасность

Медиа передаются только по публичным https://-ссылкам на подтверждённом домене. Локальный путь, localhost, приватный IP, URL с логином и паролем, нестандартным портом или фрагментом не принимается.
Агент не загружает локальный файл напрямую. Сначала готовому файлу нужен публичный URL.
За одну публикацию фотографий принимается от 1 до 35 URL; индекс обложки должен указывать на один из них.
Список и запрос по ID обрабатывают не более 20 видео за один вызов; длинный список читается постранично по курсору.
Длительность видео не может превышать значение из свежего creator_info. Время обложки должно находиться внутри ролика.
Комментарии, Duet и Stitch остаются выключенными, пока пользователь явно не включит доступный вариант.
Публикация выполняется асинхронно. Пока статус не завершён, нельзя повторно отправлять тот же материал: это может создать дубль.
Если во время записи произошёл тайм-аут или TikTok был недоступен, результат считается неизвестным. Сначала проверьте аккаунт и состояние по publish_id, затем решайте, нужен ли повтор.
Личное подключение нельзя использовать агентом в общем рабочем пространстве с другими участниками. Для совместной работы используйте организационную видимость.
Доступ агента можно выключить отдельно от подключения. Старая сессия или возможность агента перестаёт работать после переподключения, смены проекта или отключения.
Все операции журналируются, а provider-ответы ограничены по размеру. При ограничении частоты запросов дождитесь указанного времени.