منصة واتساب للأعمالWhatsApp Business Platform
قناة السكرتير الذكي والتذكيرات وملخصات الجلسات. منصة لها API رسمي موثق، لكن سياساتها تحدد ما يُسمح: روبوت خدمة لا روبوت ذكاء عام، وقوالب معتمدة خارج نافذة 24 ساعة (دليل المطور ص27).
خوادم المنصة خارج المملكة: لا محتوى حساس في الرسائل؛ الملفات الحساسة برابط آمن، والموافقة في عقد الأتعاب (الوثيقة المعمارية).
1ما المنصة، ومن الجهة المالكة، وما اختصاصها؟
منصة مراسلة الأعمال.
2ما الإجراء الذي ينفذه المحامي فيها؟
—
3متى يحتاج إليها المحامي؟
التواصل مع الموكّل.
4ميزات ERPOS المرتبطة بها
B30 السكرتير الذكي (وكيل خدمة العملاء)، B10 تقارير الجلسات ومخرجاتها، B17 الزوار والاستقبال والمواعيد، B44 الإشعارات والتذكيرات.
5الخدمة المحددة المطلوبة من المنصة
إرسال قوالب ورسائل الجلسة، واستقبال الرسائل.
6نوع الحاجة: قراءة أو إرسال أو مزامنة أو إشعارات
إرسال وإشعارات واردة.
7البيانات الداخلة والخارجة وحساسيتها ومصدرها
نصوص الرسائل وأرقام الجوال: يُقلل المحتوى الحساس.
8هل يوجد API رسمي موثق لهذه الخدمة تحديدًا؟
نعم: Cloud API موثق من Meta. التسعير والقيود تتغير؛ الوثيقة المعمارية تذكر تغييرات أكتوبر 2026 وتطلب التحقق (الوثيقة المعمارية) يحتاج تحققًا أو موافقة رسمية.
9المصدر الرسمي وتاريخ التحقق
| المصدر | الرابط | ما تحقّقنا منه | تاريخ التحقق |
|---|---|---|---|
| WhatsApp Business Platform | https://developers.facebook.com/docs/whatsapp | تفتح وثائق المطورين: واجهات API للمراسلة والمكالمات على مستوى المؤسسات. لم نراجع سياسة الروبوتات أو التسعير | 2026-11-04 |
10حالة التحقق
VERIFIED_API
VERIFIED_API (منصة موثقة عامة)؛ الالتزام بالسياسات مسؤولية المكتب.
11ما الذي يثبته المصدر الرسمي وما الذي لا يثبته؟
وجود الواجهة. لا يثبت قبول حالة استخدام المكتب.
12التسجيل والاعتماد والتفويض والمصادقة وبيئة الاختبار
حساب أعمال ورقم لكل مكتب واعتماد القوالب.
13خطوات الربط من جهة ERPOS
- رقم لكل مكتب.
- Webhook بتحقق التوقيع.
- القوالب.
- الموافقات B39 الامتثال لنظام حماية البيانات الشخصية.
14تصميم Adapter مستقل للمنصة
واجهة WhatsAppAdapter مستقلة في legal_erp/integrations/whatsapp.py ترث النمط الموحد نمط موصل التكامل بعمليات: send_template، send_session_message، webhook. تنفيذان: يدوي (يفتح نموذج إدخال للموظف ويسجل المصدر «يدوي») ورسمي (لا يُكتب قبل استلام توثيق رسمي وموافقة)، ويُختار من الإعداد لكل مكتب اقتراح هندسي.
15تدفق البيانات ومخطط التسلسل
16نموذج الطلب والاستجابة
بحسب توثيق المنصة؛ لا ننسخ حمولاتها هنا.
17انتهاء المهلة وانقطاع الخدمة والرفض وتضارب الحالة
- انتهاء المهلة ← فشل مؤقت ← إعادة أسية في الطابور.
- انقطاع الخدمة أو أخطاء متتالية ← إيقاف الموصل وتنبيه المدير B43 طبقة التكامل المركزية.
- رفض (صلاحية، تفويض) ← فشل دائم يظهر للمسؤول بلا إعادة.
- تضارب الحالة مع البيانات المحلية ← سجل فرق يقرره إنسان؛ لا كتابة صامتة ولا حذف محلي عند استجابة فارغة.
18منع التكرار وإعادة المحاولة الآمنة
كل عملية صادرة بمفتاح عدم تكرار يُحفظ مع السجل؛ إعادة المحاولة ترسل المفتاح نفسه، وكل حدث وارد يُتجاهل إن تكرر معرّفه أو بصمته B43 طبقة التكامل المركزية.
19حفظ المصدر ووقت الجلب وإيصال الجهة وسجل التدقيق
يُحفظ مع كل قيمة: data_source (يدوي/الجهة)، وقت الجلب، معرّف الاستدعاء أو رقم الإيصال من الجهة إن وُجد، والمستخدم أو المهمة المجدولة. سجل الاستدعاء لا يحفظ جسم الاستجابة ولا بيانات شخصية (خطة ناجز ص14).
20المسار اليدوي المصرح به
البديل: بريد أو SMS مزود الرسائل النصية المحلي البريد الإلكتروني.
21اختبارات التكامل والفشل والتفويض والتكرار والعزل
| المعرّف | النوع | السيناريو | النتيجة المتوقعة |
|---|---|---|---|
INT-WA-01 | تكامل | بيئة وهمية تعيد نجاحًا | تُحفظ القيمة بمصدرها ووقتها. |
INT-WA-02 | فشل | مهلة ثم نجاح | إعادة واحدة بلا تكرار. |
INT-WA-03 | تفويض | مفتاح أو تفويض غير صالح | فشل دائم وتنبيه، لا إعادة. |
INT-WA-04 | تكرار | إرسال الحدث نفسه مرتين | يُعالج مرة. |
INT-WA-05 | عزل | مكتبان على الخادم نفسه | لا يرى أحدهما بيانات الآخر ولا مفتاحه. |
22المخاطر والقرارات التي تحتاج موافقة الجهة
سياسات روبوتات الذكاء، التسعير، النقل خارج المملكة يحتاج اعتمادًا قانونيًا.