# Como criar um chatbot para TikTok

A MaviBot tem integração com o TikTok — uma das plataformas sociais mais dinâmicas e populares do mundo. Isso marca um novo capítulo para o nosso ecossistema. O TikTok, onde milhões de usuários interagem diariamente, é o epicentro da comunicação moderna, das tendências e dos novos formatos interativos. Essa integração permite que empresas e projetos se conectem com um público mais jovem em um nível totalmente novo.

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

Vamos analisar os aspectos técnicos do processo:

* as etapas necessárias para ativar a integração
* os callbacks disponíveis
* as permissões que precisam ser concedidas

Além disso, vamos nos concentrar especificamente nas nuances da disponibilidade regional.

{% hint style="warning" %}
É importante observar que a integração com o TikTok não está disponível em todos os países e depende de zonas econômicas específicas nas quais a plataforma oferece suporte oficial a esses recursos. Vamos mostrar onde ela pode ser configurada imediatamente e onde podem existir limitações.

A API de Mensagens do TikTok está atualmente em testes beta aberto na região da Ásia-Pacífico, América Latina, Oriente Médio, África (METAP) e América do Norte (exceto os Estados Unidos). A conta conectada deve estar registrada em uma dessas regiões.

Se um usuário dos Estados Unidos, do Espaço Econômico Europeu (EEE), da Suíça ou do Reino Unido enviar uma mensagem, ela não será recebida devido às restrições do TikTok.

[Consulte a documentação oficial do TikTok para mais detalhes.](https://business-api.tiktok.com/portal/docs?id=1832184145137922)
{% endhint %}

{% hint style="success" %}
Atenção!

Para criar e configurar um chatbot para o TikTok, consulte a seção "Como criar um chatbot para negócios".

As especificações dos botões do TikTok são abordadas [aqui](#knopki).
{% endhint %}

Integrar o TikTok ao MaviBot é mais do que uma atualização técnica — é uma oportunidade de estar na vanguarda da comunicação com o público, usar o canal mais quente para promoção e engajar os usuários onde eles passam o tempo.

### Como preparar sua conta para a integração

Vamos começar com a etapa mais importante — configurar a conexão corretamente.

Antes de conectar sua conta, você deve mudar para uma Conta Business.

Passo 1: Vá para a **seção "Configurações e privacidade"** .

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

Passo 2: Em seguida, vá para a seção "Conta".

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

Passo 3: Clique em **"Mudar para Conta Business"**.

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

Passo 4: Preencha os dados da sua empresa.

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

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

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

Pronto! Sua conta agora está pronta para ser conectada ao MaviBot.

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

## Como conectar sua conta ao MaviBot

Vá para a **seção "Mensageiros"** e clique no botão **TikTok** .

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

Em seguida, faça login na sua conta TikTok na janela que aparecer.

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

E conceda ao MaviBot acesso à sua conta.

{% hint style="danger" %}
Importante!

Recomendamos fortemente que você conceda acesso aos comentários, mensagens, informações do perfil e à capacidade de visualizar seus vídeos. O bot e seus callbacks podem simplesmente não funcionar sem essas permissões, .

Você pode deixar de conceder ou negar todas as outras permissões, a seu critério.

Se depois você revogar qualquer uma das permissões essenciais para o chatbot funcionar corretamente, só será possível reativá-las nas próprias configurações do TikTok.
{% endhint %}

Você será então redirecionado automaticamente para a **seção "Mensageiros"** seção no MaviBot, onde verá uma notificação confirmando a integração bem-sucedida.

## Especificidades do TikTok

1. Para poder enviar mensagem a um usuário, ele precisa iniciar a conversa primeiro.
2. Você pode enviar até 10 mensagens em um período de 48 horas após receber uma mensagem de um usuário do TikTok.\
   \&#xNAN;*Exemplo: se você receber uma mensagem de um usuário, poderá enviar até 10 mensagens nas próximas 48 horas. Se o mesmo usuário enviar outra mensagem mais tarde, uma nova janela de 48 horas começará, permitindo que você envie mais 10 mensagens para esse usuário.*
3. Uma mensagem não pode conter texto e imagem ao mesmo tempo.
4. O envio e o recebimento de anexos de imagem via API só estão disponíveis se tanto o remetente quanto o destinatário estiverem localizados em países que oferecem suporte a imagens em mensagens privadas. O compartilhamento de imagens não está disponível em todos os países.
5. O tamanho máximo de um anexo de imagem é de 3 megabytes.
6. Uma única mensagem pode conter apenas um anexo.

## Callbacks

tiktok\_client\_new\_comment \<video\_id>: \<comment\_text> - um usuário deixou um comentário no seu vídeo.

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

tiktok\_client\_share\_post \<shared\_video\_id> \<url> - um usuário enviou um vídeo nas mensagens diretas da conta conectada.

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

## Variáveis do cliente armazenadas

tiktok\_comment\_id - ID do comentário. Salvo quando um usuário comenta no seu vídeo e usado para responder a esse comentário.

tiktok\_comment\_video\_id - ID do vídeo que recebeu o comentário. Salvo quando um usuário comenta no seu vídeo e usado para responder ao comentário.

tiktok\_is\_follower - torna-se True se o usuário estiver seguindo sua conta.

tiktok\_conversation\_id - ID da conversa. Gerado depois que um usuário envia uma mensagem no chat. Necessário para enviar mensagens; não exclua!

## Botões

O número máximo de botões em uma única mensagem é 3.

O TikTok oferece suporte a dois tipos de botões: callback e "default" (URL). <mark style="color:$danger;">**H**</mark><mark style="color:$danger;">**owever, uma única mensagem pode conter apenas botões de um único tipo.**</mark>

Exemplo 1.

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

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

Exemplo 2.

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

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

**Resultado**

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

**Atenção!**

***As mensagens com botões não estão disponíveis no TikTok Desktop.*** No chat do desktop, você verá uma notificação assim:

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

No entanto, no aplicativo móvel, a mensagem será exibida ***corretamente***:

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

O texto exibido no botão e o texto enviado ao bot ao clicar são idênticos. O botão é gerado usando dados do campo "Texto da Mensagem de Resposta" ou "URL" nas configurações do botão.

1. Os botões de callback aparecem como botões comuns. Quando clicados, eles enviam uma mensagem no chat em nome do usuário, contendo o texto do botão. O comprimento máximo é de 20 caracteres.
2. Os botões de URL aparecem como links. No entanto, seu comportamento é o mesmo dos botões de callback. Atualmente, o TikTok não oferece suporte à criação de botões que abram uma página da web na URL especificada ao serem clicados. O comprimento máximo é de 40 caracteres.

{% hint style="success" %}
Saiba mais sobre como usar [botões de callback](/doc/pt/chatbot/builder/botoes.md#how-to-add-a-callback-button-facebook-telegram) no MaviBot aqui.
{% endhint %}

## Funções

Como responder a um comentário:

tiktok\_create\_comment(text, comment\_video\_id, comment\_id) - publica uma resposta ao comentário especificado.

<table><thead><tr><th width="276.55859375">Parâmetro</th><th>Descrição</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> text</td><td>parâmetro obrigatório, o texto do comentário</td></tr><tr><td>comment_video_id</td><td>O ID do vídeo no qual o comentário foi feito. Este é um parâmetro opcional; se não for fornecido, o valor será obtido da <em>variável do cliente tiktok_comment_video_id</em> .</td></tr><tr><td>comment_id</td><td>O ID do comentário ao qual responder. Este é um parâmetro opcional; se não for fornecido, será usado o valor da <em>variável do cliente 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/pt/chatbot/mensageiros/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.