Tutorial · Gratis · 5 minutos

Crea un bot de chat para TikTok LIVE

Lee cada evento de chat, regalo y entrada de cualquier transmisión de TikTok LIVE y responde a comandos en tu propia app. Funciona en Node.js o Python con menos de 60 líneas de código.

1

Instala el SDK

Un solo paquete. Sin paso de compilación. Funciona en cualquier entorno con Node 18+ o Python 3.9+.

npm install @tiktool/live
2

Configura tus credenciales

Solo necesitas una cosa:

  • API key - desde tu panel. El plan gratis alcanza para una transmisión.
export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"
3

Escribe el bot

Escucha chat, regalos, entradas y likes. Responde a los comandos !hello y !ping con tu propia acción: un overlay, un sonido, un webhook.

// bot.mjs
import { TikTokLive } from '@tiktool/live'

const USERNAME = process.env.TIKTOK_USERNAME
const API_KEY  = process.env.TIKTOOL_API_KEY

// Your reaction to a command: trigger an overlay, play a sound, call a webhook.
function onCommand(name, user) {
  console.log(`command ${name} from @${user}`)
}

const client = new TikTokLive({ uniqueId: USERNAME, apiKey: API_KEY })
client.on('connected', e => console.log(`connected to room ${e.roomId}`))
client.on('chat', e => {
  console.log(`@${e.user.uniqueId}: ${e.comment}`)
  if (e.comment.toLowerCase() === '!hello') onCommand('hello', e.user.uniqueId)
  if (e.comment.toLowerCase() === '!ping')  onCommand('ping', e.user.uniqueId)
})
client.on('gift', e => console.log(`gift: ${e.user.uniqueId} → ${e.giftName} (${e.diamondCount}💎)`))
client.connect()
4

Ejecútalo

El bot se queda conectado hasta que lo detengas. La lógica de reconexión viene integrada en el SDK.

node bot.mjs

Escribe !hello o !ping desde cualquier cuenta de TikTok en el chat del streamer y tu bot responde como tu cuenta.

Limitaciones a tener en cuenta

Todo lo de abajo lo impone TikTok sobre tu cuenta/IP; tik.tools no lo puede quitar. Diseña la lógica de tu bot pensando en esto.

~100k

eventos por transmisión por minuto

Los creadores grandes (1M+ espectadores) generan decenas de miles de eventos por minuto. Tu bot tiene que procesarlos sin prisa: no bloquees el event loop con cada mensaje del chat. Descarta o pon en cola el trabajo pesado.

fin del LIVE

la sesión termina con el LIVE

Cuando el streamer termina su LIVE, el WebSocket se cierra. El SDK dispara disconnected. Vuelve a conectarte cuando el streamer esté en vivo otra vez: consulta tik.tools/api/live/check-live o usa webhooks.

no afiliado

no respaldado por TikTok

Esta es una integración no oficial. Usa una cuenta de TikTok exclusiva para el bot, no la mezcles con tu cuenta principal y no te hagas pasar por creadores. TikTok puede suspender la cuenta si el bot parece spam.