Tutorial · Gratuit · 5 minute

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.

1

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/live
2

Setează-ți datele de acces

Ai nevoie de un singur lucru:

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

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

Rulează-l

Botul rămâne conectat până îl oprești. Logica de reconectare este integrată în SDK.

node bot.mjs

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

~100k

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ă.

sfârșit LIVE

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.

neafiliat

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.