# Як створити чатбота для TikTok

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

<div data-with-frame="true"><figure><img src="/files/684315758c8fbcd4b7240be3f485629aa44da5f4" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

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

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

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

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

[Дивіться офіційну документацію TikTok для отримання деталей.](https://business-api.tiktok.com/portal/docs?id=1832184145137922)
{% endhint %}

{% hint style="success" %}
Зверніть увагу!

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

Специфіка кнопок TikTok описана [тут](#knopki).
{% endhint %}

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

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

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

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

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

<div data-with-frame="true"><figure><img src="/files/751b7f5a90af8297ac461991c5f4748d48801633" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/0b28f76171d0dc63e971b81b85fd02caaa35357b" alt="" width="375"><figcaption></figcaption></figure></div>

Крок 3: Натисніть на **"Перейти на Business Account"**.

<div data-with-frame="true"><figure><img src="/files/7dc86d739f1aa6f904039ac16782361f02b32599" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/bc0dde4cd94aecb8d3b9c4da800077d8fd35dbcf" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/a16547897e0a1d3df3b3800471f85b0a97ca0445" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/ca929423bec9d62c223cf433209f335ebe9703b2" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/77a2f5634a6b0179fd6a772e9a7b6d0080fc1516" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/a4729f8ccbc668f1a0863ff4280e34c9e776ffa8" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/17222a05d1775b8d92f57978596fa694f33a91cf" alt=""><figcaption></figcaption></figure></div>

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

{% hint style="danger" %}
Важливо!

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

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

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

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

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

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

## Callback-обробники

tiktok\_client\_new\_comment \<video\_id>: \<comment\_text> - користувач залишив коментар до вашого відео.

<div data-with-frame="true"><figure><img src="/files/8d740a44c37f919937b1772a39e289ef47edd2c7" alt="" width="563"><figcaption></figcaption></figure></div>

tiktok\_client\_share\_post \<shared\_video\_id> \<url> - користувач надіслав відео в прямі повідомлення підключеного облікового запису.

<div data-with-frame="true"><figure><img src="/files/2571e94362cd3777af1022473bbae2ccc7f0ffda" alt="" width="563"><figcaption></figcaption></figure></div>

## Збережені змінні клієнта

tiktok\_comment\_id - ID коментаря. Зберігається, коли користувач коментує ваше відео, і використовується для відповіді на цей коментар.

tiktok\_comment\_video\_id - ID відео, до якого залишено коментар. Зберігається, коли користувач коментує ваше відео, і використовується для відповіді на коментар.

tiktok\_is\_follower - стає True, якщо користувач підписаний на ваш обліковий запис.

tiktok\_conversation\_id - ID чату. Створюється після того, як користувач надсилає повідомлення в чаті. Потрібен для надсилання повідомлень; не видаляйте!

## Кнопки

Максимальна кількість кнопок в одному повідомленні — 3.

TikTok підтримує два типи кнопок: callback і "default" (URL). <mark style="color:$danger;">**H**</mark><mark style="color:$danger;">**оча одне повідомлення може містити лише кнопки одного типу.**</mark>

Приклад 1.

<div data-with-frame="true"><figure><img src="/files/59daa41ecd8ae2fe49798599bbb20fce807c5e1c" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/6943dcb390e58c8b9717e32c16713a4d294f515b" alt=""><figcaption></figcaption></figure></div>

Приклад 2.

<div data-with-frame="true"><figure><img src="/files/8a2c20f5cac22268650fbad7e46c96579ce36381" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/d40ffb8aafd83acf8648fc9cf47e4710abbc2279" alt=""><figcaption></figcaption></figure></div>

**Результат**

<div data-with-frame="true"><figure><img src="/files/136bb3e34a0193e4a88bdc025fa547e93c27c452" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

<div data-with-frame="true"><figure><img src="/files/e3dac0b7b92bf729fdb675dbec44d3d47c9e293a" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/16f35c011147a4744b365d5de0c2ba94b0c9d764" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

{% hint style="success" %}
Дізнайтеся більше про використання [callback-кнопок](/doc/uk/chatbot/builder/knopki.md#how-to-add-a-callback-button-facebook-telegram) у MaviBot тут.
{% endhint %}

## Функції

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

tiktok\_create\_comment(text, comment\_video\_id, comment\_id) - публікує відповідь на вказаний коментар.

<table><thead><tr><th width="276.55859375">Параметр</th><th>Опис</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> text</td><td>обов’язковий параметр, текст коментаря</td></tr><tr><td>comment_video_id</td><td>ID відео, під яким залишено коментар. Це необов’язковий параметр; якщо його не вказано, значення буде взято з <em>tiktok_comment_video_id client</em> змінної.</td></tr><tr><td>comment_id</td><td>ID коментаря, на який потрібно відповісти. Це необов’язковий параметр; якщо його не вказано, буде використано значення з <em>tiktok_comment_id client</em> змінної.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/uk/chatbot/mesendzheri/tiktok/chatbot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.