Crée un bot de chat TikTok LIVE
Lis chaque événement de chat, de cadeau et d'arrivée de n'importe quel stream TikTok LIVE et réagis aux commandes dans ta propre app. En Node.js ou Python, avec moins de 60 lignes de code.
Installe le SDK
Un seul paquet. Pas d'étape de build. Fonctionne dans tout environnement Node 18+ ou Python 3.9+.
npm install @tiktool/liveConfigure tes identifiants
Il te faut une seule chose :
- Clé API - depuis ton tableau de bord. L'offre gratuite suffit pour un stream.
export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"Écris le bot
Écoute le chat, les cadeaux, les arrivées, les likes. Réagit aux commandes !hello et !ping avec ta propre action : un overlay, un son, 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()Lance-le
Le bot reste connecté jusqu'à ce que tu l'arrêtes. La logique de reconnexion est intégrée au SDK.
node bot.mjsTape !hello ou !ping depuis n'importe quel compte TikTok dans le chat du streamer et regarde ton bot réagir.
Les limites à prévoir
Tout ce qui suit est imposé par TikTok sur ton compte/IP - tik.tools ne peut pas le lever. Conçois la logique de ton bot en conséquence.
événements par stream et par minute
Les gros créateurs (1M+ spectateurs) génèrent des dizaines de milliers d'événements par minute. Ton bot doit les traiter sans se bloquer - ne bloque pas la boucle d'événements à chaque message. Abandonne ou mets en file les traitements lourds.
la session se termine avec le LIVE
Quand le streamer termine son LIVE, le WebSocket se ferme. Le SDK déclenche disconnected. Reconnecte-toi quand le streamer repasse en live - interroge tik.tools/api/live/check-live ou utilise les webhooks.
non approuvé par TikTok
C'est une intégration non officielle. Ne te fais pas passer pour des créateurs, et veille à ce que tout ce que ton bot déclenche respecte les règles communautaires de TikTok.