دمج Discord

أضف الـ Agent الخاص بك إلى خوادم Discord باستخدام أوامر slash والرسائل المباشرة.

نظرة عامة

يوفّر دمج Discord ما يلي:

• دعم أوامر slash (/ask)
• محادثات الرسائل المباشرة
• توفّر على مستوى الخادم
• ردود خاصة بكل قناة
• تنسيق الإطارات الغنية (rich embed)
• رسائل مباشرة نصية اختيارية (بلا حاجة إلى بادئة أمر)

المتطلّبات المسبقة

• حساب Discord
• صلاحيات Manage Server على الخادم المستهدف
• الوصول إلى Discord Developer Portal

خطوات الإعداد

1. أنشئ تطبيق Discord

1. انتقل إلى Discord Developer Portal
2. انقر على New Application
3. أدخل اسمًا (مثل “My Support Bot”)
4. انقر على Create

2. احصل على بيانات الاعتماد الخاصة بك

من Discord Developer Portal، اجمع هذه القيم:

3. اربطه بـ Cuneiform Chat

1. انتقل إلى Integrations في الشريط الجانبي
2. افتح بطاقة Discord
3. أدخل Application ID وPublic Key وBot Token
4. أدخل اختياريًا Guild ID للتسجيل الفوري لأوامر slash
5. انقر على Connect

4. اضبط عنوان الـ Webhook (مطلوب)

بعد الربط، سترى مربّع حوار نجاح مع Webhook URL الخاص بك:

1. انسخ Webhook URL من مربّع حوار النجاح
2. في Discord Developer Portal، انتقل إلى General Information
3. اعثر على Interactions Endpoint URL
4. الصق عنوان الـ webhook وانقر على Save Changes

5. أضف الروبوت إلى خادمك

استخدم زر Add to Server على بطاقة الدمج، أو استخدم عنوان الدعوة المقدّم بعد الاتصال. يضيف هذا الروبوت بالصلاحيات المطلوبة.

استخدام الروبوت

أوامر slash

يتفاعل المستخدمون مع روبوتك باستخدام أمر slash /ask:

/ask What are your business hours?

يعالج الروبوت السؤال ويردّ في القناة.

الرسائل المباشرة

راسل الروبوت مباشرةً للمحادثات الخاصة:

1. اعثر على الروبوت في قائمة أعضاء خادمك
2. انقر بزرّ الفأرة الأيمن واختر Message
3. استخدم أمر /ask أو فعّل Text DMs (راجع أدناه)

مفتاح تبديل Text DMs

يتحكّم مفتاح Text DMs على بطاقة الدمج في سلوك الرسائل المباشرة:

• Off (افتراضي): يجب على المستخدمين استخدام أمر /ask في الرسائل المباشرة
• On: يمكن للمستخدمين إرسال رسائل نصية عادية في الرسائل المباشرة (بلا حاجة إلى بادئة أمر)

تنسيق الرد

تُنشَر الردود كرسائل نصية عادية. تُقسَّم الإجابات الطويلة تلقائيًا عبر رسائل متعدّدة لتلائم حدّ Discord البالغ 2,000 حرف لكل رسالة.

الميزات

وصول على مستوى الخادم

بمجرّد إضافته، يصبح الروبوت متاحًا في كل القنوات النصية التي لديه صلاحيات فيها.

دعم السلاسل (Threads)

يمكن للروبوت الرد في السلاسل، ما يبقي المحادثات منظّمة.

الأوامر الفورية مقابل العالمية

• مع Guild ID: تُسجَّل أوامر slash فورًا في ذلك الخادم
• بدون Guild ID: تستغرق الأوامر العالمية حتى ساعة واحدة للانتشار

إدارة روبوتك

يعرض كل روبوت مرتبط:

• اسم مستخدم الروبوت والحالة (Active/Error)
• Application ID
• الـ Agent المرتبط
• طابع زمني لـ Last activity
• Webhook URL (للمرجع)

الإجراءات المتاحة

استكشاف الأخطاء وإصلاحها

الروبوت لا يستجيب

1. تحقّق من ضبط Interactions Endpoint URL في Discord Developer Portal
2. تأكّد من أن للروبوت صلاحيات في القناة
3. تحقّق من صحة الرمز في Cuneiform Chat
4. اختبر أن أوامر slash مسجّلة (/ تُظهر أمرك)

الأوامر لا تظهر

يمكن أن تستغرق أوامر slash حتى ساعة للتسجيل عالميًا. للاختبار الفوري:

• قدّم Guild ID أثناء الإعداد للتسجيل الفوري
• انتظر الانتشار العالمي إذا لم يُقدَّم Guild ID

أخطاء الصلاحيات

تأكّد من أن للروبوت هذه الصلاحيات:

• Send Messages
• Use Slash Commands
• Embed Links
• Read Message History (لدعم السلاسل)

Text DMs لا تعمل

1. تحقّق من تفعيل مفتاح Text DMs على بطاقة الدمج
2. فعّل Message Content Intent في Discord Developer Portal ← قسم Bot
3. أعد تشغيل اتصال الروبوت إذا لزم الأمر

الأمان

• تُشفَّر رموز الروبوت وتُخزَّن بأمان
• تستخدم الأوامر التحقّق المدمج من التوقيع في Discord
• لا يُتاح الوصول إلى أي بيانات خادم تتجاوز التفاعلات المباشرة

قطع الاتصال

لإزالة دمج Discord:

1. انتقل إلى Integrations في الشريط الجانبي
2. انقر على القائمة ثلاثية النقاط على روبوت Discord الخاص بك
3. اختر Disconnect

لإزالة الروبوت بالكامل من Discord:

1. انتقل إلى إعدادات خادم Discord الخاص بك
2. انتقل إلى Integrations ← أزل الروبوت