MaviBot имеет интеграцию с TikTok — одной из самых динамичных и популярных социальных платформ в мире. Это открывает новую главу для нашей экосистемы. TikTok, где миллионы пользователей взаимодействуют ежедневно, является эпицентром современного общения, трендов и новых интерактивных форматов. Эта интеграция позволяет бизнесу и проектам выйти на новый уровень связи с молодой аудиторией.
Мы рассмотрим технические аспекты процесса:
- шаги, необходимые для активации интеграции
- доступные обратные вызовы
- разрешения, которые необходимо предоставить
Кроме того, мы уделим особое внимание нюансам региональной доступности.
Важно отметить, что интеграция TikTok доступна не во всех странах и зависит от конкретных экономических зон, где платформа официально поддерживает эти функции. Мы расскажем, где её можно настроить сразу, а где могут действовать ограничения.
API обмена сообщениями TikTok в настоящее время находится в открытом бета-тестировании в Азиатско-Тихоокеанском регионе, Латинской Америке, на Ближнем Востоке, в Африке (METAP) и Северной Америке (за исключением США). Подключенная учетная запись должна быть зарегистрирована в одном из этих регионов.
Если пользователь из США, Европейской экономической зоны (ЕЭЗ), Швейцарии или Великобритании отправляет сообщение, оно не будет получено из-за ограничений TikTok.
Обратите внимание!
Чтобы создать и настроить чат-бота для TikTok, обратитесь к разделу «Как создать чат-бота для бизнеса».
Спецификации кнопок TikTok описаны здесь.
Интеграция TikTok с MaviBot — это не просто техническое обновление, а возможность быть на передовой общения с аудиторией, использовать самый горячий канал для продвижения и вовлекать пользователей там, где они проводят своё время.
Как подготовить аккаунт к интеграции
Начнем с самого важного шага — правильной настройки подключения.
Перед подключением аккаунта необходимо переключиться на бизнес-аккаунт.
Шаг 1: Перейдите в раздел «Настройки и конфиденциальность».
Шаг 2: Затем перейдите в раздел «Аккаунт».
Шаг 3: Нажмите «Переключиться на бизнес-аккаунт».
Шаг 4: Заполните данные о вашем бизнесе.
Готово! Ваш аккаунт теперь готов к подключению к MaviBot.
Как подключить аккаунт к MaviBot
Перейдите в раздел «Мессенджеры» и нажмите кнопку TikTok.
Затем войдите в свою учетную запись TikTok в появившемся окне.
И предоставьте MaviBot доступ к вашему аккаунту.
Важно!
Мы настоятельно рекомендуем предоставить доступ к комментариям, сообщениям, информации профиля и возможности просматривать ваши видео. Бот и его обратные вызовы могут просто не работать без этих разрешений.
Все остальные разрешения вы можете оставить или отклонить по своему усмотрению.
Если впоследствии вы отзовете какие-либо разрешения, необходимые для корректной работы чат-бота, вы сможете повторно включить их только в настройках самого TikTok.
Затем вы будете автоматически перенаправлены в раздел «Мессенджеры» в MaviBot, где увидите уведомление, подтверждающее успешную интеграцию.
Особенности TikTok
- Чтобы иметь возможность отправлять сообщения пользователю, он должен первым начать чат.
- Вы можете отправить до 10 сообщений в течение 48 часов после получения сообщения от пользователя TikTok.
&#xNAN;Пример: Если вы получили одно сообщение от пользователя, вы можете отправить до 10 сообщений в течение следующих 48 часов. Если тот же пользователь позже отправит еще одно сообщение, начнется новый 48-часовой период, позволяющий отправить еще 10 сообщений этому пользователю. - Сообщение не может одновременно содержать текст и изображение.
- Отправка и получение вложений с изображениями через API доступны только в том случае, если и отправитель, и получатель находятся в странах, поддерживающих изображения в личных сообщениях. Обмен изображениями доступен не во всех странах.
- Максимальный размер вложения с изображением — 3 мегабайта.
- Одно сообщение может содержать только одно вложение.
Обратные вызовы
tiktok_client_new_comment <video_id>: <comment_text> — пользователь оставил комментарий к вашему видео.
tiktok_client_share_post <shared_video_id> <url> — пользователь отправил видео в личные сообщения подключенного аккаунта.
Сохраняемые переменные клиента
tiktok_comment_id — идентификатор комментария. Сохраняется, когда пользователь комментирует ваше видео, и используется для ответа на этот комментарий.
tiktok_comment_video_id — идентификатор видео, к которому оставлен комментарий. Сохраняется, когда пользователь комментирует ваше видео, и используется для ответа на комментарий.
tiktok_is_follower — принимает значение True, если пользователь подписан на ваш аккаунт.
tiktok_conversation_id — идентификатор чата. Генерируется после того, как пользователь отправляет сообщение в чате. Требуется для отправки сообщений; не удаляйте!
Кнопки
Максимальное количество кнопок в одном сообщении — 3.
TikTok поддерживает два типа кнопок: callback и «стандартные» (URL). Однако одно сообщение может содержать кнопки только одного типа.
Пример 1.
Пример 2.
Результат
Обратите внимание!
Сообщения с кнопками недоступны в десктопной версии TikTok. В десктопном чате вы увидите такое уведомление:
Однако в мобильном приложении сообщение будет отображаться корректно:
Текст, отображаемый на кнопке, и текст, отправляемый боту при нажатии, идентичны. Кнопка генерируется на основе данных из поля «Текст ответного сообщения» или «URL» в настройках кнопки.
- Кнопки обратного вызова отображаются как обычные кнопки. При нажатии они отправляют в чат от имени пользователя сообщение, содержащее текст кнопки. Максимальная длина — 20 символов.
- URL-кнопки отображаются как ссылки. Однако их поведение такое же, как у кнопок обратного вызова. В настоящее время TikTok не поддерживает создание кнопок, открывающих веб-страницу по указанному URL при нажатии. Максимальная длина — 40 символов.
Узнайте больше об использовании кнопок обратного вызова в MaviBot здесь.
Функции
Как ответить на комментарий:
tiktok_create_comment(text, comment_video_id, comment_id) — публикует ответ на указанный комментарий.