MaviBot integrates with TikTok—one of the world's fastest-growing and most popular social platforms.

This integration opens a new chapter for the MaviBot ecosystem. TikTok, where millions of users interact every day, has become the center of modern communication, trends, and new interactive formats. Businesses can now reach younger audiences through one of the world's most engaging platforms.

In this article, you'll learn:

  • how to activate the integration;
  • which callbacks are available;
  • which permissions must be granted.

We will also cover regional availability and its limitations.

Important

TikTok integration is not available in every country.

The TikTok Messaging API is currently available in open beta only in:

  • Asia-Pacific (APAC);
  • Latin America;
  • Middle East;
  • Africa (METAP);
  • North America (excluding the United States).

The connected TikTok account must be registered in one of these regions.

Messages sent by users from the United States, the European Economic Area (EEA), Switzerland, or the United Kingdom cannot be received because of TikTok platform restrictions.

For more information, see the official TikTok documentation:

https://business-api.tiktok.com/portal/docs?id=1832184145137922

Please note

Before creating a TikTok chatbot, see the How to create a chatbot for business section.

TikTok button limitations are described in the Buttons section below.

Integrating TikTok with MaviBot is more than just another channel—it's an opportunity to communicate with users where they spend the most time and build highly engaging customer interactions.

Prepare your TikTok account

Before connecting your account to MaviBot, switch it to a Business Account.

Step 1

Open Settings and privacy.

Step 2

Open the Account section.

Step 3

Select Switch to Business Account.

Step 4

Complete your business profile.

Done! Your account is now ready to connect to MaviBot.

Connect your TikTok account

Open the Messengers section in MaviBot and click TikTok.

Log in to your TikTok account.

Grant MaviBot access to your account.

Important

We strongly recommend granting permission to:

  • read and manage messages;
  • access comments;
  • access profile information;
  • view videos.

Without these permissions, the chatbot and some callbacks may not function correctly.

You may deny any other permissions if you do not need them.

If you later revoke any required permissions, you can re-enable them only from your TikTok account settings.

After authorization, you will be redirected back to the Messengers section, where MaviBot will display a confirmation that the integration was successful.

TikTok limitations

  1. A user must start the conversation before the bot can send messages.
  2. You can send up to 10 messages within 48 hours after receiving a message from a user.
    • Example: if a user sends you one message, you can send up to 10 replies during the next 48 hours. If the user sends another message later, a new 48-hour window begins with another allowance of 10 outgoing messages.
  3. A single message cannot contain both text and an image.
  4. Image attachments are supported only if both the sender and recipient are located in countries where TikTok allows image sharing in private messages.
  5. The maximum image size is 3 MB.
  6. Only one attachment can be included in a single message.

Callbacks

New comment

tiktok_client_new_comment <video_id>: <comment_text>

Triggered when a user leaves a comment on one of your videos.

Shared video

tiktok_client_share_post <shared_video_id> <url>

Triggered when a user shares a TikTok video in the direct messages of the connected account.

Client variables

tiktok_comment_id

Stores the comment ID.

Automatically filled when a user comments on your video and used when replying to that comment.

tiktok_comment_video_id

Stores the ID of the video that received the comment.

Automatically filled when a user comments on your video.

tiktok_is_follower

Returns True if the user follows your TikTok account.

tiktok_conversation_id

Stores the conversation ID.

Created automatically after a user sends the first direct message.

Important

Do not delete this variable.

It is required for sending messages to the user.

Buttons

A TikTok message can contain up to three buttons.

TikTok supports two button types:

  • Callback buttons
  • URL buttons

Important

A single message can contain buttons of only one type.

Example 1

Example 2

Result

Please note

Button messages are not supported in TikTok Desktop.

Desktop users will see the following notification instead:

In the mobile application, the message is displayed correctly.

The text displayed on the button is identical to the text sent back to the bot after it is clicked.

The button text is taken from either the Reply Message Text field or the URL field in the button settings.

Callback buttons

Displayed as regular buttons.

When clicked, TikTok sends a message to the bot on behalf of the user containing the button text.

Maximum length: 20 characters.

URL buttons

Displayed as links.

Currently, TikTok does not support opening web pages when URL buttons are clicked.

Instead, clicking the button sends its text to the bot, just like a callback button.

Maximum length: 40 characters.

Learn more about callback buttons.

Functions

Reply to a comment

tiktok_create_comment(text, comment_video_id, comment_id)

Posts a reply to a TikTok comment.

Parameter Description
text Required. Reply text.
comment_video_id Video ID containing the comment. Optional. If omitted, the value of the tiktok_comment_video_id client variable is used.
comment_id Comment ID to reply to. Optional. If omitted, the value of the tiktok_comment_id client variable is used.