> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تكامل Slack

> اربط Living Security بـ Slack لإرسال إشعارات التدريب والتنبيهات الأمنية وتحديثات دليل التشغيل إلى مساحة العمل الخاصة بك.

يتيح تكامل Slack لـ Living Security إرسال الإشعارات مباشرةً إلى مساحة عمل Slack الخاصة بك. يمكنك إبلاغ المستخدمين بمهام التدريب، وتنبيه فرق الأمن بأحداث المخاطر، وإطلاع المديرين على تقدم فرقهم.

<Note>
  لإعداد تسليم التنبيهات التحفيزية وأدلة التشغيل، ابدأ من **الإعدادات → الاتصالات → القنوات** ثم انقر على بطاقة **Slack**. تتناول هذه الصفحة إعدادات تطبيق Slack الأساسية.
</Note>

## المتطلبات الأساسية

قبل إعداد تكامل Slack، تأكد من توفر ما يلي:

* صلاحيات مسؤول مساحة عمل Slack أو صلاحيات تثبيت التطبيقات
* إمكانية الوصول إلى بوابة Slack API على [api.slack.com](https://api.slack.com)
* صلاحيات مسؤول في Living Security

## إنشاء تطبيق Slack

<Steps>
  <Step title="إنشاء تطبيق Slack جديد">
    1. انتقل إلى [api.slack.com/apps](https://api.slack.com/apps)
    2. انقر على **Create New App**
    3. اختر **From scratch**
    4. أدخل اسمًا للتطبيق (على سبيل المثال: "Living Security")
    5. اختر مساحة العمل الخاصة بك
    6. انقر على **Create App**

    <Check>
      يظهر تطبيقك في لوحة التحكم الخاصة بـ Slack API.
    </Check>
  </Step>

  <Step title="إعداد نطاقات OAuth">
    1. في الشريط الجانبي الأيسر، انقر على **OAuth & Permissions**
    2. مرر إلى **Bot Token Scopes**
    3. أضف النطاقات التالية:

    | النطاق | الغرض |
    | - | - |
    | `chat:write` | إرسال الرسائل إلى القنوات |
    | `chat:write.public` | إرسال الرسائل إلى القنوات دون الانضمام إليها |
    | `users:read` | البحث عن معلومات المستخدم |
    | `users:read.email` | مطابقة المستخدمين حسب عنوان البريد الإلكتروني |

    <Tip>
      أضف فقط النطاقات التي تحتاج إليها مؤسستك. كلما قل عدد النطاقات، زاد مستوى الأمان.
    </Tip>
  </Step>

  <Step title="تثبيت التطبيق في مساحة العمل">
    1. مرر إلى أعلى صفحة **OAuth & Permissions**
    2. انقر على **Install to Workspace**
    3. راجع الصلاحيات ثم انقر على **Allow**

    <Check>
      يظهر **Bot User OAuth Token** الذي يبدأ بـ `xoxb-`.
    </Check>
  </Step>

  <Step title="الحصول على سر التوقيع">
    1. في الشريط الجانبي الأيسر، انقر على **Basic Information**
    2. مرر إلى **App Credentials**
    3. انسخ **Signing Secret**

    <Warning>
      حافظ على سرية سر التوقيع. لا تشاركه أبدًا في المستودعات العامة أو السجلات.
    </Warning>
  </Step>
</Steps>

## إضافة بيانات الاعتماد إلى Living Security

<Steps>
  <Step title="الانتقال إلى التكاملات الصادرة">
    انتقل إلى **الإعدادات → التكاملات → الصادرة** ثم انقر على بطاقة **Slack**.
  </Step>

  <Step title="إضافة بيانات الاعتماد">
    انقر على **Add Credential** وأدخل ما يلي:

    <ParamField body="botToken" type="string" required>
      رمز Bot User OAuth Token الخاص بك الذي يبدأ بـ `xoxb-`. يوجد في **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      سر التوقيع (Signing Secret) الخاص بتطبيقك. يوجد في **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      اختياري. مطلوب فقط لاتصالات Socket Mode. يبدأ بـ `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      اختياري. اسم مألوف لبيانات الاعتماد هذه (على سبيل المثال: "Production Slack").
    </ParamField>
  </Step>

  <Step title="الحفظ والتحقق">
    انقر على **حفظ**. تظهر بيانات الاعتماد في قائمتك بحالة **نشط**.

    <Check>
      أصبح تكامل Slack متصلًا وجاهزًا لإرسال الإشعارات.
    </Check>
  </Step>
</Steps>

## أنواع الإشعارات

بعد الاتصال، يمكن لـ Living Security إرسال أنواع الإشعارات التالية إلى Slack:

| الإشعار | الوصف |
| - | - |
| مهام التدريب | تنبيه المستخدمين عند تعيين تدريب جديد |
| تذكيرات التدريب | تذكير المستخدمين بالمواعيد النهائية القادمة |
| تأكيدات الإكمال | التأكيد عند إكمال التدريب |
| التنبيهات الأمنية | إبلاغ فرق الأمن بأحداث المخاطر |
| ملخصات دليل التشغيل | إرسال تحديثات دورية حول أداء دليل التشغيل |

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

<AccordionGroup>
  <Accordion title="الرسائل لا تظهر في القنوات">
    * تحقق من أن الروبوت قد دُعي إلى القناة (`/invite @YourBotName`)
    * تأكد من إضافة النطاق `chat:write.public` للنشر في القنوات العامة دون الانضمام إليها
    * تأكد من صحة معرّف القناة (استخدم معرّف القناة وليس اسمها)
  </Accordion>

  <Accordion title="خطأ الرمز غير صالح">
    * تأكد من نسخ الرمز كاملًا بدءًا من `xoxb-`
    * تحقق من أن التطبيق لا يزال مثبتًا في مساحة العمل الخاصة بك
    * تحقق مما إذا كان الرمز قد أُعيد إنشاؤه (يتطلب التحديث في Living Security)
  </Accordion>

  <Accordion title="تقييد المعدل">
    تفرض Slack حدودًا على طلبات API. إذا ظهرت لك أخطاء تجاوز حد المعدل:

    * قلّل وتيرة الإشعارات
    * ادمج عدة إشعارات في رسائل ملخصة
    * تواصل مع الدعم لحالات الاستخدام ذات الحجم الكبير
  </Accordion>
</AccordionGroup>

## أفضل الممارسات

<Tip>
  أنشئ قناة Slack مخصصة لإشعارات Living Security (على سبيل المثال: `#security-training`) للحفاظ على تنظيم التنبيهات وتقليل الضوضاء في القنوات العامة.
</Tip>

* استخدم تسميات واضحة لبيانات الاعتماد عند إدارة عدة مساحات عمل
* راجع بانتظام القنوات التي تتلقى الإشعارات
* اعتمد ملخصات الإشعارات بدلًا من الرسائل الفردية للتنبيهات ذات الحجم الكبير
* راجع صلاحيات تطبيق Slack كل ثلاثة أشهر وأزل النطاقات غير المستخدمة

## ذو صلة

<CardGroup cols={2}>
  <Card title="تكامل البريد الإلكتروني" icon="envelope" href="/ar/integrations/outbound/email">
    إعداد البريد الإلكتروني كقناة تسليم.
  </Card>

  <Card title="تكامل Teams" icon="microsoft" href="/ar/integrations/outbound/teams">
    إعداد Microsoft Teams كقناة تسليم.
  </Card>

  <Card title="سجل الاتصالات" icon="clock-rotate-left" href="/ar/features/communications/log">
    تتبع حالة تسليم Slack وسجله.
  </Card>

  <Card title="كيفية إعداد تكامل جديد" icon="plug" href="/ar/integrations/managing/setup">
    دليل الإعداد العام للتكاملات.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.