Як створити чатбота для TikTok
MaviBot має інтеграцію з TikTok — однією з найдинамічніших і найпопулярніших соціальних платформ у світі. Це відкриває нову главу для нашої екосистеми. TikTok, де мільйони користувачів взаємодіють щодня, є епіцентром сучасної комунікації, трендів і нових інтерактивних форматів. Ця інтеграція дозволяє бізнесам і проєктам вийти на зовсім новий рівень взаємодії з молодшою аудиторією.
Ми розглянемо технічні аспекти процесу:
кроки, необхідні для активації інтеграції
доступні callback-и
дозволи, які потрібно надати
Крім того, ми окремо зосередимося на нюансах регіональної доступності.
Важливо зазначити, що інтеграція TikTok доступна не в усіх країнах і залежить від певних економічних зон, де платформа офіційно підтримує ці функції. Ми пояснимо, де її можна налаштувати одразу, а де можуть діяти обмеження.
API обміну повідомленнями TikTok наразі перебуває в відкритому бета-тестуванні в Азійсько-Тихоокеанському регіоні, Латинській Америці, на Близькому Сході, в Африці (METAP) та Північній Америці (за винятком США). Підключений акаунт має бути зареєстрований в одному з цих регіонів.
Якщо користувач зі США, Європейської економічної зони (EEA), Швейцарії або Великої Британії надішле повідомлення, воно не буде отримане через обмеження TikTok.
Зверніть увагу!
Щоб створити та налаштувати чат-бота для TikTok, зверніться до розділу «Як створити чат-бота для бізнесу».
Специфіка кнопок TikTok описана тут.
Інтеграція TikTok з MaviBot — це більше, ніж технічне оновлення: це можливість бути на передовій комунікації з аудиторією, використовувати найгарячіший канал для просування та взаємодіяти з користувачами там, де вони проводять свій час.
Як підготувати свій акаунт до інтеграції
Почнімо з найважливішого кроку — правильного налаштування з’єднання.
Перш ніж під’єднати свій акаунт, потрібно перейти на Бізнес-акаунт.
Крок 1: Перейдіть до «Налаштування та конфіденційність» розділ.
Крок 2: Далі перейдіть до розділу «Акаунт».
Крок 3: Натисніть на «Перейти на Бізнес-акаунт».
Крок 4: Заповніть дані про ваш бізнес.
Готово! Тепер ваш акаунт готовий до підключення до MaviBot.
Як під’єднати свій акаунт до MaviBot
Перейдіть на вкладку «Месенджери» розділ і натисніть TikTok кнопку.
Далі, увійдіть у свій акаунт TikTok у вікні, що з’явиться.
І надайте MaviBot доступ до вашого акаунта.
Важливо!
Ми наполегливо радимо надати доступ до коментарів, повідомлень, інформації профілю та можливості переглядати ваші відео. Без цих дозволів бот і його callback-и можуть просто не працювати, .
Усі інші дозволи ви можете залишити або відхилити на власний розсуд.
Якщо пізніше ви відкличете будь-який із дозволів, необхідних для коректної роботи чат-бота, повторно увімкнути їх можна буде лише в налаштуваннях самого 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). HОднак одне повідомлення може містити лише кнопки одного типу.
Приклад 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 змінної.
Last updated