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