Tutorial · Grátis · 5 minutos

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.

1

Instale o SDK

Um pacote. Sem etapa de build. Funciona em qualquer ambiente com Node 18+ ou Python 3.9+.

npm install @tiktool/live
2

Configure 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"
3

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()
4

Rode

O bot fica conectado até você parar. A lógica de reconexão já vem no SDK.

node bot.mjs

Digite !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.

~100k

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.

fim da live

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.

sem vínculo

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.