Как подключить аккаунт TikTok к API или ИИ-агенту
Аккаунт TikTok подключается к API или ИИ-агенту через экран авторизации TikTok: владелец входит в аккаунт и одобряет разрешения, которые запрашивает приложение, например публикацию постов, управление комментариями и чтение аналитики. TikTok возвращает код, который действует 10 минут и используется однократно. Приложение обменивает его на токен доступа к аккаунту и действует в рамках этих разрешений, пока владелец не отзовёт доступ.
easyCoexistence подключает личные и бизнес-аккаунты TikTok через собственный вход TikTok, из панели управления или по ссылке подключения, которую клиенты открывают сами, и затем передаёт Claude, ChatGPT или вашей платформе их инструменты: токены продлеваются, а каждый аккаунт проверяется круглосуточно.
Срок действия кода авторизации, который TikTok возвращает после одобрения; код обменивается только один раз.
Разрешение TikTok на ответы, лайки, скрытие и удаление комментариев; чтение комментариев требует отдельного разрешения.
Срок действия ссылки подключения easyCoexistence для аккаунта TikTok клиента до истечения сессии.
Бесплатный пробный период отсчитывается с первого подключения аккаунта; карта сохраняется до первого входа.
Что запрашивает экран авторизации TikTok?
Одобрение доступа приложения к аккаунту. Приложение отправляет владельца на URL авторизации владельца аккаунта TikTok, где показываются логотип приложения и запрашиваемые разрешения, например публикация постов, чтение и управление комментариями и чтение аналитики. После одобрения TikTok перенаправляет на зарегистрированный адрес приложения с кодом авторизации, который действует 10 минут и работает один раз; приложение обменивает его на токены аккаунта. Если владелец уже одобрял те же разрешения, TikTok пропускает страницу проверки и сразу возвращает обратно.
Зачем одобрять каждое разрешение?
Потому что токен доступа несёт только те права, которые одобрил владелец, а каждый эндпоинт Accounts API требует своего разрешения. В справочнике разрешений TikTok публикация относится к Video Publish, чтение комментариев к Get Business Comment, ответы, скрытие и удаление к Manage Business Comment, а публикации аккаунта и аналитика профиля имеют собственные разрешения. Вызов без нужного разрешения завершается ошибкой 40001, и исправить это может только владелец, повторно авторизовав приложение.
Как подключить аккаунт TikTok к easyCoexistence?
Из панели управления, в браузере, так как вход происходит на собственной странице TikTok. Выберите «New connection», затем TikTok, войдите в аккаунт и одобрите разрешения; вы вернётесь в панель управления с подключённым аккаунтом. Карта сохраняется до первого подключения, за первые 3 дня ничего не списывается, работают и личные, и бизнес-аккаунты. Весь вход нужно завершить в течение 10 минут после начала; по истечении начните заново с «New connection».
Что происходит после подключения аккаунта?
ИИ может его использовать. list_social_accounts возвращает аккаунт с account_id, идентификатором, который принимает каждый инструмент TikTok, и его статусом. События комментариев этого аккаунта начинают поступать в easyCoexistence, токен доступа, срок действия которого составляет сутки, продлевается до истечения, а аккаунт проверяется каждые 6 часов; если TikTok отказывает в доступе, вам приходит письмо. В панели управления появляется страница аккаунта с его состоянием, адресатом событий комментариев и инструкцией, как использовать его из вашего ИИ.
Как платформа подключает аккаунты TikTok своих клиентов?
Через ссылку подключения, которую клиент открывает без аккаунта easyCoexistence. Ваш бэкенд отправляет запрос на /connect-sessions с полем channel со значением tiktok и вашим redirect_url, затем отправляет клиента по url, который вернётся в ответе. Размещённая страница показывает одну кнопку «Continue with TikTok», которая открывает экран TikTok в той же вкладке, поэтому работает и на телефоне. Клиент возвращается на ваш redirect_url с channel_id; аккаунт принадлежит вашему аккаунту и оплачивается через него.
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "tiktok",
"redirect_url": "https://app.example.com/tiktok/connected",
"external_ref": "customer_1042"
}'
# 201 Created
# { "id": "cs_…", "url": "https://easycoexistence.com/connect/cs_…", "channel": "tiktok", "status": "created", … }Что делать, если вход не завершился?
Аккаунт считается подключённым, только когда экран TikTok одобрен и код обменян, поэтому неудачную попытку просто запускают заново:
- Владелец закрывает экран TikTok или отказывается: панель управления сообщает, что ничего не подключено, и «New connection» запускается заново.
- Прошло больше 10 минут: вход истекает, а клиент по ссылке подключения возвращается на размещённую страницу, чтобы попробовать снова.
- Аккаунт TikTok уже подключён к другому аккаунту easyCoexistence: сначала удалите его там, затем подключите здесь.
- Ссылка подключения истекла (действует час): создайте для клиента новую сессию.
Как настроить
- Open New connectionSign in to easyCoexistence, open the dashboard and choose New connection, then TikTok. An account with no card saved is asked for one first.
- Sign in on TikTokTikTok's page opens. Sign in with the TikTok account you want to connect.
- Approve the permissionsReview the permissions easyCoexistence asks for, approve each of them, and authorize.
- Back in the dashboardTikTok returns you to easyCoexistence, where the account shows as connected and your AI finds it with list_social_accounts.
Распространённые ошибки
- Оставить разрешение неодобренным на экране TikTok. Тогда в токене не будет этого разрешения, и соответствующие вызовы будут падать, пока владелец не авторизует приложение заново.
- Отправить клиенту ссылку на панель управления. Клиенты подключаются по ссылке подключения из вашего бэкенда: она не требует аккаунта easyCoexistence и возвращает их в ваше приложение.
- Ждать, что ИИ войдёт в аккаунт из чата. Авторизация TikTok требует браузера, поэтому get_social_connect_link возвращает ссылку на панель управления и инструкцию.
От US$ 9 за подключение в месяц до US$ 0,75 по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Нужен ли бизнес-аккаунт TikTok для подключения?
Нет. Подключаются и личные, и бизнес-аккаунты, а некоторым полям аналитики нужен Advanced Access или верифицированный бизнес-аккаунт.
Могут ли Claude или ChatGPT подключить аккаунт за меня?
Они могут передать вам ссылку. get_social_connect_link возвращает адрес панели управления и инструкцию, так как вход в TikTok должен происходить в браузере.
easyCoexistence видит мой пароль от TikTok?
Нет. Вы входите на собственной странице TikTok, и TikTok передаёт easyCoexistence код авторизации, а не ваш пароль.
Может ли клиент подключить аккаунт с телефона?
Да. Кнопка TikTok на ссылке подключения открывает вход в TikTok в той же вкладке, и это работает на телефоне.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на