Crie um bot de chat para TikTok LIVE
Leia todo evento de chat, presente e entrada de qualquer live do TikTok e reaja a comandos no seu próprio app. Rode em Node.js ou Python com menos de 60 linhas de código.
Instale o SDK
Um pacote. Sem etapa de build. Funciona em qualquer ambiente com Node 18+ ou Python 3.9+.
npm install @tiktool/liveConfigure suas credenciais
Você só precisa de uma coisa:
- Chave de API - pegue no seu painel. O plano grátis dá conta de uma live.
export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"Escreva o bot
Escuta chat, presentes, entradas e curtidas. Reage aos comandos !hello e !ping com uma ação sua: um overlay, um som, um 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()Rode
O bot fica conectado até você parar. A lógica de reconexão já vem no SDK.
node bot.mjsDigite !hello ou !ping de qualquer conta do TikTok no chat do streamer e veja o seu bot reagir.
Limitações para levar em conta
Tudo abaixo é imposto pelo TikTok na sua conta/IP - não é algo que o tik.tools consiga liberar. Monte a lógica do seu bot pensando nisso.
eventos por live por minuto
Criadores grandes (1M+ espectadores) geram dezenas de milhares de eventos por minuto. Seu bot precisa processar tudo sem pressa - não trave o event loop a cada mensagem de chat. Descarte ou enfileire o trabalho pesado.
a sessão termina junto com a LIVE
Quando o streamer encerra a LIVE, o WebSocket fecha. O SDK dispara disconnected. Reconecte quando o streamer entrar ao vivo de novo - consulte tik.tools/api/live/check-live ou use webhooks.
não é endossado pelo TikTok
Esta é uma integração não oficial. Não se passe por criadores e mantenha tudo o que o seu bot aciona dentro das diretrizes da comunidade do TikTok.