Webhooks في Discord
مضمّن في Macro Deckانشر رسائل غنية مع عناصر مضمّنة وإشارات في قنوات Discord عبر Webhooks، مع معاينة مباشرة.
نافذة إضافة Webhook في Discord مع حقلي الاسم وعنوان URL الخاص بالـ Webhook
- احفظ Webhooks بأسمائها، واحدًا لكل قناة
- محرر مرئي مع معاينة تشبه Discord
- حتى 10 عناصر مضمّنة مع حقول وصور ومؤلف وتذييل
- لا تنبّه الإشارات أحدًا ما لم تسمح بذلك
- تُملأ متغيرات القوالب عند تشغيل الإجراء
يتيح Webhook في Discord لأي شيء يعرف عنوان URL الخاص به النشر في قناة واحدة في Discord. يحفظ تكامل Webhooks في Discord الـ Webhooks تحت اسم، ويمنحك إجراءً واحدًا، إرسال رسالة عبر Webhook في Discord، مع محرر مرئي للرسالة. ولا يحتاج إلى تطبيق Discord ولا إلى حساب Discord على الحاسوب الذي يشغّل Macro Deck.
ما يمكنك إرساله
يحتوي المحرر على أربع علامات تبويب:
- الرسالة: نص الرسالة مع Markdown الخاص بـ Discord وفواصل الأسطر، إضافةً إلى أزرار تُدرج إشارة إلى مستخدم أو دور، أو
@everyoneأو@here. - التضمينات: حتى 10 عناصر مضمّنة، لكل منها عنوان ورابط للعنوان ووصف ولون وطابع زمني ومؤلف وتذييل وصورة وصورة مصغّرة وحتى 25 حقلًا يمكن عرضها جنبًا إلى جنب.
- الملف الشخصي: اسم مستخدم وصورة رمزية لهذه الرسالة بدلًا من اسم الـ Webhook وصورته.
- الإشارات: من يمكن أن تنبّهه الإشارات الموجودة في الرسالة.
افتراضيًا لا تنبّه الرسالة أحدًا، حتى عندما تشير إلى شخص ما أو إلى @everyone أو @here. تظل الإشارة ظاهرة في Discord، لكنها لا ترسل تنبيهًا. تقبل جميع حقول النص متغيرات القوالب، التي تُملأ عند تشغيل الإجراء، لذا يمكن أن تحمل الرسالة المشهد الحالي أو الأغنية الحالية أو عدد المشاهدين.
تتغيّر المعاينة أسفل المحرر أثناء الكتابة وتعرض الرسالة كما يرسمها Discord. ولا ترسل أي شيء إلى Discord أبدًا. تظهر الصور كعناصر نائبة، وتظهر المتغيرات كما كتبتها. يرسل إرسال رسالة تجريبية الرسالة إلى Discord فورًا بعد أن تؤكد باستخدام إرسال الآن، لتتحقق من شكلها الحقيقي.
بعض أمثلة الإعداد:
- زر البث مباشر الآن ينشر عنصرًا مضمّنًا يحمل عنوان بثك ورابطه في قناة الإعلانات.
- زر ينشر الأغنية التي تُشغَّل حاليًا في قناة موسيقى.
- أتمتة ترسل رسالة إلى قناة المشرفين عندما يحدث شيء في بثك.
الـ Webhooks المحفوظة وعناوين URL المخصصة
أضف تهيئة واحدة لكل قناة، ثم اختر الـ Webhook باسمه في كل إجراء. وعندما يتغيّر عنوان URL، تغيّره في مكان واحد. ولرسالة لمرة واحدة، يمكنك أيضًا ضبط Webhook على عنوان URL مخصص ولصق عنوان URL في الإجراء. يخزّن Macro Deck كل عنوان URL لـ Webhook مشفّرًا، ولا يعرضه مرة أخرى أبدًا ولا يكتبه في السجل أبدًا.
يتحقق Macro Deck من حدود Discord قبل الإرسال، مثل 2000 حرف لنص الرسالة و6000 حرف في جميع العناصر المضمّنة معًا، ويسرد أي مشكلة فوق المعاينة أثناء التحرير. وعندما يحدّ Discord من عدد مرات النشر المسموح بها لـ Webhook، ينتظر Macro Deck ويحاول مرة أخرى إذا كان الانتظار 5 ثوانٍ أو أقل.
ما تحتاج إليه
- Macro Deck 3 على Windows أو macOS أو Linux
- اتصال بالإنترنت على الحاسوب الذي يشغّل Macro Deck
- قناة Discord يمكنك فيها إدارة Webhooks، وعنوان URL الخاص بـ Webhook لها
خطوات الإعداد
الخطوة 1: أنشئ Webhook في Discord
في Discord، افتح إعدادات القناة، وانتقل إلى Integrations ثم Webhooks، وأنشئ Webhook أو اختر واحدًا موجودًا. انقر Copy Webhook URL. يبدأ عنوان URL بـ
https://discord.com/api/webhooks/. يستطيع أي شخص يملكه النشر في القناة، لذا تعامل معه ككلمة مرور.الخطوة 2: افتح Webhooks في Discord في Macro Deck
في Macro Deck، انقر التكاملات في الشريط الجانبي ثم انقر Webhooks في Discord. في علامة التبويب نظرة عامة، انقر إضافة تهيئة في قسم الإعدادات. يفتح تشغيل المفتاح في أعلى اليسار النافذة نفسها.
الخطوة 3: احفظ الـ Webhook
املأ نافذة إضافة Webhook في Discord:
- الاسم: يظهر عند اختيار الـ Webhook في إجراء، مثل اسم القناة.
- عنوان URL الخاص بالـ Webhook: عنوان URL الذي نسخته في Discord.
انقر متابعة. أضف تهيئة واحدة لكل قناة إضافية.
الخطوة 4: أضف الإجراء إلى زر
في صفحة اللوحة، انقر الزر الذي تريد استخدامه. يجب أن تكون اللوحة غير مقفلة: عندما يظهر على الزر في أعلى اليسار قفل، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر Webhooks في Discord على يمين نافذة إضافة إجراء، ثم اختر إرسال رسالة عبر Webhook في Discord.
الخطوة 5: اكتب الرسالة
اختر الـ Webhook المحفوظ ضمن Webhook. اكتب نص الرسالة في علامة التبويب الرسالة، وأضف عناصر مضمّنة في علامة التبويب التضمينات إن أردت. تحقق من المعاينة، ثم انقر إرسال رسالة تجريبية وإرسال الآن لرؤية الرسالة في Discord.
الخطوة 6: اضغط الزر
اضغط الزر على هاتفك أو جهازك اللوحي أو في عميل الويب. تظهر الرسالة في قناة Discord مع ملء أي متغيرات. وإن لم تظهر، يعرض الإجراء السبب، مثل أن Discord رفض رمز الـ Webhook.
الإجراءات1
ضعها على زر أو شغّلها من تدفق.
- إرسال رسالة عبر Webhook في Discord
- يرسل رسالة مع عناصر مضمّنة اختيارية عبر Webhook محفوظ أو مخصص في Discord، تُحرَّر مع معاينة مباشرة.
الأسئلة الشائعة
كيف أشير إلى مستخدم أو دور؟
تحتاج الإشارة إلى معرّف Discord. في Discord، فعّل Developer Mode في الإعدادات المتقدمة، ثم انقر بزر الماوس الأيمن على المستخدم أو الدور واختر Copy ID. في علامة التبويب الإشارات، اختر ما إذا كان لا أحد يُنبَّه، أو كل من أُشير إليه، أو المعرّفات التي تسردها فقط.
ما الفرق عن تكامل Discord؟
يحتوي تكامل Discord على إجراء أقدم هو تنفيذ Webhook بعنصر مضمّن واحد ودون معاينة. ويظل يعمل. يضيف Webhooks في Discord عدة عناصر مضمّنة، والتحكم في الإشارات، وملفًا شخصيًا لكل رسالة، والمعاينة المباشرة.
أين يُخزَّن عنوان URL الخاص بالـ Webhook؟
يخزّنه Macro Deck مشفّرًا على الحاسوب الذي يشغّل Macro Deck. ولا يُعرض مرة أخرى أبدًا، ولا يُكتب في السجل أبدًا، ولا يكون جزءًا من المعاينة أبدًا. لتغييره، أدخله مجددًا. لا تُقبل إلا عناوين Webhook الخاصة بـ Discord على discord.com وdiscordapp.com وptb.discord.com وcanary.discord.com.
لماذا لا يُملأ متغير في رسالتي التجريبية؟
يرسل إرسال رسالة تجريبية المتغيرات كما كُتبت. ولا تُملأ إلا عند تشغيل الإجراء من زر أو أتمتة أو برنامج نصي.
لماذا يفشل الإجراء؟
يعرض الإجراء السبب، مثل أن الرسالة فارغة أو طويلة جدًا، أو أن الـ Webhook لم يعد موجودًا في Discord، أو أن Discord رفض رمز الـ Webhook، أو أن Discord يحدّ من معدل طلبات الـ Webhook. إذا رُفض الرمز، فانسخ عنوان URL الخاص بالـ Webhook مجددًا وأدخله في التهيئة.
هل يمكنني تحرير الرسالة في تطبيق Companion؟
يعرض تطبيق Companion وتطبيقات سطح المكتب الأقدم إعدادات الإجراء البسيطة، مع الرسالة كمفاتيح وقيم مثل content وembeds.0.title، ولا تحفظ التغييرات التي تُجرى في المحرر المرئي. حرّر الرسائل الغنية في تطبيق سطح المكتب الحالي.
