Verdent Docs
الميزات الأساسية

المراسلة الفورية

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

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

المنصات المدعومة للمراسلة الفورية

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

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


عملية الاتصال

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

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

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

كيفية الوصول إلى الإعداد

فتح إضافة قناة

في الشريط الجانبي الأيسر لـ Manager، حدد زر + في الأعلى (إضافة قناة).

اختيار منصة

اختر المنصة التي تريد ربطها (Telegram أو Slack أو Feishu).

اتباع الخطوات الموجّهة

أكمل الإعداد ذا المرحلتين في اللوحة الجانبية.


إعداد Telegram

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

إرسال رسالة إلى BotFather

ابحث عن @BotFather على Telegram وأرسل /newbot.

تسمية البوت

اتبع التعليمات لتقديم اسم عرض واسم مستخدم.

نسخ الرمز

بعد الإنشاء، يعيد BotFather رمزًا بالصيغة 123456:ABC-DEF1234....

اللصق في Verdent

الصق الرمز في حقل Bot Token في لوحة إعداد Verdent وأكّد.

المرحلة 2: إقران الرسائل

إرسال رسالة

افتح بوتك الجديد في Telegram وأرسل أي رسالة (على سبيل المثال، hello).

تلقي رمز الإقران

يرد البوت تلقائيًا برمز إقران.

التأكيد في Verdent

أدخل الرمز في لوحة Verdent وأكّد. يكتمل الاتصال الآن.


إعداد Slack

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

إنشاء تطبيق جديد

انتقل إلى api.slack.com/apps وحدد Create New App.

استخدام البيان (manifest) المتوفر

اختر From an app manifest ثم الصق بيان JSON الذي يوفره Verdent (يتوفر زر نسخ في الواجهة).

اختيار مساحة عمل

اختر مساحة عمل Slack وأنشئ التطبيق.

نسخ كلا الرمزين

في إعدادات التطبيق، حدد موقع Bot Token (xoxb-) و App Token (xapp-)، ثم الصقهما في لوحة إعداد Verdent.

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

المرحلة 2: إقران الرسائل

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


إعداد Feishu

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

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

فتح وحدة تحكم المطورين

انتقل إلى منصة Feishu المفتوحة وسجّل الدخول بحساب Feishu الخاص بك.

إنشاء تطبيق مخصص

حدد Create Custom App في الزاوية العلوية اليمنى.

تعبئة المعلومات الأساسية

أدخل اسم التطبيق ووصفه، ثم أكمل الإنشاء.

الخطوة 2: تكوين الأذونات

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

يدعم Feishu استيراد الأذونات (scopes) بشكل مجمّع، حتى لا تضطر إلى تحديدها واحدة تلو الأخرى. ابحث عن خيار الاستيراد/التصدير المجمّع في الصفحة والصق كود 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

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

نسخ App ID و App Secret

انسخ App ID (بالصيغة cli_xxx...) و App Secret.

اللصق في Verdent

الصق كلتا القيمتين في الحقول المطابقة في لوحة إعداد Verdent.

الاتصال

حدد Connect لإتمام المرحلة الأولى.

الخطوة 4: تمكين الاتصال الطويل

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

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

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

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

إضافة حدث الرسالة

حدد Add Event، ثم ابحث عن im.message.receive_v1 (حدث استلام الرسالة) وأضفه.

إنشاء ونشر إصدار

حدد Create and Publish Version في الزاوية العلوية اليمنى، وأدخل ملاحظات الإصدار، ثم أكّد.

الإقران مع Verdent

بعد النشر، عد إلى Verdent وأرسل رسالة إلى بوت Feishu الخاص بك لإتمام الإقران.

ما تفعله كل إذن

الإذنالغرض
مجموعة 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، يظهر إشعار للإصلاح في الأعلى لإعادة التكوين.

حالات الاستخدام

مركز القيادة من الهاتف المحمول

أثناء التنقل، أخبر البوت في Telegram: "نشر آخر التغييرات في الفرع main إلى بيئة staging." وبحلول وقت عودتك، تكون النتيجة جاهزة.

التعاون الجماعي

اذكر بوت Manager الخاص بك في قناة Slack لتلخيص حالات طلبات السحب (PR) لهذا اليوم — تظهر الردود مباشرة في القناة ليراها الفريق بأكمله.

تدوين الأفكار السريع

قبل النوم، أرسل فكرة إلى البوت واطلب من Manager تحويلها إلى مهمة لتنفيذها في اليوم التالي.