WeCom عن بُعد: ربط WorkBuddy بروبوت WeCom
💡 الخلاصة في جملة واحدة: استخدم WorkBuddy لتمكين إسناد المهام عن بُعد عبر WeCom للشركات — أنشئ روبوتًا ذكيًا في WeCom، واربطه عبر اتصال طويل، وتحكّم في حاسوبك من محادثات WeCom.
أنت في موقع العميل، وزميلك يذكرك في مجموعة WeCom: «أرسل لي عرض السعر الخاص بالشهر الماضي». سابقًا لم يكن بوسك إلا الرد «انتظر عودتي إلى مكتبي» — لكن بعد تهيئة WorkBuddy WeCom للشركات عن بُعد (يسميه الموقع الرسمي «مساعد WeCom»)، يمكنك ببساطة @الروبوت في WeCom وتقول جملة واحدة ليذهب إلى حاسوبك ويجد الملف.
يفكك هذا الدرس «دليل ربط مساعد WeCom» الرسمي إلى 5 خطوات: أولًا أنشئ روبوتًا ذكيًا بوضع API في WeCom، واربطه بـ WorkBuddy عبر اتصال WebSocket طويل، ثم أوكل المهام في محادثة خاصة أو جماعية في WeCom — سينفّذ حاسوبك المهمة تلقائيًا وتعود النتائج إلى نافذة محادثة WeCom.
هذا هو الدرس رقم 1 من المسار الثالث «السيناريوهات التطبيقية»، وهو مبني على WorkBuddy v5.9.3 (الحد الأدنى لمساعد WeCom هو 4.6.4)، ويستند المحتوى إلى «دليل ربط مساعد WeCom» الرسمي ووثائق المساعد والمهام المجدولة والأسئلة الشائعة.
- النظرة العامة على القنوات الست للتحكم عن بُعد (WeChat و WeCom و QQ و Feishu و DingTalk وغيرها)، ومدخل التهيئة الموحد وحدود الأمان موجودة في 5.1 نظرة عامة على المساعد، وهذا الدرس يكتفي بإتمام مسار WeCom وحده
- بعد الربط، إذا أردت أن «يعمل تلقائيًا في الوقت المحدد + يدفع النتائج إلى WeCom»: الآلية في 3.3 المهام المجدولة
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- إنشاء روبوت ذكي بوضع API في WeCom للشركات، وربطه بـ WorkBuddy عبر اتصال WebSocket طويل (Bot ID + Secret، أو مسح رمز QR للربط السريع)
- إسناد المهام عن بُعد في محادثة خاصة أو جماعية عبر @الروبوت: إيجاد الملفات، وتنظيم البيانات، وإنشاء المستندات — حاسوبك ينفّذ تلقائيًا والنتائج تعود إلى نافذة محادثة WeCom
- العودة إلى الحاسوب لعرض سجل التنفيذ الكامل للمهام البعيدة (عملية التفكير، خطوات العمل، الملفات المُنشأة، النتيجة النهائية) ومتابعة الأسئلة؛ والموافقة عن بُعد على العمليات عالية المخاطر مثل تنفيذ الأوامر وتعديل الملفات
- عند انقطاع الاتصال بالروبوت ستستكشف المشكلة وفق القائمة الرسمية: WorkBuddy حالة التشغيل، وطريقة الربط على الجانبين، والمُعرفات، والشبكة؛ وإذا لم يكن هناك استجابة فبدّل النموذج أولًا ثم أعد الاختبار
لماذا تستخدم WorkBuddy وليس ذكاءً اصطناعيًا على الويب؟
| القدرة | ذكاء الويب / روبوت WeCom العادي | WorkBuddy مساعد WeCom |
|---|---|---|
| التعامل مع ملفات حاسوبك | ❌ لا تملك ملفاتك في مربع الحوار، كل شيء يعتمد على النسخ واللصق | ✅ يستخدم ملفات مشاريعك المحلية وبيئة Shell وصلاحيات المُعرفات والإضافات والأدوات للتنفيذ |
| العمل داخل مجموعات WeCom | ❌ لا يعرف سوى الرد والإرسال الجماعي، ولا يتصل بحاسوبك | ✅ في المحادثة الجماعية @الروبوت لإسناد مهام الفريق، والنتائج تعود تلقائيًا إلى المجموعة |
| التحكم في العمليات عالية المخاطر | ❌ لا يملك قدرة على التنفيذ، فلا مجال للحديث عن التأكيد | ✅ تنفيذ الأوامر وتعديل الملفات يُعرض عليك أولًا للتأكيد في WeCom، ولا يُنفّذ إلا بعد الموافقة |
| عندما لا تكون أمام الحاسوب | ❌ حتى لو كانت صفحة الويب مفتوحة لن يعمل أحد مكانك | ✅ أرسل الأمر من WeCom، وينفّذ WorkBuddy الموجود على الحاسوب تلقائيًا |
| وصول نتائج المهام المجدولة | ❌ لا أحد يراها في موعدها | ✅ يمكن دفع نتائج المهام المجدولة إلى WeCom للشركات (وضع الاتصال الطويل فقط) |
معضلتك الحالية
- كثير التنقل خارج المكتب — في الاجتماعات، أو أثناء التنقل، أو في موقع العميل — وزميل يطلب بيانات من مجموعة WeCom، فلا تملك سوى الرد «انتظر عودتي إلى مكتبي»
- العمل نفسه ليس معقدًا: إيجاد ملف أو تشغيل ملخص، لكن بدون حاسوب في متناول اليد لا يمكن إنجازه؛ وسطح المكتب البعيد بطيء وشاشته صغيرة، فلا تجرؤ على العمل فعليًا
- أعمال الفريق موزعة على مجموعات WeCom: إسناد المهام والمتابعة والتسليم تعتمد كلها على الإشارة اليدوية @هنا و@هناك، ولا أحد يعرف التقدم
- فكرت في استخدام روبوت WeCom، لكن الروبوت العادي لا يعرف سوى الرد، ولا يتصل بالملفات والأدوات في حاسوبك
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- عندما لا تكون أمام الحاسوب، أن تجعل حاسوب الشركة يعمل مكانك: إيجاد الملفات، وتنظيم البيانات، وإنشاء المستندات
- إسناد مهام الفريق مباشرة في مجموعة WeCom، مع عودة النتائج إلى المجموعة بحيث يراها جميع المعنيين
- متابعة تقدم المهام البعيدة في أي وقت، والموافقة عن بُعد على العمليات التي تتطلب تأكيدًا
ولا تريد:
- فتح سطح مكتب بعيد من الهاتف والنقر على شاشة صغيرة
- أن تجعل زميلك ينتظر ملفًا موعودًا بـ«انتظر عودتي إلى مكتبي»
- رفع ملفات الشركة إلى مربع حوار ذكاء اصطناعي تابع لجهة خارجية على الويب
🎒 الاستعدادات قبل البدء
- اطلع على 5.1 نظرة عامة على المساعد: القنوات الست للتحكم عن بُعد وحدود الأمان — يستخدم هذا الدرس مدخل التهيئة الموحد مباشرة دون تكرار نظرة القنوات وحدود الأمان
- أن يكون WorkBuddy على حاسوبك مسجّلًا للدخول، بإصدار ≥ 4.6.4 (الحد الأدنى لمساعد WeCom؛ وأحدث إصدار عند كتابة هذا الدرس هو 5.9.3)
- امتلاك حساب WeCom للشركات يمكنه إنشاء روبوتات ذكية — المدير عبر لوحة الإدارة، والعضو العادي عبر تطبيق العميل؛ وإذا لم يكن لديك WeCom بعد، يوفر الموقع الرسمي مدخل تسجيل مجاني
- اتصال طبيعي بالإنترنت على الحاسوب والهاتف معًا؛ مع إبقاء الحاسوب يعمل وتشغيل WorkBuddy طوال فترة التهيئة
- 20 دقيقة وكوب ماء ☕ — يُفضل استخدام حاسوب العمل للمتابعة في التهيئة، وبعد إتمامها أرسل رسالة فورًا للتحقق
اتبع خطواتي
الخطوة 1: إنشاء روبوت ذكي في WeCom للشركات (وضع API)
لماذا: WorkBuddy لا يمكنه الظهور من العدم في WeCom — عليك أولًا إنشاء «روبوت ذكي» على جانب WeCom والحصول على المُعرفات ليصبح الربط ممكنًا. المدخل يُختار حسب دور الحساب، أحد خيارين.
الطريقة A: مسار المسؤول (الإنشاء في لوحة إدارة WeCom)
- افتح المتصفح على لوحة إدارة WeCom، وسجّل الدخول بحساب المسؤول
- انقر بالتسلسل على «الأمان والإدارة» ← «أدوات الإدارة» ← «الروبوتات الذكية» ← «إنشاء روبوت»
الطريقة B: مسار العضو العادي (الإنشاء في تطبيق WeCom)
- افتح تطبيق WeCom، وادخل إلى «منصة العمل» ← «تطبيق الروبوتات الذكية» ← «إنشاء روبوت»
يلتقي المساران هنا:
- إذا دخلت أولًا صفحة الإنشاء التلقائي بالذكاء الاصطناعي، انقر على «إنشاء يدوي» في الزاوية السفلية اليسرى، ثم اختر «الإنشاء بوضع API»
- املأ عنصري الإعدادات المشتركة:
| عنصر الإعداد | الشرح |
|---|---|
| اسم الروبوت | يُنصح بإدخال اسم سهل التمييز، مثل «مساعد WorkBuddy» |
| نطاق الرؤية (للمسؤول) / الأعضاء الذين يمكنهم الاستخدام (للعضو) | اختر الموظفين أو الأقسام أو الوسوم التي يمكنها استخدام هذا الروبوت |
- في مسار المسؤول انقر على «إضافة» بعد «نطاق الرؤية» لاختيار الأعضاء؛ وفي مسار العضو انقر على «تعديل» بعد «الأعضاء الذين يمكنهم الاستخدام» لاختيار الأعضاء
- بعد إكمال الإعدادات، انقر أولًا على «حفظ» أسفل الصفحة، ثم اختر في منطقة «إعدادات API» خيار «استخدام الاتصال الطويل»
يجب أن ترى: تم إنشاء الروبوت، وتُظهر منطقة «إعدادات API» أن «استخدام الاتصال الطويل» محدّد.
الخطوة 2: انسخ Bot ID وSecret
لماذا: وضع الاتصال الطويل يعتمد على هذين المُعرفَين للتعارف — WeCom يتعرّف على الروبوت عبر Bot ID، وWorkBuddy يتصل به عبر هذا الزوج من بيانات الاعتماد.
في منطقة «إعدادات API» (بعد اختيار «استخدام الاتصال الطويل»): انسخ Bot ID؛ وانقر على «انقر للحصول» للحصول على Secret، واحفظه في مكان آمن.
💡 لماذا يُنصح بالاتصال الطويل
التوضيح الرسمي: وضع الاتصال الطويل لا يتطلب إدخال URL أو Token أو Encoding-AESKey، فالإعداد أبسط، ولا حاجة لإعادة ملء Webhook URL. وهناك سبب قاطع — دفع المهام المجدولة يدعم الاتصال الطويل فقط، وعند تفعيل مفتاح الدفع في وضع استدعاء URL سيظهر تنبيه يطلب فك الربط ثم إعادة الاتصال (انظر نصائح الدرس المتقدمة).
يجب أن ترى: تم نسخ المُهِمَين وحفظهما، وال Secret موضوع في مكان آمن (لا تلصقه في المجموعة).
الخطوة 3: سجّل واربط مساعد WeCom في WorkBuddy
لماذا: المُهِمَات موجودة على جانب WeCom فقط، ويجب أيضًا «التسجيل» مرة واحدة في WorkBuddy، حتى يكتمل الربط بالمصافحة ثنائية الاتجاه.
- افتح WorkBuddy، وانقر على «الإعدادات - إعدادات المساعد» في قائمة الصورة الرمزية أسفل اليسار
- في منطقة «التكاملات (BETA)» ابحث عن «تكامل مساعد WeCom»، وانقر على «تهيئة»
- في النافذة المنبثقة اختر «اتصال WebSocket الطويل»، واختر إحدى طريقتي الربط:
- التعبئة اليدوية: أدخل Bot ID وSecret في حقول الإدخال
- الربط السريع: انقر على «ربط سريع» للاتصال، وأكمل الربط بمسح رمز QR في WeCom
- انقر على «تسجيل» لإكمال الربط
هل تستخدم مؤسستك نشرًا خاصًا لـ WeCom؟ يجب إدخال عنوان إضافي
إذا كانت مؤسستك تستخدم نشرًا خاصًا لـ WeCom، فبالإضافة إلى Bot ID وSecret، يجب إدخال عنوان WebSocket المخصص في حقل «عنوان WebSocket المخصص»:
- يُستخرج العنوان من لوحة إدارة WeCom، وبصيغة تشبه
ws://<网关>:<端口>/im_openws?bizid=1 - يجب أن يكون البروتوكول
ws://أوwss://— إدخالhttp://أو غيره من البروتوكولات سيُحظر مع ظهور تنبيه - عند تركه فارغًا يُرجع تلقائيًا إلى العنوان الافتراضي للسحابة العامة، ولا يؤثر على النشر العادي (غير الخاص)
- يظهر هذا الحقل فقط في وضع اتصال WebSocket الطويل، ولا علاقة له بوضع استدعاء URL
بعد حفظ الإعدادات وإعادة تشغيل WorkBuddy سيتم إعادة الاتصال تلقائيًا؛ وإذا كان العنوان غير قابل للوصول، ستعرض الواجهة حالة خطأ اتصال واضحة، مما يسهّل استكشاف مشكلات الشبكة أو إعدادات العنوان.
يجب أن ترى: تم التسجيل بنجاح، ويُظهر تكامل مساعد WeCom أنه مرتبط.
الخطوة 4: أرسل للروبوت رسالة «مرحبًا»
لماذا: نجاح الربط لا يعني أن القناة صالحة للاستخدام، فابدأ بالتحقق من السلسلة كاملة برسالة بلا تكلفة.
في دليل WeCom، ضمن مجموعة «أُنشئت بواسطة المؤسسة»، ابحث عن الروبوت الذي أنشأته للتو، وانقر على «إرسال رسالة»، وأرسل رسالة بسيطة (مثل «مرحبًا»).
يجب أن ترى: يتلقى WorkBuddy الرسالة ويردّ في WeCom — إذا كان الروبوت يرد بشكل طبيعي، فهذا يعني أن WorkBuddy مرتبط بنجاح بـ WeCom.
الخطوة 5: أرسل أول مهمة بعيدة في WeCom
لماذا: بعد نجاح التحقق من السلسلة، يمكنك البدء في تشغيل المهام الفعلية. التقسيم واضح: WeCom مسؤول عن إرسال الأوامر، وحاسوبك مسؤول عن التنفيذ.
في محادثة WeCom أرسل أمر المهمة مباشرة إلى الروبوت، مثل:
ابحث لي على حاسوبي عن أحدث عرض سعر في مجلد D:/工作/报价单،
اقرأ اسم العميل والمبلغ الإجمالي وفترة الصلاحية، وردّ عليّ مباشرة.يجب أن ترى:
- ينفّذ WorkBuddy على حاسوبك، وتُزامن العملية والنتيجة إلى نافذة محادثة WeCom
- عند العودة إلى الحاسوب، يمكنك في هذه المهمة عرض عملية التنفيذ والنتيجة كاملة؛ وفي صفحة المساعد يمكنك عرض سجل التنفيذ الكامل للمهام البعيدة: عملية التفكير، خطوات العمل، الملفات المُنشأة والنتيجة النهائية
- يمكنك متابعة الاستفسار وتفصيل المهام على الحاسوب، كما يمكنك عرض التقدم في WeCom في أي وقت
💡 هذه هي القيمة الفريدة لـ WorkBuddy
WorkBuddy على الحاسوب ينفّذ المهام باستخدام ملفات مشاريعك المحلية وبيئة Shell وصلاحيات المُهِمَات والإضافات والأدوات — بالنص الرسمي: كل ما يمكنك فعله على حاسوبك، يمكنك إنجازه عن بُعد عبر WeCom. نسخة الويب من الذكاء الاصطناعي «تتحدث» فقط، أما هنا فالتنفيذ حقيقي.
قارنت الجهة الرسمية بين المهام البعيدة والمهام العادية التي تفتحها عادةً على الحاسوب في ثلاث نقاط:
| عنصر المقارنة | المهمة العادية | المساعد (المهام البعيدة) |
|---|---|---|
| مجلد العمل | تحديد حر | يستخدم حصريًا مجلد المساعد المخصص |
| محادثة جديدة | يدعم مهامًا متوازية متعددة | جلسة واحدة فقط، وتُعالج جميع الأوامر البعيدة مركزيًا |
| إدارة السياق | يمكن مسح السجل والبدء من جديد | يحتفظ بسجل المحادثة الكامل، ولا يمكن مسحه |
التوصية الرسمية: للعمليات المحلية، استخدم أولًا المهام العادية في الواجهة الرئيسية؛ وعند الحاجة إلى تشغيل عن بُعد أو عرض موحّد للسجلات، استخدم المساعد.
📋 Prompt سحري
انسخ الأوامر التالية وأرسلها للروبوت في مربع محادثة WeCom، مع استبدال ما بين 【】 بحالتك الفعلية.
📝 البحث عن الملفات عن بُعد أثناء التنقل
التأثير المتوقع: أثناء وجودك في الخارج، يجعل الحاسوب يبحث في الملفات ويعرض المعلومات الرئيسية نيابة عنك، دون فتح سطح مكتب بعيد.
## الدور
أنت مساعدي المكتبي، ويمكنك التعامل مع الملفات على حاسوبي.
## المهمة
ابحث في 【مسار المجلد】 عن أحدث ملف متعلق بـ【كلمات مفتاحية للملف】، واقرأه ثم أرسل لي المعلومات الرئيسية.
## معلومات الإدخال
### العناصر المطلوبة
- مسار المجلد:【مثل D:/工作/报价单】
- الكلمات المفتاحية للملف:【مثل 报价单، أو اسم العميل أو المشروع】
### العناصر الاختيارية
- النطاق الزمني:【مثل الاكتفاء بما عُدّل هذا الأسبوع؟】
- الحقول المطلوب استخراجها:【مثل اسم العميل، المبلغ الإجمالي، فترة الصلاحية؟】
## مواصفات الإخراج
- ردّ مباشرة في محادثة WeCom: اسم الملف + وقت التعديل + المعلومات الرئيسية
## شروط القيود
- ✅ قراءة فقط، دون تعديل أو نقل أو حذف أي ملف
- ✅ إذا لم تجده، اشرح بصدق أين بحثت ولماذا لم تجده
- ❌ لا تختلق محتوى الملفات
- ❌ لا تنفّذ أي عمليات حذف📝 مهام الفريق في محادثات المجموعة
التأثير المتوقع: في مجموعة WeCom، أشر إلى الروبوت بـ @ لتكليفه بمهمة فريق، وتعود النتيجة مباشرة إلى المجموعة ليراها كل المعنيين.
## الدور
أنت مساعد المكتب في فريقنا، تتولى مهام التعاون التي تُسند إليك في المجموعة عبر @.
## المهمة
لخّص【مصدر المواد】في【المخرجات】، وبعد الانتهاء أرسل النتيجة ردًا في المجموعة.
## معلومات الإدخال
### العناصر المطلوبة
- مصدر المواد:【مثل تقارير الأسبوع لكل مجموعة في هذا الأسبوع ضمن الدليل D:/周报/ على جهازي】
- المخرجات:【مثل تقرير أسبوعي للفريق، مقسّم إلى ثلاثة أقسام: التقدم، المخاطر، خطة الأسبوع القادم】
### العناصر الاختيارية
- صيغة الإخراج:【مثل حفظه كمستند Word ووضعه في D:/周报/汇总/؟】
- جهة الإشعار:【@من؟】
## مواصفات الإخراج
- أعد نتيجة التلخيص إلى مجموعة الدردشة في WeCom للشركات؛ وإذا تم إنشاء ملف فاذكر مسار الملف
## شروط القيود
- ✅ المحتوى كله من المواد المقدمة، دون أي إضافات أو مبالغات
- ✅ المعلومات غير المؤكدة تُدرج على حدة في قائمة «بانتظار التأكيد»
- ❌ لا اختلاق لأي بنود غير موجودة في المواد
- ❌ لا تعديل على ملفات المواد الأصلية📝 متابعة التقدم واستلام النتائج
النتيجة المتوقعة: بعد إسناد المهمة يمكنك الاستفسار في أي وقت، حتى لا تتحول المهمة البعيدة إلى «أطلق وانسَ».
## المهمة
تابع المهمة التي أسندتها للتو:
1. أبلغ عن الخطوة الحالية التي وصل إليها التنفيذ
2. إذا كانت قد اكتملت، فاذكر النتيجة وموقع المخرجات
3. إذا كان التنفيذ متوقفًا عند عملية تحتاج تأكيدًا، فوضّح ما الذي تحتاج موافقتي عليه
## شروط القيود
- ✅ أبلغ بصدق، وإذا كان العمل جاريًا فقل إنه جارٍ
- ❌ لا تقول إن غير المكتمل مكتملًا لمجرد إنهاء المهمة💡 الدردشة اليومية يمكن أن تكون أكثر عامية
الـ Prompt السحري هو بنية كاملة، ويُنصح بكتابته كاملًا للمهام المهمة (ماذا تفعل + ماذا لديك + كيف تكون النتيجة، انظر 3.1 منهجية تقديم الطلبات). مساعد WeCom يعمل بجلسة واحدة ويحتفظ بالسجل الكامل، فالمتابعة اليومية بجملة أو جملتين تكفي — «هل اكتملت تلك المهمة الآن؟».
نقاط التحقق ✅
- يمكن العثور على الروبوت في مجموعة «أنشأتها المؤسسة» ضمن دليل جهات اتصال WeCom، وإرسال «مرحبًا» يُقابله رد
- إصدار WorkBuddy ≥ 4.6.4، وتُظهر «إعدادات المساعد» أن تكامل مساعد WeCom مُربوط
- الربط يستخدم اتصال WebSocket طويل الأمد — لاحقًا إذا أردت دفع نتائج المهام المجدولة إلى WeCom فهو وحده ما يدعم ذلك
- أعلم أن WeCom مسؤول فقط عن إرسال الأوامر والموافقة على العمليات، أما من يقوم بالعمل فعليًا فهو جهازي: يجب أن يبقى قيد التشغيل ويشغّل WorkBuddy
- أعلم أن المهام البعيدة تُنفذ حصريًا في مجلد المساعد المخصص، وتُعالج مركزيًا في جلسة واحدة، ولا يمكن مسح سجلها
- جربت إسناد مهمة بعيدة مرة واحدة، وشاهدت على جهازي سجل تنفيذ كاملًا
تنبيهات من واقع الأخطاء
❌ الروبوت لا يرد
الظاهرة: يعرض جانب WorkBuddy أنه مسجل أو أن الإعداد اكتمل، لكن الروبوت في WeCom لا يرد على الرسائل، أو ينقطع الاتصال أحيانًا، أو بعد أول استخدام ناجح يفقد الاتصال عند فتحه مرة أخرى.
السبب: تُدرج الأسئلة الشائعة الرسمية حالة «اكتمل الربط لكن لا استجابة بعد إرسال الرسالة» كمشكلة مشتركة بين منصات QQ وWeCom للشركات وWeChat وFeishu وDingTalk — قد يكون السبب انقطاع الاتصال، أو خللًا في النموذج، أو عدم تطابق بيانات الاعتماد.
الإجراء الصحيح (حسب ترتيب الاستقصاء الرسمي): تأكد من أن WorkBuddy يعمل وأن خدمة المساعد مفعّلة؛ تحقق من أن WeCom وWorkBuddy يختاران نفس طريقة الربط؛ في الاتصال الطويل تحقق من Bot ID وSecret، وفي رد URL تحقق من Token وEncoding-AESKey؛ تأكد من أن شبكة الجهاز تعمل بشكل طبيعي. وتضيف الأسئلة الشائعة الرسمية نصيحة: جرّب تبديل النموذج أولًا ثم الاختبار مجددًا، فبعض مشكلات عدم الاستجابة يمكن تخفيفها بتبديل النموذج.
❌ فشل تسجيل الاتصال الطويل
الظاهرة: النقر على «تسجيل» في WorkBuddy يُظهر خطأ، ولا يتم الربط.
الإجراء الصحيح (القائمة الرسمية): تأكد من اختيار «استخدام الاتصال الطويل» على جانب WeCom للشركات؛ انسخ Bot ID وSecret من جديد مع تجنّب أي مسافات زائدة؛ إذا كانت Secret قد انتهت صلاحيتها فأعد الحصول عليها من لوحة إدارة WeCom ثم سجّل؛ في عمليات النشر الخاصة تحقق من بروتوكول عنوان WebSocket المخصص (ws:// أو wss://) والبوابة والمنفذ، وتأكد من أن هذا العنوان قابل للوصول من الجهاز الحالي.
❌ فشل التحقق من URL (وضع رد URL)
الظاهرة: بعد إعادة تعبئة Webhook URL في WeCom، لا ينجح التحقق.
الإجراء الصحيح (القائمة الرسمية): تأكد من أن WorkBuddy في حالة تشغيل؛ تحقق من أن خدمة المساعد قد بدأت بشكل طبيعي؛ انسخ Webhook URL من جديد وتأكد من عدم وجود أحرف ناقصة أو زائدة؛ تأكد من أن Token وEncoding-AESKey متطابقان تمامًا مع ما هو مُعد في WorkBuddy.
❌ تظهر رسالة «فشل التحقق من كيان نطاق Webhook»
الظاهرة: عند إعداد عنوان Webhook على جانب WeCom للشركات، تظهر رسالة فشل التحقق من كيان النطاق.
السبب: يجري جانب WeCom للشركات تحققًا من كيان النطاق لعناوين Webhook.
الإجراء الصحيح: تقترح الوثائق الرسمية أولًا التحقق من أن عنوان Webhook كامل ومتوافق مع متطلبات الإعداد الحالي؛ وإذا لم ينجح الأمر بعد ذلك، فاحفظ لقطة شاشة للخطأ وقدّمها للاستقصاء.
❌ بمجرد إيقاف تشغيل الجهاز «يفقد» الروبوت الاتصال
الظاهرة: بعد إيقاف التشغيل في نهاية الدوام، لا يرد الروبوت على الرسائل في WeCom؛ وفي اليوم التالي بعد التشغيل يعود للعمل.
السبب: الروبوت ليس معطلًا — WeCom مسؤول فقط عن إرسال الأوامر والموافقة على العمليات والرسائل اللاحقة، أما بيئة تنفيذ المهام بالكامل (الملفات، Shell، بيانات الاعتماد، الإضافات، الأدوات) فهي على جهازك، وإذا كان الجهاز غير متصل فلا أحد يقوم بالعمل.
الإجراء الصحيح: في الفترات التي تحتاج فيها إلى العمل عن بُعد، أبقِ الجهاز قيد التشغيل ويشغّل WorkBuddy (هذا شرط مسبق تذكره الوثائق الرسمية). أما كيفية التعامل مع حالة قفل الشاشة، فراجع الدرس التالي C2 التحكم عن بُعد عبر الهاتف.
نصائح متقدمة (اختيارية)
🔧 ربط رد URL (حل بديل). الاتصال الطويل هو المسار الموصى به؛ إذا كنت تستخدم إعداد Webhook بالفعل، أو كنت تحتاج رد URL بسبب قيود الشبكة أو النشر، فاتبع العملية البديلة الرسمية:
- في منطقة «إعداد API» في WeCom اختر «استخدام رد URL»، وانقر على «الحصول العشوائي» إلى يمين حقلي Token وEncoding-AESKey، واحفظ هذين المُعاملين جيدًا — تشدد الوثائق الرسمية: فقدانهما يعني تعذر إكمال التسجيل
- ادخل في WorkBuddy إلى «إعدادات المساعد» ← «تكامل WeCom AIBot» ← «إعداد»، وفي نافذة التسجيل بدّل إلى «استخدام رد URL»، وأدخل Token وEncoding-AESKey، وانقر «تسجيل»
- انسخ Webhook URL الناتج بعد نجاح التسجيل، وعد إلى صفحة إنشاء روبوت WeCom والصقه في حقل URL، وانقر «حفظ»
⚠️ رد URL لا يستقبل دفع المهام المجدولة
دفع المهام المجدولة يدعم فقط اتصال WebSocket الطويل. إذا كان المساعد متصلًا حاليًا عبر رد URL، فعند تشغيل مفتاح الدفع ستظهر رسالة «اتصال رد URL لا يدعم دفع الرسائل حاليًا، يجب فك الربط وإعادة الاتصال»؛ وبعد إعادة الاتصال، ستتحول أيضًا القدرة على استقبال الرسائل التي كانت عبر رد URL إلى طريقة الاتصال الطويل.
🔧 دفع نتائج المهام المجدولة إلى WeCom. بعد ربط الروبوت، يمكن للمهام المجدولة المحلية (مثل التقرير الأسبوعي كل جمعة 17:00) دفع نتائجها إلى WeCom للشركات. راجع 3.3 المهام المجدولة وC4 موجز الأخبار اليومي. ملاحظة رسمية: فشل الدفع لا يؤثر على تنفيذ المهمة نفسها.
🔧 أنشئ مجموعة مهام مخصصة. تتضمن قائمة القدرات الرسمية «إنشاء مجموعة مهام مخصصة، مرتبطة على المدى الطويل بـ WorkBuddy لمعالجة الأعمال اليومية للفريق»: أضف الروبوت إلى مجموعة المشروع، وأسند المهام عبر @الروبوت وتابع التقدم، وعند اكتمال المهمة يُبلَّغ تلقائيًا الأشخاص المعنيون في المجموعة — الإسناد والاستلام والتوثيق كلها في نفس المجموعة.
خلاصة هذا الدرس
✅ WorkBuddy العمل عن بُعد عبر WeCom للشركات في خمس خطوات: إنشاء روبوت (وضع API) ← الحصول على Bot ID + Secret ← التسجيل والربط في WorkBuddy ← إرسال «مرحبًا» للتحقق ← إسناد أول مهمة بعيدة.
✅ أولوية الاتصال الطويل: لا حاجة لإعادة تعبئة Webhook URL، وتوفّر ثلاثة معاملات أقل؛ ودفع المهام المجدولة يدعمه هو أيضًا فقط.
✅ WeCom هو جهاز التحكم عن بُعد والجهاز هو المضيف: WeCom يرسل الأوامر ويوافق على العمليات فقط؛ أما الملفات وShell وبيانات الاعتماد والإضافات والأدوات فكلها على جهازك — أبقِ الجهاز قيد التشغيل ويشغّل WorkBuddy.
✅ ثلاث خصائص للمهام البعيدة: مجلد المساعد المخصص الثابت، والمعالجة المركزية في جلسة واحدة، وسجل لا يمكن مسحه؛ للأعمال المحلية فضّل المهام العادية.
✅ العمليات عالية الخطورة تتطلب تأكيدًا: تنفيذ الأوامر وتعديل الملفات وغيرها، يجب الموافقة عليها أولًا في WeCom قبل التنفيذ.
مراجعة الإعدادات الرئيسية:
| عنصر الإعداد | القيمة في هذا الدرس | الشرح |
|---|---|---|
| إصدار WorkBuddy | ≥ 4.6.4 | الحد الأدنى المطلوب لمساعد WeCom |
| إنشاء الروبوت | إنشاء يدوي · وضع API | المسؤول عبر لوحة الإدارة، والعضو عبر العميل |
| طريقة الاتصال | اتصال WebSocket طويل الأمد (موصى به) | Bot ID + Secret، أو ربط سريع عبر مسح رمز الاستجابة السريعة |
| عنوان WeCom المخصص (النشر الذاتي) | ws://<网关>:<端口>/im_openws?bizid=1 | يجب أن يكون البروتوكول ws:// أو wss:// |
| مدخل الروبوت | دليل جهات اتصال WeCom ← «الذي أنشأته المؤسسة» | انقر «إرسال رسالة» لتكليفه بمهمة |
استعراض الدرس القادم
حلّت WeCom مسألة «تكليف المهام داخل أداة الدردشة»، وسيحل الدرس القادم مسألة «التحكم عن بُعد من الهاتف أينما كنت». في الدرس القادم ستتعلم C2 التحكم عن بُعد عبر الهاتف المحمول: اجعل حاسوب الشركة يعمل أثناء تنقلك ذهابًا وإيابًا.
ستتعلم:
- كيفية إعداد مفتاح «الاتصال بالجهاز المحمول» وخيار «السماح بالتشغيل مع قفل الشاشة»
- السيناريوهات الرسمية وأوامر Prompt للبحث عن الملفات عن بُعد واستكشاف الأخطاء أثناء التنقل
- متابعة المحادثة عن بُعد، والإرجاع التلقائي للمخرجات، وقاعدة عدم استهلاك نقاط إضافية عند متابعة المحادثة