Tutorial · Gratis · 5 minuti

Crea un bot per la chat di TikTok LIVE

Leggi ogni evento di chat, regalo e ingresso da qualsiasi LIVE di TikTok e rispondi ai comandi nella tua app. Funziona in Node.js o Python con meno di 60 righe di codice.

1

Installa l'SDK

Un solo pacchetto. Nessuna build. Funziona in qualsiasi ambiente Node 18+ o Python 3.9+.

npm install @tiktool/live
2

Imposta le credenziali

Ti serve una sola cosa:

export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"
3

Scrivi il bot

Ascolta chat, regali, ingressi e like. Risponde ai comandi !hello e !ping con un'azione tua: un overlay, un suono, 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

Avvialo

Il bot resta connesso finché non lo fermi. La logica di riconnessione è integrata nell'SDK.

node bot.mjs

Scrivi !hello o !ping da qualsiasi account TikTok nella chat dello streamer e guarda il tuo bot reagire.

Limiti da tenere in conto

Tutto quello che trovi qui sotto è imposto da TikTok sul tuo account/IP: tik.tools non può toglierlo. Progetta la logica del bot tenendone conto.

~100k

eventi per diretta al minuto

I grandi creator (1M+ spettatori) generano decine di migliaia di eventi al minuto. Il tuo bot deve elaborarli senza fretta: non bloccare l'event loop a ogni messaggio. Scarta o metti in coda i lavori pesanti.

fine diretta

la sessione finisce con la LIVE

Quando lo streamer chiude la LIVE, il WebSocket si chiude. L'SDK emette disconnected. Riconnettiti quando lo streamer torna in diretta: interroga tik.tools/api/live/check-live o usa i webhook.

non affiliato

non approvato da TikTok

Questa è un'integrazione non ufficiale. Non spacciarti per altri creator e fai in modo che tutto ciò che il tuo bot attiva rispetti le linee guida della community di TikTok.