# 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 conectar con una audiencia 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
* las devoluciones de llamada 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. Describiremos dónde se puede configurar de inmediato y dónde podrían 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 Norteamérica (excluidos los Estados Unidos). La cuenta conectada debe estar registrada en una de estas regiones.

Si un usuario de Estados Unidos, del Espacio Económico Europeo (EEE), Suiza o el 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 se tratan [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 donde pasan su tiempo.

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

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

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

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

<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: Completa 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 **sección "Mensajeros"** y haz clic en el botón **TikTok** .

<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 vídeos. Es posible que el bot y sus callbacks simplemente no funcionen sin estos permisos, .

Puedes omitir o denegar todos los demás permisos según tu criterio.

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

Luego se te redirigirá automáticamente a la **sección "Mensajeros"** sección de MaviBot, donde verás una notificación que confirma la integración exitosa.

## Detalles específicos de TikTok

1. Para poder enviar un mensaje a un usuario, primero debe iniciar el chat.
2. Puedes enviar hasta 10 mensajes dentro de 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 el 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á disponible 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 solo puede contener un archivo adjunto.

## Callbacks

tiktok\_client\_new\_comment \<video\_id>: \<comment\_text> - un usuario dejó un comentario en tu vídeo.

<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 vídeo 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 de cliente almacenadas

tiktok\_comment\_id - ID del comentario. Se guarda cuando un usuario comenta en tu vídeo y se utiliza para responder a ese comentario.

tiktok\_comment\_video\_id - ID del vídeo comentado. Se guarda cuando un usuario comenta en tu vídeo y se utiliza 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. Requerido para enviar mensajes; ¡no lo elimines!

## Botones

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

TikTok admite dos tipos de botones: callback y "predeterminado" (URL). <mark style="color:$danger;">**H**</mark><mark style="color:$danger;">**owever, 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 con 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 los 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:red;"><strong>!</strong></mark> text</td><td>parámetro obligatorio, el texto del comentario</td></tr><tr><td>comment_video_id</td><td>El ID del vídeo donde se publicó el comentario. Este es un parámetro opcional; si no se proporciona, el valor se tomará de la variable de cliente <em>tiktok_comment_video_id</em> .</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, se utilizará el valor de la variable de cliente <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/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.