MaviBot має інтеграцію з TikTok — однією з найдинамічніших і найпопулярніших соціальних платформ у світі. Це відкриває нову главу для нашої екосистеми. TikTok, де мільйони користувачів щодня взаємодіють, є епіцентром сучасного спілкування, трендів та нових інтерактивних форматів. Ця інтеграція дозволяє бізнесу та проєктам виходити на зв'язок із молодшою аудиторією на абсолютно новому рівні.

Ми розглянемо технічні аспекти процесу:

  • кроки, необхідні для активації інтеграції
  • доступні зворотні виклики
  • дозволи, які потрібно надати

Крім того, ми зосередимося на нюансах регіональної доступності.

Важливо зазначити, що інтеграція TikTok доступна не в усіх країнах і залежить від конкретних економічних зон, де платформа офіційно підтримує ці функції. Ми опишемо, де її можна налаштувати одразу, а де можуть діяти обмеження.

TikTok Messaging API наразі перебуває у відкритому бета-тестуванні в Азійсько-Тихоокеанському регіоні, Латинській Америці, на Близькому Сході, в Африці (METAP) та Північній Америці (за винятком США). Підключений обліковий запис має бути зареєстрований в одному з цих регіонів.

Якщо користувач із США, Європейської економічної зони (ЄЕЗ), Швейцарії або Великої Британії надішле повідомлення, воно не буде отримане через обмеження TikTok.

Детальніше дивіться в офіційній документації TikTok.

Зверніть увагу!

Щоб створити та налаштувати чат-бота для TikTok, зверніться до розділу "Як створити чат-бота для бізнесу".

Специфікації кнопок TikTok описані тут.

Інтеграція TikTok з MaviBot — це більше, ніж технічне оновлення; це можливість бути в авангарді спілкування з аудиторією, використовувати найгарячіший канал для просування та залучати користувачів там, де вони проводять свій час.

Як підготувати обліковий запис до інтеграції

Почнемо з найважливішого кроку — правильного налаштування підключення.

Перед підключенням облікового запису необхідно переключитися на бізнес-акаунт.

Крок 1: Перейдіть до розділу "Налаштування та конфіденційність".

Крок 2: Потім перейдіть до розділу "Обліковий запис".

Крок 3: Натисніть "Переключитися на бізнес-акаунт".

Крок 4: Заповніть дані про бізнес.

Готово! Ваш обліковий запис тепер готовий до підключення до MaviBot.

Як підключити обліковий запис до MaviBot

Перейдіть до розділу "Месенджери" та натисніть кнопку TikTok.

Далі увійдіть у свій обліковий запис TikTok у вікні, що з'явиться.

І надайте MaviBot доступ до вашого облікового запису.

Важливо!

Ми наполегливо рекомендуємо надати доступ до коментарів, повідомлень, інформації профілю та можливості переглядати ваші відео. Бот та його зворотні виклики можуть просто не працювати без цих дозволів.

Ви можете залишити або відхилити всі інші дозволи на власний розсуд.

Якщо ви пізніше відкличете будь-який із дозволів, необхідних для правильної роботи чат-бота, ви зможете повторно ввімкнути їх лише в налаштуваннях самого TikTok.

Після цього вас буде автоматично перенаправлено до розділу "Месенджери" в MaviBot, де ви побачите сповіщення, що підтверджує успішну інтеграцію.

Особливості TikTok

  1. Щоб мати можливість надсилати повідомлення користувачеві, він повинен спочатку почати чат.
  2. Ви можете надіслати до 10 повідомлень протягом 48 годин після отримання повідомлення від користувача TikTok.
    &#xNAN;Приклад: Якщо ви отримали одне повідомлення від користувача, ви можете надіслати до 10 повідомлень протягом наступних 48 годин. Якщо той самий користувач пізніше надішле ще одне повідомлення, почнеться новий 48-годинний період, що дозволить вам надіслати ще 10 повідомлень цьому користувачеві.
  3. Повідомлення не може містити одночасно текст і зображення.
  4. Надсилання та отримання вкладень із зображеннями через API доступне лише в тому випадку, якщо і відправник, і одержувач знаходяться в країнах, які підтримують зображення в особистих повідомленнях. Обмін зображеннями доступний не в усіх країнах.
  5. Максимальний розмір вкладення із зображенням — 3 мегабайти.
  6. Одне повідомлення може містити лише одне вкладення.

Зворотні виклики

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 підтримує два типи кнопок: зворотного виклику та "стандартні" (URL). Однак одне повідомлення може містити лише кнопки одного типу.****

Приклад 1.

Приклад 2.

Результат

Зверніть увагу!

Повідомлення з кнопками недоступні в TikTok Desktop. У чаті на комп'ютері ви побачите таке сповіщення:

Однак у мобільному додатку повідомлення відображатиметься коректно:

Текст, що відображається на кнопці, і текст, надісланий боту після натискання, ідентичні. Кнопка генерується на основі даних із поля "Текст відповіді" або "URL" у налаштуваннях кнопки.

  1. Кнопки зворотного виклику виглядають як звичайні кнопки. Після натискання вони надсилають у чат від імені користувача повідомлення, що містить текст кнопки. Максимальна довжина — 20 символів.
  2. URL-кнопки виглядають як посилання. Однак їхня поведінка така ж, як у кнопок зворотного виклику. Наразі TikTok не підтримує створення кнопок, які відкривають веб-сторінку за вказаним URL після натискання. Максимальна довжина — 40 символів.

Дізнайтеся більше про використання кнопок зворотного виклику у MaviBot тут.

Функції

Як відповісти на коментар:

tiktok_create_comment(text, comment_video_id, comment_id) - публікує відповідь на вказаний коментар.