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. |