MaviBot интегрируется с TikTok — одной из самых быстрорастущих и популярных социальных платформ в мире.
Эта интеграция открывает новую главу для экосистемы MaviBot. TikTok, где ежедневно взаимодействуют миллионы пользователей, стал центром современного общения, трендов и новых интерактивных форматов. Теперь бизнес может охватить молодую аудиторию через одну из самых вовлекающих платформ в мире.
В этой статье вы узнаете:
- как активировать интеграцию;
- какие колбэки доступны;
- какие разрешения необходимо предоставить.
Мы также рассмотрим региональную доступность и её ограничения.
Важно
Интеграция с TikTok доступна не во всех странах.
TikTok Messaging API в настоящее время доступен в открытой бета-версии только в:
- Азиатско-Тихоокеанском регионе (APAC);
- Латинской Америке;
- на Ближнем Востоке;
- в Африке (METAP);
- Северной Америке (за исключением США).
Подключенная учетная запись TikTok должна быть зарегистрирована в одном из этих регионов.
Сообщения, отправленные пользователями из США, Европейской экономической зоны (ЕЭЗ), Швейцарии или Великобритании, не могут быть получены из-за ограничений платформы TikTok.
Для получения дополнительной информации обратитесь к официальной документации TikTok:
https://business-api.tiktok.com/portal/docs?id=1832184145137922
Обратите внимание
Перед созданием чат-бота для TikTok ознакомьтесь с разделом Как создать чат-бота для бизнеса.
Ограничения кнопок TikTok описаны в разделе Кнопки ниже.
Интеграция TikTok с MaviBot — это больше, чем просто еще один канал; это возможность общаться с пользователями там, где они проводят больше всего времени, и выстраивать высоко вовлекающие взаимодействия с клиентами.
Подготовьте свою учетную запись TikTok
Перед подключением учетной записи к MaviBot переключите её на Бизнес-аккаунт.
Шаг 1
Откройте Настройки и конфиденциальность.
Шаг 2
Откройте раздел Аккаунт.
Шаг 3
Выберите Переключиться на бизнес-аккаунт.
Шаг 4
Заполните свой бизнес-профиль.
Готово! Ваша учетная запись теперь готова к подключению к MaviBot.
Подключите свою учетную запись TikTok
Откройте раздел Мессенджеры в MaviBot и нажмите TikTok.
Войдите в свою учетную запись TikTok.
Предоставьте MaviBot доступ к вашей учетной записи.
Важно
Мы настоятельно рекомендуем предоставить разрешение на:
- чтение и управление сообщениями;
- доступ к комментариям;
- доступ к информации профиля;
- просмотр видео.
Без этих разрешений чат-бот и некоторые колбэки могут работать некорректно.
Вы можете отказать в любых других разрешениях, если они вам не нужны.
Если впоследствии вы отзовете какие-либо необходимые разрешения, вы сможете повторно включить их только в настройках своей учетной записи TikTok.
После авторизации вы будете перенаправлены обратно в раздел Мессенджеры, где MaviBot отобразит подтверждение успешной интеграции.
Ограничения TikTok
- Пользователь должен начать разговор, прежде чем бот сможет отправлять сообщения.
- Вы можете отправить до 10 сообщений в течение 48 часов после получения сообщения от пользователя.
- Пример: если пользователь отправляет вам одно сообщение, вы можете отправить до 10 ответов в течение следующих 48 часов. Если пользователь позже отправит другое сообщение, начнется новый 48-часовой период с новым лимитом в 10 исходящих сообщений.
- Одно сообщение не может содержать одновременно текст и изображение.
- Вложения изображений поддерживаются, только если и отправитель, и получатель находятся в странах, где TikTok разрешает обмен изображениями в личных сообщениях.
- Максимальный размер изображения — 3 МБ.
- В одно сообщение можно включить только одно вложение.
Колбэки
Новый комментарий
tiktok_client_new_comment <video_id>: <comment_text>
Срабатывает, когда пользователь оставляет комментарий к одному из ваших видео.
Отправленное видео
tiktok_client_share_post <shared_video_id> <url>
Срабатывает, когда пользователь отправляет видео TikTok в личные сообщения подключенной учетной записи.
Переменные клиента
tiktok_comment_id
Хранит ID комментария.
Автоматически заполняется, когда пользователь комментирует ваше видео, и используется при ответе на этот комментарий.
tiktok_comment_video_id
Хранит ID видео, на которое был оставлен комментарий.
Автоматически заполняется, когда пользователь комментирует ваше видео.
tiktok_is_follower
Возвращает True, если пользователь подписан на вашу учетную запись TikTok.
tiktok_conversation_id
Хранит ID беседы.
Создается автоматически после того, как пользователь отправляет первое личное сообщение.
Важно
Не удаляйте эту переменную.
Она необходима для отправки сообщений пользователю.
Кнопки
Сообщение TikTok может содержать до трех кнопок.
TikTok поддерживает два типа кнопок:
- Кнопки обратного вызова
- Кнопки URL
Важно
Одно сообщение может содержать кнопки только одного типа.
Пример 1
Пример 2
Результат
Обратите внимание
Сообщения с кнопками не поддерживаются в TikTok Desktop.
Пользователи настольной версии увидят следующее уведомление:
В мобильном приложении сообщение отображается корректно.
Текст, отображаемый на кнопке, идентичен тексту, который отправляется обратно боту после её нажатия.
Текст кнопки берется из поля Текст ответного сообщения или поля URL в настройках кнопки.
Кнопки обратного вызова
Отображаются как обычные кнопки.
При нажатии TikTok отправляет боту сообщение от имени пользователя, содержащее текст кнопки.
Максимальная длина: 20 символов.
Кнопки URL
Отображаются как ссылки.
В настоящее время TikTok не поддерживает открытие веб-страниц при нажатии кнопок URL.
Вместо этого нажатие кнопки отправляет её текст боту, как и кнопка обратного вызова.
Максимальная длина: 40 символов.
Узнайте больше о кнопках обратного вызова.
Функции
Ответить на комментарий
tiktok_create_comment(text, comment_video_id, comment_id)
Публикует ответ на комментарий в TikTok.
| Параметр | Описание |
|---|---|
| text | Обязательный. Текст ответа. |
| comment_video_id | ID видео, содержащего комментарий. Необязательный. Если опущен, используется значение переменной клиента tiktok_comment_video_id. |
| comment_id | ID комментария, на который нужно ответить. Необязательный. Если опущен, используется значение переменной клиента tiktok_comment_id. |