السكرتير الذكي (وكيل خدمة العملاء)AI secretary agent

وكيل في واتساب والبوابة يحجز المواعيد ويذكّر ويجمع المستندات ويتابع الفواتير عبر أدوات محددة فقط، ولا يقدم رأيًا قانونيًا أبدًا. لا يعطي أي معلومة عن ملف قبل التحقق بـOTP، لأن مجرد معرفة أن لشخص قضية سرّ (دليل المطور ص26-27).

بطاقة الميزة

5الهدف التجاري والمشكلة التي تعالجها

أسئلة الموكّلين المتكررة تستهلك وقت السكرتارية، وخارج الدوام لا يرد أحد.

6المجال القانوني المرتبط للمطوّر غير المتخصص

الوكيل خدمة لا محامٍ: لا رأي، لا توقع، لا وعد بموعد حكم (دليل المطور ص26-27). حالة الملف للموكّل نص معتمد مسبقًا Client Status Update. التسويق بلا موافقة ممنوع B39 الامتثال لنظام حماية البيانات الشخصية.

7المستخدمون والأدوار والصلاحيات

الموكّل والعميل المحتمل يحادثانه. أي موظف يستلم المحادثة من صندوق مشترك فيتوقف الوكيل.

8شروط البدء والاعتماديات

حساب واتساب للأعمال معتمد وقوالب معتمدة منصة واتساب للأعمال. FAQ Entry معتمدة. B17 الزوار والاستقبال والمواعيد للحجز.

9السيناريو الأساسي خطوة بخطوة

1. Webhook ← البحث عن المرسل بالجوال في Legal Party.
2. غير معروف = عميل محتمل بلا بيانات.
3. معروف: OTP لكل جلسة محادثة قبل أي معلومة عن ملف.
4. تصنيف النية: استفسار، حجز، حالة، مستندات، دفع، سؤال قانوني، شكوى.
5. تنفيذ بالأدوات بصلاحيات الشخص نفسه لا صلاحيات المدير، أو تسليم لإنسان.
6. حفظ المحادثة واستدعاءات الأدوات في الملف.

10السيناريوهات البديلة والاستثناءات

المصدر: (دليل المطور ص26-27). خارج نافذة 24 ساعة: قوالب معتمدة فقط. خارج الدوام: يخبر بوقت الرد.

11المدخلات والحقول

12المخرجات والإشعارات والسجلات والتقارير

محادثات محفوظة في الملف. صندوق مشترك. تذكيرات في مواعيدها.

13قواعد العمل بصيغة قابلة للتحويل إلى كود

RULE B30.1  unverified sender asking status -> no info, not even existence of a matter
RULE B30.2  tools run with the party's own permissions
RULE B30.3  legal question -> handoff_to_human + inform client; never answer
RULE B30.4  staff takeover stops agent immediately (one click)
RULE B30.5  outside 24h window -> approved templates only
RULE B30.6  no marketing without Consent Record
TOOLS: get_availability, book_appointment, get_client_status, list_upcoming_hearings,
       request_documents, get_invoice_status, send_payment_link, create_task, handoff_to_human

14حالات السجل وانتقالاتها وشروطها

محادثة: مفتوحة (وكيل) ← مسلّمة (موظف) ← مغلقة.

15نموذج البيانات والعلاقات والقيود والفهارس

Agent Conversation، Agent Message، FAQ Entry، Client Status Update، Reminder Rule، Message Template (دليل المطور ص26-27).

16DocTypes المطلوبة في Frappe

• الستة المذكورة أعلاه.

17الشاشات والعناصر والأزرار ورسائل الخطأ

صندوق مشترك بزر «استلام المحادثة». شاشة اعتماد نصوص الحالة.

18خدمات Backend ومسؤولية كل خدمة

legal_erp.agent.webhook (تحقق التوقيع، معالجة خلفية)، agent.router، agent.tools.*.

19واجهات API الداخلية

POST /api/method/legal_erp.integrations.whatsapp.webhook

استقبال أحداث واتساب.

الصلاحية: التحقق من توقيع المنصة؛ تجاهل المعرّف المكرر.

{ "entry": [ "…حمولة المنصة كما توثقها…" ] }

{
  "status": "queued"
}

20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة

المعالجة في طابور short. التذكيرات بالجدولة B44 الإشعارات والتذكيرات.

21التكاملات المرتبطة بالميزة وحدودها

منصة واتساب للأعمال: يذكر الدليل أن ميتا تمنع روبوتات الذكاء العامة منذ 15 يناير 2026 وتسمح بروبوتات الخدمة والحجز (دليل المطور ص21) يحتاج تحققًا أو موافقة رسمية. مزود الرسائل النصية المحلي لرموز OTP.

22الأمن والخصوصية والتدقيق والاحتفاظ والحذف

OTP لكل جلسة. لا بيانات ملفات قبل التحقق. المحادثات بصلاحيات الملف.

23حالات الاختبار

24معايير القبول

• معايير الميزة 2 ناجحة (دليل المطور ص26-27).

25تعريف الاكتمال (Definition of Done)

• كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
• حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
• اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
• الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
• لا تعديل في ملفات Frappe أو ERPNext.
• كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
• نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
• معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.

26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة

اللهجات واللغات (فصحى، سعودية، إنجليزية)، والمكالمات الصوتية لاحقًا (دليل المطور ص26-27).