MaviBot se integra con TikTok, una de las plataformas sociales de más rápido crecimiento y más populares del mundo.
Esta integración abre un nuevo capítulo para el ecosistema de MaviBot. TikTok, donde millones de usuarios interactúan a diario, se ha convertido en el centro de la comunicación moderna, las tendencias y los nuevos formatos interactivos. Las empresas ahora pueden llegar a audiencias más jóvenes a través de una de las plataformas más atractivas del mundo.
En este artículo, aprenderás:
- cómo activar la integración;
- qué callbacks están disponibles;
- qué permisos deben concederse.
También cubriremos la disponibilidad regional y sus limitaciones.
Importante
La integración con TikTok no está disponible en todos los países.
La API de mensajería de TikTok está actualmente disponible en beta abierta solo en:
- Asia-Pacífico (APAC);
- América Latina;
- Medio Oriente;
- África (METAP);
- América del Norte (excluyendo Estados Unidos).
La cuenta de TikTok conectada debe estar registrada en una de estas regiones.
Los mensajes enviados por usuarios de Estados Unidos, el Espacio Económico Europeo (EEE), Suiza o el Reino Unido no pueden recibirse debido a las restricciones de la plataforma TikTok.
Para más información, consulta la documentación oficial de TikTok:
https://business-api.tiktok.com/portal/docs?id=1832184145137922
Ten en cuenta
Antes de crear un chatbot de TikTok, consulta la sección Cómo crear un chatbot para empresas.
Las limitaciones de los botones de TikTok se describen en la sección Botones a continuación.
Integrar TikTok con MaviBot es más que solo otro canal: es una oportunidad para comunicarte con los usuarios donde pasan más tiempo y construir interacciones con los clientes altamente atractivas.
Prepara tu cuenta de TikTok
Antes de conectar tu cuenta a MaviBot, cámbiala a una Cuenta de Negocio.
Paso 1
Abre Configuración y privacidad.
Paso 2
Abre la sección Cuenta.
Paso 3
Selecciona Cambiar a cuenta de negocio.
Paso 4
Completa tu perfil de negocio.
¡Listo! Tu cuenta ya está lista para conectarse a MaviBot.
Conecta tu cuenta de TikTok
Abre la sección Mensajeros en MaviBot y haz clic en TikTok.
Inicia sesión en tu cuenta de TikTok.
Concede a MaviBot acceso a tu cuenta.
Importante
Recomendamos encarecidamente conceder permiso para:
- leer y gestionar mensajes;
- acceder a comentarios;
- acceder a la información del perfil;
- ver videos.
Sin estos permisos, el chatbot y algunos callbacks pueden no funcionar correctamente.
Puedes denegar cualquier otro permiso si no lo necesitas.
Si posteriormente revocas algún permiso requerido, solo podrás volver a habilitarlo desde la configuración de tu cuenta de TikTok.
Después de la autorización, serás redirigido de nuevo a la sección Mensajeros, donde MaviBot mostrará una confirmación de que la integración fue exitosa.
Limitaciones de TikTok
- Un usuario debe iniciar la conversación antes de que el bot pueda enviar mensajes.
- Puedes enviar hasta 10 mensajes dentro de las 48 horas posteriores a recibir un mensaje de un usuario.
- Ejemplo: si un usuario te envía un mensaje, puedes enviar hasta 10 respuestas durante las siguientes 48 horas. Si el usuario envía otro mensaje más tarde, comienza una nueva ventana de 48 horas con otro límite de 10 mensajes salientes.
- Un solo mensaje no puede contener texto y una imagen al mismo tiempo.
- Los archivos adjuntos de imagen solo son compatibles si tanto el remitente como el destinatario se encuentran en países donde TikTok permite compartir imágenes en mensajes privados.
- El tamaño máximo de imagen es de 3 MB.
- Solo se puede incluir un archivo adjunto en un solo mensaje.
Callbacks
Nuevo comentario
tiktok_client_new_comment <video_id>: <comment_text>
Se activa cuando un usuario deja un comentario en uno de tus videos.
Video compartido
tiktok_client_share_post <shared_video_id> <url>
Se activa cuando un usuario comparte un video de TikTok en los mensajes directos de la cuenta conectada.
Variables de cliente
tiktok_comment_id
Almacena el ID del comentario.
Se completa automáticamente cuando un usuario comenta en tu video y se usa al responder a ese comentario.
tiktok_comment_video_id
Almacena el ID del video que recibió el comentario.
Se completa automáticamente cuando un usuario comenta en tu video.
tiktok_is_follower
Devuelve True si el usuario sigue tu cuenta de TikTok.
tiktok_conversation_id
Almacena el ID de la conversación.
Se crea automáticamente después de que un usuario envía el primer mensaje directo.
Importante
No elimines esta variable.
Es necesaria para enviar mensajes al usuario.
Botones
Un mensaje de TikTok puede contener hasta tres botones.
TikTok admite dos tipos de botones:
- Botones de callback
- Botones de URL
Importante
Un solo mensaje puede contener botones de solo un tipo.
Ejemplo 1
Ejemplo 2
Resultado
Ten en cuenta
Los mensajes con botones no son compatibles en TikTok Desktop.
Los usuarios de escritorio verán la siguiente notificación en su lugar:
En la aplicación móvil, el mensaje se muestra correctamente.
El texto mostrado en el botón es idéntico al texto enviado de vuelta al bot después de hacer clic en él.
El texto del botón se toma del campo Texto del mensaje de respuesta o del campo URL en la configuración del botón.
Botones de callback
Se muestran como botones normales.
Al hacer clic, TikTok envía un mensaje al bot en nombre del usuario que contiene el texto del botón.
Longitud máxima: 20 caracteres.
Botones de URL
Se muestran como enlaces.
Actualmente, TikTok no admite la apertura de páginas web cuando se hace clic en los botones de URL.
En su lugar, al hacer clic en el botón se envía su texto al bot, igual que un botón de callback.
Longitud máxima: 40 caracteres.
Más información sobre botones de callback.
Funciones
Responder a un comentario
tiktok_create_comment(text, comment_video_id, comment_id)
Publica una respuesta a un comentario de TikTok.
| Parámetro | Descripción |
|---|---|
| text | Obligatorio. Texto de la respuesta. |
| comment_video_id | ID del video que contiene el comentario. Opcional. Si se omite, se usa el valor de la variable de cliente tiktok_comment_video_id. |
| comment_id | ID del comentario al que responder. Opcional. Si se omite, se usa el valor de la variable de cliente tiktok_comment_id. |