تكامل Monday.com
يتكامل HiLucy مع Monday.com لجلب تتبع المهام التشغيلية وأتمتة سير العمل بالذكاء الاصطناعي ومزامنة الحالة في الوقت الفعلي إلى سير عمل الضيافة الخاص بك. طلبات الخدمة من الضيوف ومهام الصيانة والعمليات الداخلية تتدفق إلى لوحات Monday.com لرؤية كاملة للفريق.
ما يتم مزامنته
| البيانات | الاتجاه | الوصف | |----------|---------|-------| | طلبات الخدمة | HiLucy -> Monday | طلبات الضيوف التي يلتقطها LucyAI تصبح عناصر Monday | | حالة المهام | ثنائي الاتجاه | تغييرات الحالة تتزامن بين HiLucy ولوحات Monday | | تحديثات العناصر | Monday -> HiLucy | ملاحظات الموظفين وانتقالات الحالة تتدفق عبر webhooks | | محفزات سير العمل | HiLucy -> Monday | وكلاء الذكاء الاصطناعي ينشئون مهامًا ويتتبعون التقدم |
خطوات الإعداد
1. الاتصال عبر OAuth
في لوحة إدارة WordPress:
- اذهب إلى Settings -> Bug Reporter (صفحة إعدادات Monday.com)
- أدخل Client ID و Client Secret الخاصين بـ Monday.com
- انقر على Connect to Monday.com
- فوّض HiLucy في تدفق OAuth الخاص بـ Monday.com
بمجرد الاتصال، يُخزّن رمز الوصول بأمان ويُجدّد تلقائيًا.
2. هيّئ لوحتك
يعمل HiLucy مع لوحة Monday.com مخصصة لإدارة المهام. اللوحة الافتراضية مهيأة مسبقًا، لكن يمكنك التوجيه لأي لوحة بتحديث board ID في الإعدادات. يجب أن تتضمن لوحتك أعمدة لـ:
- Status -- حالة المهمة (Backlog، In Progress، Done، إلخ.)
- Priority -- إلحاح المهمة
- Category -- نوع الطلب (تنظيف، صيانة، كونسيرج، إلخ.)
- Assignee -- الموظف المسؤول
3. إعداد Webhooks (اختياري)
للمزامنة ثنائية الاتجاه، هيّئ webhook من Monday.com يُخطر HiLucy عند تغيير حالات العناصر. يُفعّل هذا نمط "البوابة البشرية" حيث موافقات الموظفين على Monday تُشغّل إجراءات لاحقة في HiLucy.
كيف يعمل
تدفق طلب الخدمة
- يرسل ضيف رسالة إلى LucyAI بطلب (مثل "أحتاج مناشف إضافية في الغرفة 204")
- يلتقط LucyAI التفاصيل وينشئ طلب خدمة في HiLucy
- يُرسل طلب الخدمة إلى لوحة Monday.com كعنصر جديد
- يراه الموظفون على لوحة Kanban، يعيّنونه ويحدّثون الحالة
- تتزامن تغييرات الحالة مع HiLucy لإخطار الضيف
Monday Bridge
Monday Bridge هو مجموعة من نقاط نهاية REST API تسمح لنظام وكلاء HiLucy بالتفاعل مع لوحات Monday.com برمجيًا. يدعم:
- إنشاء المهام -- الوكلاء يدفعون عناصر جديدة إلى اللوحات ببيانات وصفية كاملة
- مزامنة الحالة -- دفع تحديثات الحالة من HiLucy إلى Monday
- قراءة العناصر -- الاستعلام عن تفاصيل وتحديثات حديثة
- عرض العناصر -- تصفية العناصر حسب الحالة لعروض لوحة التحكم
- تدفقات الموافقة -- إنشاء وحل بوابات الموافقة لعمليات الإنسان في الحلقة
استكشاف الأخطاء
المهام لا تظهر على اللوحة؟
- تحقق من أن اتصال OAuth نشط في الإعدادات
- تأكد من أن board ID يطابق لوحتك المستهدفة
- راجع سجل تصحيح WordPress لأخطاء GraphQL الخاصة بـ Monday.com
الحالة لا تتزامن؟
تأكد من تهيئة webhook الخاص بـ Monday.com وتوجيهه إلى نقطة نهاية REST API لموقعك. عنوان URL الخاص بـ webhook يجب أن يكون: https://موقعك.com/wp-json/hilucy/v1/monday-bridge/status-webhook
رمز OAuth منتهي؟
إذا رأيت أخطاء "no_token"، أعد الاتصال عبر Settings -> Bug Reporter -> Connect to Monday.com. سيُصدر تدفق OAuth رمزًا جديدًا.