دمج Slack

أضف الـ Agent الخاص بك إلى مساحات عمل Slack للوصول على مستوى الفريق.

نظرة عامة

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

• دعم أوامر slash (/ask)
• محادثات الرسائل المباشرة
• الإشارات في القنوات (mentions)
• توفّر على مستوى مساحة العمل

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

• صلاحيات مسؤول مساحة عمل Slack أو صلاحيات تثبيت التطبيقات
• حساب Cuneiform Chat مع Agent نشط

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

1. ابدأ إعداد الدمج

1. انتقل إلى Integrations في الشريط الجانبي
2. افتح بطاقة Slack
3. انقر على Add to Slack

2. صرّح للتطبيق

1. اختر مساحة العمل المراد تثبيتها
2. راجع الصلاحيات
3. انقر على Allow

3. تحقّق من التثبيت

1. افتح Slack
2. جرّب أمر slash: /ask Hello
3. تحقّق من حصولك على رد

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

أوامر slash

استخدم أمر /ask في أي قناة:

/ask What is our refund policy?

يظهر الرد في القناة.

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

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

1. اعثر على التطبيق في الشريط الجانبي في Slack
2. افتح رسالة مباشرة
3. تحدّث بشكل طبيعي

الإشارات في القنوات

أشِر إلى الروبوت في القنوات لطرح الأسئلة:

@YourBot What are the shipping options?

الميزات

وصول على مستوى مساحة العمل

بمجرّد التثبيت، يصبح الروبوت متاحًا لكل أعضاء مساحة العمل.

ردود السلاسل (Threads)

يمكن نشر الردود في السلاسل لإبقاء القنوات منظّمة.

التنسيق الغني

تدعم الردود تنسيق Slack:

• نص غامق ومائل
• روابط
• كتل كود
• قوائم

خيارات الإعداد

من بطاقة دمج Slack يمكنك:

دعم مساحات العمل المتعدّدة

يمكنك تثبيت الـ Agent نفسه على مساحات عمل Slack متعدّدة:

1. تتطلّب كل مساحة عمل تصريحًا منفصلًا
2. تتشارك كل مساحات العمل نفس الـ Agent والمحتوى
3. تُتتبّع المحادثات بشكل منفصل لكل مساحة عمل

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

Command Not Found

إذا لم يعمل /ask:

1. تحقّق من تثبيت التطبيق في مساحة عملك
2. تحقّق من أن للتطبيق الصلاحيات المناسبة
3. جرّب إعادة تثبيت عملية الدمج

لا يوجد رد

إذا لم يستجب الروبوت:

1. تحقّق من أن الـ Agent الخاص بك مُعدّ ويعمل (اختبر في الـ Playground)
2. تحقّق من أن دمج Slack مرتبط
3. تأكّد من أن للروبوت وصولًا إلى القناة

مشكلات الصلاحيات

يطلب تطبيق Slack نطاقات OAuth هذه (مُعدّة مسبقًا — تمنحها جميعًا عند النقر على Allow أثناء التثبيت):

• commands — لأوامر slash
• chat:write — لإرسال الرسائل
• chat:write.customize — إرسال رسائل باسم مستخدم/أيقونة مخصّصة
• app_mentions:read — لإشارات @
• im:history — قراءة سجلّ الرسائل المباشرة للسياق
• channels:history — قراءة سجلّ القنوات العامة للسياق
• channels:read — سرد القنوات العامة
• groups:history — قراءة سجلّ القنوات الخاصة للسياق
• mpim:history — قراءة سجلّ الرسائل المباشرة الجماعية للسياق
• users:read — تحليل أسماء المستخدمين
• canvases:write — إنشاء وتعديل لوحات Slack (canvases)
• assistant:write — بذر موجّهات مقترحة في جزء Agents & AI Apps

الأمان

• تُشفَّر رموز OAuth
• لا وصول إلى الرسائل باستثناء الأوامر/الإشارات الصريحة
• تبقى بيانات مساحة العمل خاصة

قطع الاتصال

لإزالة دمج Slack:

1. من Cuneiform Chat:

   • Integrations (الشريط الجانبي) ← Slack ← Disconnect

2. من Slack:

   • انتقل إلى إعدادات مساحة العمل
   • Apps ← اعثر على التطبيق ← Remove

تضمن كلتا الخطوتين الإزالة الكاملة.