Личные сообщения TikTok через API
API Business Messaging от TikTok позволяет одобренному приложению разработчика отправлять и получать личные сообщения для аккаунтов TikTok с Advanced Access или Verified Business Accounts: текст, изображения и карточки вопросов и ответов. Входящие сообщения приходят через вебхук, также доступны автоматические приветственные сообщения и предлагаемые вопросы. Для доступа нужна проверка TikTok по безопасности данных. Функция не работает для аккаунтов, зарегистрированных в Европейской экономической зоне, Швейцарии и Великобритании.
easyCoexistence подключает аккаунты TikTok через API for Business TikTok, поэтому Claude, ChatGPT или собственная платформа отвечает на комментарии публично, запускает правила комментариев и ИИ-ответы и пересылает события комментариев на ваш эндпоинт.
Самый низкий уровень аккаунта, который поддерживает API Business Messaging: подходят также Verified Business Accounts, а обычные аккаунты TikTok не подходят.
Максимальное количество сообщений, которое бизнес может отправить пользователю, не являющемуся взаимным подписчиком, за 48 часов после его первого сообщения, до ответа.
Вьетнам, Индонезия и Таиланд, где аккаунт должен быть зарегистрирован для использования Comment-to-Message.
Срок, в течение которого TikTok начинает проверку безопасности и конфиденциальности данных после того, как разработчик отправит форму заявки.
Что делает API Business Messaging от TikTok?
Он позволяет аккаунту TikTok обмениваться личными сообщениями с пользователями TikTok через платформу, которая интегрирует API. Сообщение пользователя приходит через вебхук с conversation_id, а бизнес отвечает через /business/message/send/: текстом, изображением, опубликованным постом TikTok или карточкой вопросов и ответов, кнопки которой отправляют ответ пользователя. Также можно показать индикатор набора текста, отметить сообщения как прочитанные, получить список до 100 диалогов и прочитать в одном из них 20 последних сообщений.
Какие аккаунты и регионы могут его использовать?
Аккаунты с Advanced Access или Verified Business Accounts; обычные аккаунты TikTok получают доступ только после перехода на другой тип. Регион определяется местом регистрации аккаунта:
- Европейская экономическая зона, Швейцария и Великобритания: недоступно для аккаунтов, зарегистрированных там. Сообщение от пользователя оттуда попадает в вебхук только как уведомление, без текста.
- США: только для разработчиков, прошедших проверку безопасности данных TikTok для США и подписавших USDS Addendum, помимо общей проверки.
- Остальной мир: разработчики, прошедшие проверку безопасности и конфиденциальности данных TikTok.
- Некоторые функции зависят от региона, например отправка изображений работает только там, где её поддерживают страны обеих сторон.
Что нужно разработчику для доступа?
Одобренное приложение разработчика в API for Business TikTok, затем отдельная проверка. Разработчик отправляет форму заявки TikTok; в течение 10 рабочих дней TikTok начинает проверку безопасности и конфиденциальности данных, направляя опросник due diligence. Для доступа в США добавляется второй опросник от TikTok U.S. Data Security. Затем каждый аккаунт авторизует приложение, одобряя разрешения на чтение, отправку и управление сообщениями, а также на чтение типа аккаунта.
Какие ограничения действуют на сообщения?
TikTok запрещает начинать диалог: бизнес может писать только тем пользователям, которые написали ему первыми. В диалогах с пользователями, не являющимися взаимными подписчиками, объём также ограничен:
- После первого сообщения пользователя: до 10 сообщений в течение следующих 48 часов.
- После каждого ответа пользователя: без ограничений в течение 48 часов.
- Прошло больше 48 часов с последнего ответа пользователя: ещё три сообщения, до тех пор пока пользователь снова не напишет.
Что такое автоматические сообщения и Comment-to-Message?
Автоматические сообщения также настраиваются через API: приветственное сообщение, когда пользователь начинает чат, предлагаемые вопросы с ответами, подсказки для чата, приглашающие к диалогу, и сообщение новым подписчикам. Comment-to-Message позволяет бизнесу ответить личным сообщением, когда TikTok отмечает комментарий к его видео как комментарий с высоким намерением, то есть с сильным желанием купить или узнать больше. Функция доступна только аккаунтам, зарегистрированным во Вьетнаме, Индонезии и Таиланде; после включения аккаунт отвечает комментаторам, зарегистрированным в APAC, LATAM и METAP.
Может ли easyCoexistence отвечать на личные сообщения TikTok?
Пока нет. Подключение easyCoexistence к TikTok работает через Accounts API TikTok, а API сообщений TikTok требует отдельного одобрения, которое easyCoexistence запросил. Пока оно не получено, send_social_dm отказывает аккаунту TikTok, правила для комментариев TikTok отвечают только публично, а в автоматизациях TikTok нет шагов с личными сообщениями.
Как сегодня работают диалоги в TikTok через easyCoexistence?
В комментариях, публично. ИИ-ассистент читает комментарии к видео через list_social_comments и отвечает под ними через reply_to_comment; правила комментариев сами отвечают на комментарии с ключевыми словами, а автоматизации могут написать ответ с помощью ИИ, до 150 символов. Каждое событие комментария также можно переслать с подписью на ваш эндпоинт через set_social_webhook_destination.
Распространённые ошибки
- Добавление США в заявку, которой они не нужны. TikTok отмечает, что проверка безопасности данных для США может затянуть одобрение, а доступ для США можно добавить позже.
- Открытие тикетов поддержки, чтобы ускорить проверку. Тикеты для разработчиков TikTok предназначены для технических вопросов, а проверки нельзя отследить в портале разработчика.
- Использование Business Messaging API для чатов TikTok Shop. TikTok Shop Messaging является отдельной системой, которой API не управляет.
- Хранение media_id изображения на потом. Идентификатор загруженного изображения действует 30 дней, после чего изображение нужно загрузить заново.
За каждым подключением ведётся наблюдение круглосуточно. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
У TikTok есть API для личных сообщений?
Да. API Business Messaging отправляет и получает личные сообщения для аккаунтов с Advanced Access или Verified Business Accounts, для разработчиков, которых TikTok проверил.
Сколько занимает доступ к API Business Messaging от TikTok?
TikTok начинает проверку безопасности и конфиденциальности данных в течение 10 рабочих дней после формы заявки, с опросником due diligence. Для доступа в США добавляется второй опросник, который может затянуть одобрение. Проверки нельзя отследить в портале разработчика.
Может ли бизнес в TikTok написать тому, кто не писал первым?
Нет. TikTok запрещает начинать диалог или писать пользователю, который не начал диалог с бизнесом.
Доступен ли API сообщений TikTok в Европе?
Нет, не для аккаунтов, зарегистрированных в Европейской экономической зоне, Швейцарии или Великобритании. Их сообщения также нельзя читать через API или вебхуки.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на