# Cómo crear un chatbot de TikTok

MaviBot tiene una integración con TikTok, una de las plataformas sociales más dinámicas y populares del mundo. Esto marca un nuevo capítulo para nuestro ecosistema. TikTok, donde millones de usuarios interactúan a diario, es el epicentro de la comunicación moderna, las tendencias y los nuevos formatos interactivos. Esta integración permite a las empresas y proyectos conectarse con un público más joven a un nivel completamente nuevo.

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

Revisaremos los aspectos técnicos del proceso:

* los pasos necesarios para activar la integración
* los callbacks disponibles
* los permisos que deben concederse

Además, nos centraremos específicamente en los matices de la disponibilidad regional.

{% hint style="warning" %}
Es importante señalar que la integración con TikTok no está disponible en todos los países y depende de zonas económicas específicas en las que la plataforma admite oficialmente estas funciones. Delimitaremos dónde se puede configurar de inmediato y dónde pueden aplicarse limitaciones.

La API de Mensajería de TikTok se encuentra actualmente en pruebas beta abiertas en la región de Asia-Pacífico, América Latina, Oriente Medio, África (METAP) y América del Norte (excluidos los Estados Unidos). La cuenta conectada debe estar registrada en una de estas regiones.

Si un usuario de los Estados Unidos, del Espacio Económico Europeo (EEE), de Suiza o del Reino Unido envía un mensaje, no se recibirá debido a las restricciones de TikTok.

[Consulta la documentación oficial de TikTok para obtener más detalles.](https://business-api.tiktok.com/portal/docs?id=1832184145137922)
{% endhint %}

{% hint style="success" %}
¡Ten en cuenta!

Para crear y configurar un chatbot para TikTok, consulta la sección "Cómo crear un chatbot para empresas".

Las especificaciones de los botones de TikTok están cubiertas [aquí](#knopki).
{% endhint %}

Integrar TikTok con MaviBot es más que una actualización técnica: es una oportunidad para estar a la vanguardia de la comunicación con la audiencia, usar el canal más popular para la promoción e interactuar con los usuarios allí donde pasan su tiempo.

### Cómo preparar tu cuenta para la integración

Empecemos con el paso más importante: configurar correctamente la conexión.

Antes de conectar tu cuenta, debes cambiarla a una Cuenta de Empresa.

Paso 1: Ve a **"Configuración y privacidad"** sección.

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

Paso 2: Luego, ve a la sección "Cuenta".

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

Paso 3: Haz clic en **"Cambiar a Cuenta de Empresa"**.

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

Paso 4: Rellena los datos de tu empresa.

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

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

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

¡Listo! Tu cuenta ya está preparada para conectarse a MaviBot.

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

## Cómo conectar tu cuenta a MaviBot

Ve a la pestaña **"Mensajeros"** sección y haz clic en el **TikTok** botón.

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

A continuación, inicia sesión en tu cuenta de TikTok en la ventana que aparece.

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

Y concede a MaviBot acceso a tu cuenta.

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

Te recomendamos encarecidamente que concedas acceso a los comentarios, mensajes, información del perfil y la capacidad de ver tus videos. El bot y sus callbacks podrían simplemente no funcionar sin estos permisos.

Puedes omitir o denegar todos los demás permisos a tu propia discreción.

Si más adelante revocas alguno de los permisos esenciales para que el chatbot funcione correctamente, solo podrás volver a habilitarlos desde la propia configuración de TikTok.
{% endhint %}

Después, serás redirigido automáticamente a la **"Mensajeros"** sección de MaviBot, donde verás una notificación que confirma la integración correcta.

## Particularidades de TikTok

1. Para poder enviar mensajes a un usuario, primero debe iniciar él el chat.
2. Puedes enviar hasta 10 mensajes en un período de 48 horas después de recibir un mensaje de un usuario de TikTok.\
   \&#xNAN;*Ejemplo: si recibes un mensaje de un usuario, puedes enviar hasta 10 mensajes en las siguientes 48 horas. Si ese mismo usuario envía otro mensaje más tarde, comenzará una nueva ventana de 48 horas, lo que te permitirá enviar otros 10 mensajes a ese usuario.*
3. Un mensaje no puede contener texto y una imagen al mismo tiempo.
4. El envío y la recepción de archivos adjuntos de imagen a través de la API solo están disponibles si tanto el remitente como el destinatario se encuentran en países que admiten imágenes en mensajes privados. El intercambio de imágenes no está disponible en todos los países.
5. El tamaño máximo de un archivo adjunto de imagen es de 3 megabytes.
6. Un solo mensaje puede contener solo un archivo adjunto.

## Devoluciones de llamada

tiktok\_client\_new\_comment \<video\_id>: \<comment\_text> - un usuario ha dejado un comentario en tu video.

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

tiktok\_client\_share\_post \<shared\_video\_id> \<url> - un usuario envió un video en los mensajes directos de la cuenta conectada.

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

## Variables del cliente almacenadas

tiktok\_comment\_id - ID del comentario. Se guarda cuando un usuario comenta en tu video y se usa para responder a ese comentario.

tiktok\_comment\_video\_id - ID del video en el que se comenta. Se guarda cuando un usuario comenta en tu video y se usa para responder al comentario.

tiktok\_is\_follower - pasa a ser True si el usuario sigue tu cuenta.

tiktok\_conversation\_id - ID del chat. Se genera después de que un usuario envía un mensaje en el chat. Necesario para enviar mensajes; ¡no lo borres!

## Botones

El número máximo de botones en un solo mensaje es 3.

TikTok admite dos tipos de botones: callback y "predeterminado" (URL). H<mark style="color:$danger;">**sin embargo, un solo mensaje solo puede contener botones de un tipo.**</mark>

Ejemplo 1.

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

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

Ejemplo 2.

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

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

**Resultado**

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

**¡Ten en cuenta!**

***Los mensajes de botones no están disponibles en TikTok Desktop.*** En el chat de escritorio, verás una notificación como esta:

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

Sin embargo, en la aplicación móvil, el mensaje se mostrará ***correctamente***:

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

El texto mostrado en el botón y el texto enviado al bot al hacer clic son idénticos. El botón se genera usando datos del campo "Texto del mensaje de respuesta" o "URL" en la configuración del botón.

1. Los botones de callback aparecen como botones normales. Al hacer clic, envían un mensaje en el chat en nombre del usuario, que contiene el texto del botón. La longitud máxima es de 20 caracteres.
2. Los botones URL aparecen como enlaces. Sin embargo, su comportamiento es el mismo que el de los botones de callback. Actualmente, TikTok no admite la creación de botones que abran una página web en la URL especificada al hacer clic. La longitud máxima es de 40 caracteres.

{% hint style="success" %}
Obtén más información sobre el uso de [botones de callback](/doc/es/chatbot/builder/botones.md#how-to-add-a-callback-button-facebook-telegram) en MaviBot aquí.
{% endhint %}

## Funciones

Cómo responder a un comentario:

tiktok\_create\_comment(text, comment\_video\_id, comment\_id) - publica una respuesta al comentario especificado.

<table><thead><tr><th width="276.55859375">Parámetro</th><th>Descripción</th></tr></thead><tbody><tr><td><mark style="color:rojo;"><strong>!</strong></mark> text</td><td>parámetro requerido, el texto del comentario</td></tr><tr><td>comment_video_id</td><td>El ID del video donde se publicó el comentario. Este es un parámetro opcional; si no se proporciona, el valor se tomará del <em>cliente tiktok_comment_video_id</em> variable.</td></tr><tr><td>comment_id</td><td>El ID del comentario al que responder. Este es un parámetro opcional; si no se proporciona, el valor del <em>cliente tiktok_comment_id</em> variable se utilizará.</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/es/chatbot/mensajeros/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.