Slack — Team AI Assistant

سلاك — مساعد الفريق الذكي

إذا كنت يومًا ما تمنيت أن يكون لفريقك مساعد لا يكلّ ولا يملّ، يقتحم سلاك ليجيب على الأسئلة، وينفّذ الأوامر، ويساعد في المهام على مدار الساعة — فإن Hermes Agent هو بالضبط ما تبحث عنه. والتحديث الأخير جعل ربط Hermes بسلاك أسهل من أي وقت مضى.

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

ما الجديد في تكامل سلاك؟

الخبر الكبير: تطبيقات سلاك الكلاسيكية ولّت. اعتبارًا من مارس 2025، أوقفت سلاك نهائيًا واجهة RTM القديمة التي كانت تعتمد عليها الكثير من البوتات. انتقل Hermes إلى Bolt SDK مع Socket Mode الحديث، وهذا يجلب ميزتين كبيرتين:

• لا حاجة لعنوان URL عام — يتصل Hermes عبر WebSocket، لذا يعمل خلف جدران الحماية، على حاسوبك المحمول، أو على خادم خاص.
• أكثر موثوقية — يستخدم Socket Mode اتصالًا مستمرًا مصممًا لسلاك اليوم.

إذا كان لديك تطبيق كلاسيكي قديم، فستحتاج إلى إنشاء تطبيق جديد. لا تقلق — العملية الجديدة أبسط في الواقع.

الخطوة 1: إنشاء تطبيق سلاك (الطريقة السهلة)

أسرع طريق هو ترك Hermes يولّد لك ملف manifest. هذا ملف JSON يعلن عن كل أمر slash مدمج (/btw، /stop، /model، والمزيد)، وجميع نطاقات OAuth المطلوبة، واشتراكات الأحداث، وSocket Mode — كل ذلك دفعة واحدة.

شغّل هذا الأمر:

hermes slack manifest --agent-view --write

هذا يكتب الملف إلى ~/.hermes/slack-manifest.json ويطبع تعليمات اللصق. ثم:

1. اذهب إلى https://api.slack.com/apps
2. انقر Create New App ← From an app manifest
3. اختر مساحة العمل الخاصة بك، والصق JSON، وراجع، ثم انقر Create

هذا كل شيء — الملف يتولى عنك النطاقات والأحداث وأوامر slash. يمكنك الانتقال مباشرة إلى تثبيت التطبيق.

نصيحة: إذا كنت تريد وصفًا أطول للتطبيق، أضف --long-description-file AGENTS.md لسحب النص من ملف موجود.

الخطوة 2: تكوين نطاقات توكن البوت

إذا كنت تفضّل بناء التطبيق يدويًا، فستحتاج إلى إضافة النطاقات الصحيحة تحت Features → OAuth & Permissions → Bot Token Scopes.

إليك الأساسيات:

النطاق	لماذا هو مهم
chat:write	إرسال الرسائل كبوت
app_mentions:read	اكتشاف عندما يتم @mention
channels:history	قراءة الرسائل في القنوات العامة
groups:history	قراءة الرسائل في القنوات الخاصة
im:history	قراءة سجل الرسائل المباشرة
files:read	قراءة المرفقات، بما في ذلك الملاحظات الصوتية
files:write	رفع الملفات

تحذير: نقص channels:history و groups:history يعني أن البوت لن يستقبل الرسائل في القنوات — سيعمل فقط في الرسائل المباشرة. وبدون files:read، لا يمكن لـ Hermes قراءة الملفات التي يرفعها فريقك بشكل موثوق. هذه هي النطاقات الأكثر نسيانًا.

هناك أيضًا نطاق اختياري يستحق الإضافة: assistant:write. هذا يتيح لـ Hermes إظهار حالة “يفكّر…” مخصصة بجانب اسم البوت أثناء معالجته للرسالة. بدونها، تعرض سلاك مؤشراتها العامة الافتراضية.

الخطوة 3: تفعيل Socket Mode

Socket Mode هو ما يتيح لـ Hermes الاتصال دون عنوان URL عام.

1. اذهب إلى Settings → Socket Mode
2. فعّل Enable Socket Mode إلى ON
3. أنشئ App-Level Token مع نطاق connections:write
4. انسخ التوكن — يبدأ بـ xapp-. هذا هو SLACK_APP_TOKEN الخاص بك

يمكنك دائمًا العثور على توكنات مستوى التطبيق أو إعادة توليدها تحت Settings → Basic Information → App-Level Tokens.

الخطوة 4: الاشتراك في الأحداث

هذه الخطوة حاسمة — فهي تتحكم في الرسائل التي يمكن للبوت رؤيتها.

اذهب إلى Features → Event Subscriptions، وفعّل Enable Events إلى ON، وأضف هذه الأحداث:

الحدث	مطلوب؟	الغرض
message.im	نعم	استقبال الرسائل المباشرة
message.mpim	نعم	استقبال الرسائل الجماعية المباشرة
message.channels	نعم	استقبال رسائل القنوات العامة
message.groups	موصى به	استقبال رسائل القنوات الخاصة
app_mention	نعم	يمنع أخطاء Bolt SDK

تنبيه: نقص اشتراكات الأحداث هو المشكلة رقم 1 في الإعداد. إذا كان بوتك يعمل في الرسائل المباشرة لكن ليس في القنوات، فهذا هو السبب شبه المؤكد.

أفكار ختامية

مع Socket Mode، أصبح نشر Hermes أسهل من أي وقت مضى — يمكنك تشغيله على حاسوب محمول، أو Raspberry Pi، أو خادم خاص، وسيبقى متصلًا بسلاك فريقك.

تدفق manifest الجديد يعني أنك تستطيع الانتقال من الصفر إلى بوت مكوّن بالكامل في دقائق. فقط ولّد، والصق، وثبّت.

مستعد لتمنح فريقك مساعدًا ذكيًا يظهر فعلًا؟ هيّئ Hermes على سلاك اليوم.