教學 · 免費 · 5 分鐘
打造 TikTok LIVE 聊天機器人
讀取任何 TikTok LIVE 直播的每則聊天、禮物和進場事件，在你自己的 App 裡回應指令。用 Node.js 或 Python，不到 60 行程式碼。
1
安裝 SDK
只要一個套件，不需建置步驟。任何 Node 18+ 或 Python 3.9+ 環境都能用。
npm install @tiktool/live2
設定憑證
你只需要一樣東西：
- API 金鑰：到你的主控台取得。一個直播用 7 天評估金鑰就夠了。
export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"3
撰寫機器人
監聽聊天、禮物、進場、按讚。用你自己的動作回應 !hello 和 !ping 指令：疊加層、音效或 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
執行
機器人會一直保持連線，直到你停止它。SDK 內建重新連線邏輯。
node bot.mjs用任何 TikTok 帳號在直播主的聊天室輸入 !hello 或 !ping，看看你的機器人如何反應。
重要
需要事先考慮的限制
以下都是 TikTok 對你的帳號 / IP 施加的限制，不是 tik.tools 能解除的。設計機器人邏輯時請把這些考慮進去。
~100k
每場直播每分鐘的事件數
大型直播主（百萬以上觀眾）每分鐘會推送好幾萬個事件。你的機器人要用延遲處理的方式消化，別讓每則聊天都卡住事件迴圈。繁重的工作就丟棄或排進佇列。
直播結束
工作階段隨 LIVE 結束
直播主結束 LIVE 時，WebSocket 會關閉，SDK 會觸發 disconnected。等直播主再次開播後重新連線：輪詢 tik.tools/api/live/check-live 或使用 Webhook。
非官方合作
未獲 TikTok 背書
這是非官方整合。不要冒充直播主，並確保機器人觸發的所有內容都符合 TikTok 社群規範。