ابنِ بوت دردشة لبث TikTok LIVE
اقرأ كل حدث دردشة وهدية وانضمام من أي بث TikTok LIVE وتفاعل مع الأوامر داخل تطبيقك. شغّله بـ Node.js أو Python بأقل من 60 سطرًا من الكود.
ثبّت SDK
حزمة واحدة. بدون خطوة بناء. يعمل في أي بيئة Node 18+ أو Python 3.9+.
npm install @tiktool/liveاضبط بيانات الاعتماد
تحتاج إلى شيء واحد فقط:
- مفتاح API - من لوحة التحكم. الباقة المجانية تكفي لبث واحد.
export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"اكتب البوت
يستمع للدردشة والهدايا والانضمام والإعجابات. ويتفاعل مع الأمرين !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()شغّله
يبقى البوت متصلًا حتى توقفه. منطق إعادة الاتصال مدمج في SDK.
node bot.mjsاكتب !hello أو !ping من أي حساب TikTok في دردشة صاحب البث، وشاهد كيف يتفاعل البوت.
قيود يجب أن تخطط لها
كل ما يلي يفرضه TikTok على حسابك أو IP الخاص بك، وليس شيئًا يستطيع tik.tools رفعه. ابنِ منطق البوت مع وضعها في الحسبان.
حدث في البث الواحد في الدقيقة
صناع المحتوى الكبار (1M+ مشاهد) يولّدون عشرات الآلاف من الأحداث في الدقيقة. يجب أن يعالجها البوت بتأنٍّ: لا توقف حلقة الأحداث عند كل رسالة دردشة. تجاهل المهام الثقيلة أو ضعها في طابور.
الجلسة تنتهي مع نهاية LIVE
عندما ينهي صاحب البث بث LIVE، يُغلق WebSocket ويطلق SDK الحدث disconnected. أعد الاتصال بعد أن يبدأ صاحب البث بثًا جديدًا: استطلع tik.tools/api/live/check-live أو استخدم webhooks.
غير معتمد من TikTok
هذا تكامل غير رسمي. لا تنتحل شخصية صناع المحتوى، واحرص على أن يبقى كل ما يُطلقه البوت ضمن إرشادات مجتمع TikTok.