النشر التلقائي لمقاطع Twitch الجديدة في Discord عبر EventSub
لمن يناسب النشر التلقائي لمقاطع Twitch في Discord
يساعد التكامل المدمج بين Twitch وDiscord على عرض حالة البث، ومنح الأدوار، والإعلان عن بدء البث. لكنه عادةً لا ينشر المقاطع الجديدة تلقائيًا في قناة نصية. للقيام بذلك تحتاج إلى بوت جاهز، أو خدمة أتمتة، أو ربط خاص بك بين Twitch EventSub وDiscord webhook.
الحلول الجاهزة مناسبة إذا لم تكن بحاجة إلى تطوير: تربط Twitch وDiscord، وتختار القناة، وتضبط القالب. قبل التشغيل تحقق من أن الخدمة تتفاعل مع إنشاء المقطع تحديدًا، وليس فقط مع بدء البث. عيب الحلول الجاهزة هو الاعتماد على الخطط والأسعار والفلاتر المتاحة وتنسيق الرسائل.
اختر مخطط النشر قبل إعداد Twitch
لاختبار سريع أنشئ قناة Discord خاصة واختبر عدة مقاطع يدويًا. سيساعدك ذلك على رؤية التأخيرات، والتحقق من بطاقة الرابط، وفهم ما إذا كانت تصل رسائل عن مقاطع لا يجب أن تصل إلى المجتمع.
- البوت الجاهز يتصل بشكل أسرع، لكنه قد لا يدعم شروط النشر المطلوبة أو تنسيق embed الخاص بك.
- منشئ الأتمتة يسمح بإضافة التفرعات والفلاتر، لكن بعض المحفزات والإجراءات قد تكون محدودة حسب خطة الخدمة.
- معالج EventSub الخاص بك يمنحك التحكم في قائمة الانتظار والقالب والسجلات والحماية من التكرار، لكنه يتطلب خادمًا وOAuth ودعمًا للكود.
حدد القاعدة مسبقًا: نشر جميع المقاطع، أو مقاطع مالك القناة فقط، أو المقاطع من المشرفين، أو الروابط بعد الموافقة اليدوية. عيب الفلترة الصارمة هو أن اللحظة المميزة التي أنشأها أحد المشاهدين قد تبقى دون نشر.
أنشئ Discord webhook لقناة المقاطع
يتم إنشاء webhook في إعدادات القناة النصية المطلوبة في Discord. يتطلب ذلك صلاحيات إدارة webhook. يرسل الرسائل باسم محدد وبصورة رمزية مختارة، لذا لا حاجة إلى حساب Discord منفصل للنشر الأساسي.
- افتح إعدادات القناة النصية التي ستصل إليها المقاطع.
- انتقل إلى قسم التكاملات وابحث عن webhook.
- أنشئ webhook جديدًا، وحدد اسمًا واضحًا، وارفع صورة رمزية عند الحاجة.
- انسخ URL واحفظه في متغير بيئة أو مخزن محمي.
- أرسل رسالة اختبارية إلى القناة الخاصة.
URL الخاص بـ webhook هو سر. من يحصل على هذا الرابط سيتمكن من إرسال رسائل إلى القناة باسم webhook. لا تضف العنوان إلى مستودع عام أو لقطات شاشة للوحة التحكم أو كود العميل. في حال التسريب احذف webhook وأنشئ آخر جديدًا: تغيير URL للعنوان القديم لا يكفي.
اربط حدث إنشاء المقطع عبر Twitch EventSub
في المخطط الخاص بك يرسل Twitch الحدث channel.clip.created إلى عنوان HTTPS الخاص بالمعالج لديك. يتحقق المعالج من الطلب، ويحفظ بيانات المقطع، ويُنشئ الرسالة، ويمررها إلى Discord webhook. لا يحصل حساب Twitch في هذه الحالة على وصول إلى خادم Discord.
للاشتراك ستحتاج إلى تطبيق Twitch، ومعرّف القناة، وعنوان callback URL، وتفويض مناسب لنوع الحدث المختار. يجب مطابقة متطلبات الرمز والصلاحيات مع وثائق EventSub الحالية: فقد تتغير. لا تستخدم معاملات التفويض من الأمثلة القديمة دون التحقق.
قد ينتهي رمز المستخدم الخاص بمالك القناة أو يُلغى. عيب هذا المخطط هو أن refresh token يجب تخزينه بأمان وتحديث الوصول في الوقت المناسب. إذا لم يعمل التحديث، فقد يتوقف الاشتراك أو إنشاء اشتراكات جديدة دون خطأ ملحوظ في Discord.
جهّز عنوان HTTPS لإشعارات Twitch
يجب أن يكون callback URL متاحًا من الإنترنت عبر HTTPS. عند إنشاء الاشتراك يرسل Twitch طلب تحقق من النوع webhook_callback_verification. يجب أن يتأكد الخادم من صحة الطلب وأن يعيد قيمة challenge كنص عادي. حتى تنجح هذه المرحلة لن يصبح الاشتراك نشطًا.
تصل أحداث العمل من النوع notification. من الأفضل الرد عليها سريعًا باستجابة HTTP ناجحة، وتمرير النشر إلى قائمة انتظار أو معالج منفصل. إذا انتظرت رد Discord داخل طلب EventSub، فإن تأخر الشبكة يزيد من خطر إعادة تسليم الإشعار.
للتطوير المحلي يمكنك استخدام نفق HTTPS. عيبه أن العنوان العام قد يتغير بعد إعادة التشغيل. النفق مناسب للاختبار، لكنه لا يغني عن endpoint دائم للأتمتة العاملة.
تحقق من التوقيع باستخدام جسم الطلب الأصلي
يُبنى توقيع EventSub من معرّف الرسالة ووقت الإرسال وجسم طلب HTTP الأصلي. احصل أولًا على بايتات body، واحفظها دون تغيير، ثم تحقق من HMAC. لا يجوز تحليل JSON وإعادة تجميعه قبل التحقق من التوقيع. قد يتغير ترتيب الحقول أو المسافات أو الترميز، ولن يتطابق التوقيع المحسوب.
للتحقق تحتاج إلى الترويسات Twitch-Eventsub-Message-Id وTwitch-Eventsub-Message-Timestamp وTwitch-Eventsub-Message-Signature. تُكوَّن سلسلة HMAC SHA-256 هكذا: messageId + timestamp + rawBody. يُستخدم كسر مفتاح السر المحدد عند إنشاء الاشتراك. تُقارن النتيجة بصيغة سداسية عشرية بقيمة الترويسة التي تبدأ بـ sha256=.
في Node.js تبدو المنطقية هكذا: أنشئ HMAC SHA-256 بسر الاشتراك، ومرر إليه messageId + timestamp + rawBody، وأضف إلى الهاش البادئة sha256=، وقارنه بـ Twitch-Eventsub-Message-Signature عبر crypto.timingSafeEqual. قبل المقارنة تحقق من تساوي طول السلاسل، وإلا ستفشل المقارنة الآمنة بخطأ.

تحقق من نوع الرسالة ووقت إرسالها
التحقق من HMAC مطلوب لكل طلب EventSub، بما في ذلك callback verification وnotification وrevocation. فقط بعد التحقق الناجح اقرأ JSON وحدد نوع الرسالة من الترويسة Twitch-Eventsub-Message-Type. لتحقق callback أعد challenge، وللإشعار أنشئ مهمة نشر، وللإلغاء سجّل سبب تعطيل الاشتراك في السجل.
بالإضافة إلى ذلك قارن الوقت من Twitch-Eventsub-Message-Timestamp مع وقت الخادم الحالي. تساعد نافذة الاستقبال المحدودة على استبعاد الطلبات القديمة التي أعاد طرف ثالث إرسالها. هذا التحقق لا يغني عن HMAC: يمكن قراءة timestamp من الطلب، لكن دون السر لا يمكن إنشاء توقيع صحيح.
احفظ سر الاشتراك بشكل منفصل عن الكود وعن URL الخاص بـ Discord webhook. عيب التغيير المتكرر للسر دون إجراء تحديث هو أن الاشتراك الحالي سيتوقف عن اجتياز التحقق. أنشئ أو حدّث الاشتراك أولًا، ثم بدّل السر في المعالج.
لا تنشر المقطع نفسه مرتين
قد يعيد EventSub تسليم إشعار واحد إذا استجاب endpoint ببطء أو انقطع الاتصال أو حدث خطأ في الشبكة. احفظ Twitch-Eventsub-Message-Id في قاعدة بيانات دائمة بفهرس فريد. إذا كان هذا المعرّف قد عولج بالفعل، فلا تنشئ مهمة ثانية وأعد استجابة ناجحة.
أضف مفتاحًا فريدًا ثانيًا حسب معرّف المقطع من بيانات الحدث. هذا يحمي من النشر المتكرر عندما يصل الفيديو نفسه في إشعارات مختلفة أو عندما أُعيد تشغيل المهمة بعد فشل. حاول أولًا كتابة clip_id في جدول المقاطع المنشورة، وبعد الكتابة الناجحة فقط أرسل الرسالة إلى Discord.
لهذا المخطط عيب: قد يؤدي فشل بين كتابة clip_id وإرسال webhook إلى ترك المقطع موسومًا كمنشور دون رسالة في Discord. في مثل هذه الحالات احفظ حالة المهمة: منشأة، قيد الإرسال، منشورة، خطأ. يمكن إعادة المهام ذات حالة الخطأ يدويًا أو وفق قواعد قائمة الانتظار.
أنشئ رسالة embed لـ Discord
من المفيد تمرير اسم المقطع واسم المنشئ واسم القناة والفئة والرابط المباشر في الرسالة. لا تُدرج نصًا من Twitch في JSON يدويًا عبر دمج السلاسل: فقد تكسر علامات الاقتباس والأحرف الخاصة الطلب. أنشئ الكائن بوسائل اللغة وأرسله كـ JSON.
قد يبدو قالب embed هكذا: العنوان «مقطع جديد على القناة»، الوصف «المنشئ: {creator_name}»، URL «{clip_url}»، حقل «الاسم» بالقيمة «{clip_title}»، حقل «الفئة» بالقيمة «{game_name}». إذا لم تكن الفئة أو اسم المنشئ موجودًا في الحدث، فاترك الحقل فارغًا أو لا تضفه.
يمكنك إضافة إشارة إلى دور، لكن لا ترسلها مع كل مقطع دون قيود. عيب الإشعارات الدائمة هو أن أعضاء الخادم سيبدؤون بتعطيل القناة أو الدور. للقناة النشطة من الأفضل نشر المقاطع دون تنبيه، أو الإشارة إلى الدور وفق قاعدة منفصلة فقط.
اختبر السيناريو قبل النشر في القناة الرئيسية
استخدم أولًا قناة Discord اختبارية وأنشئ عدة مقاطع بأسماء ومنشئين وفئات مختلفة. تحقق مما إذا كان callback verification ينجح، وهل يُتحقق من التوقيع قبل تحليل JSON، وهل تظهر بطاقة واحدة لكل clip_id، وهل تُنشر الرسالة عند إعادة تسليم EventSub.
- تحقق من أن الخادم يقرأ raw body قبل محلل JSON أو يحفظ بايتات الطلب الأصلية.
- تأكد من أن challenge يُعاد فقط بعد التحقق الناجح من Twitch-Eventsub-Message-Signature.
- تحقق من معالجة خطأ Discord webhook وإعادة المهمة دون إنشاء رسالة ثانية.
- راجع السجلات حسب message ID وclip_id ونوع رسالة EventSub وحالة الإرسال.
لا تكتب في السجلات سر الاشتراك أو رموز OAuth أو URL الكامل لـ Discord webhook. يكفي للتشخيص معرّف الحدث ومعرّف المقطع ورمز استجابة Discord ونص الخطأ التقني دون الترويسات السرية.
Last Articles
ما الذي تغيّر في التصميم والوظائف قمنا بتحديث الموقع ليكون العمل عليه أسرع وأكثر راحة. التغييرات الرئيسية تتعلق بالواجهة والحساب الشخصي وإدارة الطلبا..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. استخدم كود الخصم "December2025" للحصول على خصم 15٪ لجميع مشاهدينا2. لقد خفضنا حتى 1 يناير الأسعار الأساسية لـ أداة التكوين الخاصة بنا وأرخص فئة للم..
خدمات نشل هي العمل بثبات ، لذلك نحن على استعداد للتعاون مع الفرق والبائعين, أصحاب الخدمة ، وأصحاب بوت ، وغيرها الكثير.يمكن مناقشة المصطلحات الفردي..
نحن لقد قمت بتحديث خدمات عارض نشل لدينا بالكامل ، وهم الآن العمل بثبات. نحن نستخدم فقط عناوين إب عالية الجودة للمشاهدين.يكمن الفارق الدقيق في الطل..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
نظرًا للشعبية الكبيرة التي تتمتع بها خدمات الشراكة وبرامج الإحالة، فقد قمنا بإنشاء جدول تعاون. والجوهر بسيط للغاية: المزيد من الجمهور المباشر - المزيد..
خدماتنا للبث المباشر

Shopee
خدماتنا لصانعي المحتوى









