# المراسلة الفورية (/ar/docs/verdent-manager/core-features/instant-messaging)

> تكليف Manager بالعمل من Telegram أو Slack أو Feishu



لست مضطرًا إلى التواجد أمام حاسوبك لتكليف Manager بالعمل. فمن خلال ربط Telegram أو Slack أو Feishu، يمكنك إرسال رسائل إلى Manager في أي وقت ومن أي مكان باستخدام أدوات الدردشة المعتادة. يحوّل Manager رسائلك إلى مهام منظمة ويبدأ بتنفيذها — دوّن فكرة أثناء تصفح هاتفك، وعُد لاحقًا لمشاهدة النتيجة.

## المنصات المدعومة للمراسلة الفورية [#المنصات-المدعومة-للمراسلة-الفورية]

| المنصة   | النوع         |
| -------- | ------------- |
| Telegram | بوت شخصي      |
| Slack    | بوت مساحة عمل |
| Feishu   | بوت مؤسسي     |

تتطلب كل منصة إنشاء بوت في وحدة تحكم المطورين الخاصة بها، ثم إتمام الإقران في Verdent. وبعد الاتصال، يتم توجيه أي رسالة ترسلها إلى البوت مباشرة إلى Manager.

***

## عملية الاتصال [#عملية-الاتصال]

تتكون عملية الاتصال من مرحلتين:

1. **إدخال الرمز** — إعداد بيانات الاعتماد
2. **إرسال رسالة للإقران** — ربط البوت بـ Manager

يتم تكوين كل ذلك في صفحة إعدادات القناة في الشريط الجانبي لـ Manager.

### كيفية الوصول إلى الإعداد [#كيفية-الوصول-إلى-الإعداد]

<Steps>
  <Step title="فتح إضافة قناة">
    في الشريط الجانبي الأيسر لـ Manager، حدد زر &#x2A;*+** في الأعلى (إضافة قناة).
  </Step>

  <Step title="اختيار منصة">
    اختر المنصة التي تريد ربطها (Telegram أو Slack أو Feishu).
  </Step>

  <Step title="اتباع الخطوات الموجّهة">
    أكمل الإعداد ذا المرحلتين في اللوحة الجانبية.
  </Step>
</Steps>

***

## إعداد Telegram [#إعداد-telegram]

### المرحلة 1: إنشاء بوت والحصول على الرمز [#المرحلة-1-إنشاء-بوت-والحصول-على-الرمز]

<Steps>
  <Step title="إرسال رسالة إلى BotFather">
    ابحث عن [@BotFather](https://t.me/BotFather) على Telegram وأرسل `/newbot`.
  </Step>

  <Step title="تسمية البوت">
    اتبع التعليمات لتقديم اسم عرض واسم مستخدم.
  </Step>

  <Step title="نسخ الرمز">
    بعد الإنشاء، يعيد BotFather رمزًا بالصيغة `123456:ABC-DEF1234...`.
  </Step>

  <Step title="اللصق في Verdent">
    الصق الرمز في حقل **Bot Token** في لوحة إعداد Verdent وأكّد.
  </Step>
</Steps>

### المرحلة 2: إقران الرسائل [#المرحلة-2-إقران-الرسائل]

<Steps>
  <Step title="إرسال رسالة">
    افتح بوتك الجديد في Telegram وأرسل أي رسالة (على سبيل المثال، `hello`).
  </Step>

  <Step title="تلقي رمز الإقران">
    يرد البوت تلقائيًا برمز إقران.
  </Step>

  <Step title="التأكيد في Verdent">
    أدخل الرمز في لوحة Verdent وأكّد. يكتمل الاتصال الآن.
  </Step>
</Steps>

***

## إعداد Slack [#إعداد-slack]

### المرحلة 1: إنشاء تطبيق Slack والحصول على الرموز [#المرحلة-1-إنشاء-تطبيق-slack-والحصول-على-الرموز]

<Steps>
  <Step title="إنشاء تطبيق جديد">
    انتقل إلى [api.slack.com/apps](https://api.slack.com/apps) وحدد **Create New App**.
  </Step>

  <Step title="استخدام البيان (manifest) المتوفر">
    اختر **From an app manifest** ثم الصق بيان JSON الذي يوفره Verdent (يتوفر زر نسخ في الواجهة).
  </Step>

  <Step title="اختيار مساحة عمل">
    اختر مساحة عمل Slack وأنشئ التطبيق.
  </Step>

  <Step title="نسخ كلا الرمزين">
    في إعدادات التطبيق، حدد موقع **Bot Token** (`xoxb-`) و **App Token** (`xapp-`)، ثم الصقهما في لوحة إعداد Verdent.
  </Step>
</Steps>

<Note>
  **متطلبات اسم التطبيق:** يجب أن يكون الاسم أقل من 80 حرفًا وألا يحتوي على أحرف صينية أو يابانية أو كورية.
</Note>

### المرحلة 2: إقران الرسائل [#المرحلة-2-إقران-الرسائل-1]

كما هو الحال مع Telegram: أرسل رسالة إلى البوت، واستلم رمز الإقران، ثم أدخله في Verdent لإتمام الاتصال.

***

## إعداد Feishu [#إعداد-feishu]

يتطلب Feishu بضع خطوات إضافية مقارنة بـ Telegram أو Slack — يتم تكوين الأذونات بشكل منفصل، ويجب الاشتراك في الأحداث يدويًا. الأمر ليس معقدًا، لكن يجب تنفيذ كل خطوة بشكل صحيح، وإلا فسيتوقف الاتصال. اتبع الخطوات بالترتيب.

### الخطوة 1: إنشاء تطبيق مخصص [#الخطوة-1-إنشاء-تطبيق-مخصص]

<Steps>
  <Step title="فتح وحدة تحكم المطورين">
    انتقل إلى [منصة Feishu المفتوحة](https://open.feishu.cn/app) وسجّل الدخول بحساب Feishu الخاص بك.
  </Step>

  <Step title="إنشاء تطبيق مخصص">
    حدد **Create Custom App** في الزاوية العلوية اليمنى.
  </Step>

  <Step title="تعبئة المعلومات الأساسية">
    أدخل اسم التطبيق ووصفه، ثم أكمل الإنشاء.
  </Step>
</Steps>

### الخطوة 2: تكوين الأذونات [#الخطوة-2-تكوين-الأذونات]

افتح التطبيق الجديد وانتقل إلى **Permissions & Scopes** في القائمة اليسرى.

يدعم Feishu استيراد الأذونات (scopes) بشكل مجمّع، حتى لا تضطر إلى تحديدها واحدة تلو الأخرى. ابحث عن خيار الاستيراد/التصدير المجمّع في الصفحة والصق كود JSON التالي بالكامل:

```json
{
  "scopes": {
    "tenant": [
      "im:message:send_as_bot",
      "im:message",
      "im:resource",
      "im:chat",
      "im:chat:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "wiki:wiki:readonly",
      "application:application:self_manage"
    ],
    "user": []
  }
}
```

بعد تأكيد الاستيراد، يجب أن تظهر جميع الأذونات المذكورة أعلاه محددة في قائمة الأذونات.

### الخطوة 3: الحصول على بيانات الاعتماد والاتصال بـ Verdent [#الخطوة-3-الحصول-على-بيانات-الاعتماد-والاتصال-بـ-verdent]

افتح **Credentials & Basic Info** في القائمة اليسرى:

<Steps>
  <Step title="نسخ App ID و App Secret">
    انسخ **App ID** (بالصيغة `cli_xxx...`) و **App Secret**.
  </Step>

  <Step title="اللصق في Verdent">
    الصق كلتا القيمتين في الحقول المطابقة في لوحة إعداد Verdent.
  </Step>

  <Step title="الاتصال">
    حدد **Connect** لإتمام المرحلة الأولى.
  </Step>
</Steps>

### الخطوة 4: تمكين الاتصال الطويل [#الخطوة-4-تمكين-الاتصال-الطويل]

بعد الاتصال، عد إلى منصة Feishu المفتوحة وافتح **Events & Callbacks**.

فعّل **Use Long Connection to Receive Events**. يتحكم هذا المفتاح في كيفية تسليم Feishu للرسائل إلى البوت — لا يتطلب الاتصال الطويل منك كشف عنوان URL عام؛ بل يحافظ على اتصال دائم بدلاً من ذلك، وهو أكثر موثوقية.

### الخطوة 5: الاشتراك في أحداث الرسائل والنشر [#الخطوة-5-الاشتراك-في-أحداث-الرسائل-والنشر]

لا تزال في صفحة **Events & Callbacks**:

<Steps>
  <Step title="إضافة حدث الرسالة">
    حدد **Add Event**، ثم ابحث عن `im.message.receive_v1` (حدث استلام الرسالة) وأضفه.
  </Step>

  <Step title="إنشاء ونشر إصدار">
    حدد **Create and Publish Version** في الزاوية العلوية اليمنى، وأدخل ملاحظات الإصدار، ثم أكّد.
  </Step>

  <Step title="الإقران مع Verdent">
    بعد النشر، عد إلى Verdent وأرسل رسالة إلى بوت Feishu الخاص بك لإتمام الإقران.
  </Step>
</Steps>

### ما تفعله كل إذن [#ما-تفعله-كل-إذن]

| الإذن                                               | الغرض                                                                                            |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| مجموعة `im:message:*`                               | يتيح للبوت قراءة وإرسال الرسائل، بما في ذلك الرسائل المباشرة والإشارات (@ mentions) في المجموعات |
| `im:chat:*`                                         | يقرأ قائمة المحادثات التي ينتمي إليها البوت                                                      |
| `im:resource`                                       | يقرأ الصور والملفات والموارد الأخرى المرفقة بالرسائل                                             |
| `contact:*`                                         | يقرأ معلومات الاتصال الأساسية لتحديد من أرسل الرسالة                                             |
| `docs:document.content:read` / `wiki:wiki:readonly` | يقرأ محتوى Feishu Docs و Wiki، حتى يمكن تمرير روابط المستندات إلى Manager كسياق                  |
| `application:application:self_manage`               | يدير تكوين التطبيق الخاص به؛ مطلوب لقدرة الاتصال الطويل                                          |

***

## بعد نجاح الاتصال [#بعد-نجاح-الاتصال]

بعد الإقران، تظهر القناة في قائمة القنوات في الشريط الجانبي الأيسر لـ Manager، وتعرض:

* أيقونة المنصة واسم القناة
* حالة الاتصال (**Connected** / **Disconnected** / **Needs attention**)
* معاينة الرسالة الأخيرة وطابعها الزمني
* مؤشر الرسائل غير المقروءة (نقطة خضراء)

من هذه اللحظة فصاعدًا، تتم معالجة كل رسالة يتم إرسالها إلى البوت مباشرة من قِبل Manager كمهمة قابلة للتنفيذ.

***

## إدارة القنوات المتصلة [#إدارة-القنوات-المتصلة]

* **عرض جميع القنوات** — يتم سرد جميع قنوات المراسلة الفورية المتصلة في الشريط الجانبي.
* **حذف قناة** — مرر مؤشر الفأرة فوق القناة وحدد حذف، ثم أكّد. إذا كانت آخر قناة من هذا النوع، يتم أيضًا مسح تكوين البوت.
* **إعادة الاتصال** — إذا ظهرت القناة بحالة **Disconnected** أو **Needs attention**، يظهر إشعار للإصلاح في الأعلى لإعادة التكوين.

***

## حالات الاستخدام [#حالات-الاستخدام]

<CardGroup cols="3">
  <Card title="مركز القيادة من الهاتف المحمول" icon="mobile">
    أثناء التنقل، أخبر البوت في Telegram: "نشر آخر التغييرات في الفرع main إلى بيئة staging." وبحلول وقت عودتك، تكون النتيجة جاهزة.
  </Card>

  <Card title="التعاون الجماعي" icon="users">
    اذكر بوت Manager الخاص بك في قناة Slack لتلخيص حالات طلبات السحب (PR) لهذا اليوم — تظهر الردود مباشرة في القناة ليراها الفريق بأكمله.
  </Card>

  <Card title="تدوين الأفكار السريع" icon="lightbulb">
    قبل النوم، أرسل فكرة إلى البوت واطلب من Manager تحويلها إلى مهمة لتنفيذها في اليوم التالي.
  </Card>
</CardGroup>