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.

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

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

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

При подключении 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; не создавайте новую отправку.

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

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

• Instagram
• Видео
• Картинки
• Настройки рабочего пространства
• Общие сведения об интеграциях