# Как создать чатбота для TikTok

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

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

Мы рассмотрим технические аспекты процесса:

* шаги, необходимые для активации интеграции
* доступные колбэки
* разрешения, которые необходимо предоставить

Кроме того, мы отдельно сосредоточимся на нюансах региональной доступности.

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

API сообщений TikTok в настоящее время находится в открытом бета-тестировании в регионе Азиатско-Тихоокеанского региона, Латинской Америки, Ближнего Востока, Африки (METAP) и Северной Америки (за исключением США). Связанный аккаунт должен быть зарегистрирован в одном из этих регионов.

Если пользователь из США, Европейской экономической зоны (ЕЭЗ), Швейцарии или Великобритании отправит сообщение, оно не будет получено из-за ограничений TikTok.

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

{% hint style="success" %}
Обратите внимание!

Чтобы создать и настроить чат-бота для TikTok, обратитесь к разделу «Как создать чат-бота для бизнеса».

Спецификация кнопок TikTok описана [здесь](#knopki).
{% endhint %}

Интеграция TikTok с MaviBot — это больше, чем техническое обновление: это возможность быть на переднем крае общения с аудиторией, использовать самый горячий канал продвижения и взаимодействовать с пользователями там, где они проводят своё время.

### Как подготовить аккаунт к интеграции

Начнём с самого важного шага — правильной настройки подключения.

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

Шаг 1: Перейдите в **«Настройки и конфиденциальность»** раздел.

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

Шаг 2: Затем перейдите в раздел «Аккаунт».

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

Шаг 3: Нажмите на **«Переключиться на бизнес-аккаунт»**.

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

Шаг 4: Заполните данные о вашей компании.

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

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

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

Готово! Ваш аккаунт теперь готов к подключению к MaviBot.

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

## Как подключить аккаунт к MaviBot

Перейдите в **«Мессенджеры»** раздел и нажмите кнопку **TikTok** .

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

Далее войдите в свой аккаунт TikTok в открывшемся окне.

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

И предоставьте MaviBot доступ к вашему аккаунту.

{% hint style="danger" %}
Важно!

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

Все остальные разрешения вы можете оставить или отклонить по своему усмотрению.

Если позже вы отзовёте какие-либо разрешения, необходимые для корректной работы чат-бота, повторно включить их можно будет только через настройки самого TikTok.
{% endhint %}

После этого вы будете автоматически перенаправлены в **«Мессенджеры»** раздел в 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> — пользователь оставил комментарий к вашему видео.

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

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

<div data-with-frame="true"><figure><img src="/files/48d1ef057232cbaef40b92da2fce35bbce054f68" 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/18612d0e94fd114314ed6daffe7fcb41ee0f4623" alt=""><figcaption></figcaption></figure></div>

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

Пример 2.

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

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

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

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

**Обратите внимание!**

***Сообщения с кнопками недоступны в TikTok Desktop.*** В десктопном чате вы увидите такое уведомление:

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

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

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

Текст, отображаемый на кнопке, и текст, отправляемый боту при нажатии, идентичны. Кнопка формируется на основе данных из поля «Текст сообщения ответа» или «URL» в настройках кнопки.

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

{% hint style="success" %}
Узнайте больше об использовании [кнопок callback](/doc/ru/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:красный;"><strong>!</strong></mark> text</td><td>обязательный параметр, текст комментария</td></tr><tr><td>comment_video_id</td><td>ID видео, под которым опубликован комментарий. Это необязательный параметр; если он не указан, значение будет взято из <em>переменной клиента tiktok_comment_video_id</em> .</td></tr><tr><td>comment_id</td><td>ID комментария, на который нужно ответить. Это необязательный параметр; если он не указан, будет использовано значение из <em>переменной клиента tiktok_comment_id</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/ru/chatbot/messendzhery/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.