درس تطبيقي · مجاني · 5 دقائق

ابنِ بوت دردشة لبث TikTok LIVE

اقرأ كل حدث دردشة وهدية وانضمام من أي بث TikTok LIVE وتفاعل مع الأوامر داخل تطبيقك. شغّله بـ Node.js أو Python بأقل من 60 سطرًا من الكود.

1

ثبّت SDK

حزمة واحدة. بدون خطوة بناء. يعمل في أي بيئة Node 18+ أو Python 3.9+.

npm install @tiktool/live
2

اضبط بيانات الاعتماد

تحتاج إلى شيء واحد فقط:

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

اكتب !hello أو !ping من أي حساب TikTok في دردشة صاحب البث، وشاهد كيف يتفاعل البوت.

قيود يجب أن تخطط لها

كل ما يلي يفرضه TikTok على حسابك أو IP الخاص بك، وليس شيئًا يستطيع tik.tools رفعه. ابنِ منطق البوت مع وضعها في الحسبان.

~100k

حدث في البث الواحد في الدقيقة

صناع المحتوى الكبار (1M+ مشاهد) يولّدون عشرات الآلاف من الأحداث في الدقيقة. يجب أن يعالجها البوت بتأنٍّ: لا توقف حلقة الأحداث عند كل رسالة دردشة. تجاهل المهام الثقيلة أو ضعها في طابور.

نهاية البث

الجلسة تنتهي مع نهاية LIVE

عندما ينهي صاحب البث بث LIVE، يُغلق WebSocket ويطلق SDK الحدث disconnected. أعد الاتصال بعد أن يبدأ صاحب البث بثًا جديدًا: استطلع tik.tools/api/live/check-live أو استخدم webhooks.

غير تابع

غير معتمد من TikTok

هذا تكامل غير رسمي. لا تنتحل شخصية صناع المحتوى، واحرص على أن يبقى كل ما يُطلقه البوت ضمن إرشادات مجتمع TikTok.