Construiește un bot de chat pentru TikTok LIVE
Citește fiecare eveniment de chat, cadou și intrare din orice LIVE TikTok și reacționează la comenzi în propria ta aplicație. Rulează în Node.js sau Python, cu mai puțin de 60 de linii de cod.
Instalează SDK-ul
Un singur pachet. Fără pas de build. Funcționează în orice mediu Node 18+ sau Python 3.9+.
npm install @tiktool/liveSetează-ți datele de acces
Ai nevoie de un singur lucru:
- Cheie API - din panoul tău de control. Planul gratuit e suficient pentru un LIVE.
export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"Scrie botul
Ascultă chatul, cadourile, intrările și like-urile. Reacționează la comenzile !hello și !ping cu propria ta acțiune: un overlay, un sunet, 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()Rulează-l
Botul rămâne conectat până îl oprești. Logica de reconectare este integrată în SDK.
node bot.mjsScrie !hello sau !ping de pe orice cont TikTok în chatul creatorului și urmărește cum reacționează botul tău.
Limitări de luat în calcul
Tot ce urmează este impus de TikTok contului/IP-ului tău - nu limite pe care tik.tools le poate ridica. Construiește logica botului ținând cont de ele.
evenimente per LIVE pe minut
Creatorii mari (1M+ spectatori) generează zeci de mii de evenimente pe minut. Botul tău trebuie să le proceseze asincron - nu bloca event loop-ul la fiecare mesaj din chat. Renunță la munca grea sau pune-o într-o coadă.
sesiunea se încheie odată cu LIVE-ul
Când creatorul își încheie LIVE-ul, WebSocket-ul se închide. SDK-ul declanșează disconnected. Reconectează-te după ce creatorul intră din nou LIVE - interoghează tik.tools/api/live/check-live sau folosește webhook-uri.
nu este aprobat de TikTok
Aceasta este o integrare neoficială. Nu te da drept alți creatori și păstrează tot ce declanșează botul tău în limitele regulilor comunității TikTok.