دليل الإعداد · Slack
ربط Slack بتطبيقك الخاص: خطوة بخطوة
تنشئ التطبيق داخل مساحة عمل Slack الخاصة بك، فتملكه مساحة عملك مع بيانات اعتماده. يستغرق الأمر نحو عشر دقائق ويحتاج شخصين، أو شخصاً واحداً يجمع الدورين: مسؤول Slack يحق له تثبيت التطبيقات، ومسؤول في أهلاً حمد لديه صلاحية الإعدادات. كل اسم أدناه هو ما ستراه على الشاشة.
آخر تحديث: 20 أكتوبر 2026
1. قبل أن تبدأ
- موافقات Slack متاحة لكل الشركات. تجدها في أهلاً حمد ضمن التكاملات ← Slack، ويحتاج الربط إلى مسؤول لديه صلاحية الإعدادات.
- تحتاج في Slack إلى صلاحية إنشاء التطبيقات وتثبيتها في مساحة العمل. في كثير من المساحات يكون ذلك مالك المساحة أو مسؤولها.
- ثبّت التطبيق في مساحة عمل واحدة. التثبيت على مستوى المؤسسة في Enterprise Grid غير مدعوم.
2. في أهلاً حمد: نزّل ملف الإعداد
- افتح التكاملات ← Slack واضغط ابدأ الإعداد.
- اضغط تنزيل ملف الإعداد. يحتوي الملف على روابط الطلبات الثلاثة الخاصة بشركتك (الأحداث والتفاعل والأمر
/hamad) والصلاحيات التي يحتاجها التطبيق.
روابط الطلبات خاصة بشركتك. هي تخبر أهلاً حمد فقط لأي شركة تخص الرسالة، وتُفحص كل رسالة بعد ذلك بسر التوقيع (Signing Secret) الخاص بتطبيقك قبل تنفيذ أي شيء.
3. في Slack: أنشئ التطبيق من ملف الإعداد
- افتح api.slack.com/apps واضغط Create New App.
- اختر From a manifest ثم مساحة عملك واضغط Next.
- الصق ملف الإعداد (تبويب JSON) واضغط Next، وراجع الملخص ثم اضغط Create.
قد يظهر في Slack أن رابط Event Subscriptions لم يُتحقق منه بعد. هذا متوقع: لا يستطيع أهلاً حمد الرد على فحص Slack إلا بعد أن تربط في الخطوة 5.
4. في Slack: ثبّت التطبيق وانسخ قيمتين
- في التطبيق الجديد افتح Install App واضغط Install to Workspace ثم Allow.
- افتح OAuth & Permissions وانسخ Bot User OAuth Token، وهو يبدأ بـ
xoxb-. - افتح Basic Information ثم App Credentials وانسخ Signing Secret (اضغط Show).
لا تحتاج إلى Client ID ولا Client Secret ولا رابط إعادة توجيه. يُثبَّت التطبيق من صفحة إعداداته، فلا يوجد تسجيل دخول بإعادة توجيه.
5. في أهلاً حمد: اربط
- ارجع إلى التكاملات ← Slack والصق رمز البوت وسر التوقيع.
- اضغط ربط تطبيق Slack الخاص بي. يتحقق أهلاً حمد من الرمز لدى Slack قبل حفظه.
- في Slack افتح Event Subscriptions. إذا ظهر الرابط غير متحقق منه، اضغط Retry فيظهر Verified.
بعدها يُطابَق أعضاء Slack مع الموظفين عبر بريدهم الموثّق في Slack، ويمكنك تعديل أي مطابقة من جدول الأعضاء في الصفحة نفسها.
ما يستطيع التطبيق فعله في مساحة عملك
| الصلاحية | السبب |
|---|---|
chat:write | إرسال الطلب لكل معتمِد مع زري الموافقة والرفض، وتحديثه بعد البت فيه. |
im:write | فتح الرسالة المباشرة مع المعتمِد. |
commands | الأمر /hamad: رصيد الإجازات والموافقات وطلبات الإجازة والمساعدة. |
users:read | قراءة قائمة الأعضاء لمطابقتهم مع الموظفين. |
users:read.email | المطابقة عبر البريد الموثّق. |
لا يطلب التطبيق صلاحية قراءة القنوات، ولا يقرأ رسائلكم.
كيف نحفظ بيانات اعتمادك
- يُحفظ الرمز وسر التوقيع مشفّرين ولا يظهران مرة أخرى لأي أحد، حتى للمسؤولين.
- يُفحص كل طلب من Slack بسر التوقيع الخاص بك ويجب ألا يزيد عمره على خمس دقائق (Slack: التحقق من الطلبات). ويُرفض أي طلب يخص مساحة عمل غير مساحتك.
- لا تُربط مساحة عمل Slack إلا بشركة واحدة في أهلاً حمد.
6. حل المشكلات
| الرسالة | ماذا تفعل |
|---|---|
| هذا ليس رمز بوت. انسخ Bot User OAuth Token، وهو يبدأ بـ xoxb-. | لصقت رمزاً آخر (رمز المستخدم يبدأ بـ xoxp-). انسخ الرمز من OAuth & Permissions ثم Bot User OAuth Token. |
| هذا ليس سر توقيع. انسخ Signing Secret من Basic Information ثم App Credentials (32 حرفاً ورقماً). | انسخ Signing Secret وليس Client Secret ولا Verification Token. |
| لم يقبل Slack هذا الرمز. تأكد أن التطبيق مثبت في مساحة عملك، ثم انسخ الرمز مرة أخرى. | أعد تثبيت التطبيق (Install App ثم Reinstall to Workspace) وانسخ الرمز الجديد. |
| مساحة عمل Slack هذه مربوطة بشركة أخرى في أهلاً حمد. | افصلها عن الشركة الأخرى أولاً، أو تواصل معنا. |
7. قطع الاتصال
- في أهلاً حمد اضغط قطع الاتصال بتطبيق Slack. يُلغى الرمز لدى Slack ويُحذف سر التوقيع، فتتوقف روابط الطلبات فوراً.
- إذا لم تعد تحتاج التطبيق فاحذفه من Slack أيضاً: Basic Information ثم Delete App.
مراجع Slack المستخدمة في هذا الدليل
- ملفات إعداد التطبيقات (App manifests)
- أنواع الرموز (Token types)
- التحقق من الطلبات القادمة من Slack
- auth.test وauth.revoke
- صلاحيات Slack (Scopes)
- Slack علامة تجارية لمالكها، وأهلاً حمد غير تابع لـ Slack.