إنشاء Workspace

بعد الاشتراك في الباقة، يجب إنشاء Workspace خاص بنشاطك التجاري.

ما هو Workspace؟

Workspace يوفر:

• بيئة معزولة: منفصلة عن الأنشطة التجارية الأخرى
• نطاق فرعي فريد: الوصول عبر https://[subdomain].awalchat.com
• إعدادات مستقلة: تكوينات مخصصة لكل نشاط
• وصول آمن: محمي بالمصادقة
• تكامل API: ربط التطبيقات الخارجية

1. الوصول إلى صفحة Workspace

المتطلبات الأساسية

قبل الوصول إلى صفحة Workspace، يجب أن يكون لديك:

• ✅ اشتراك نشط في إحدى الباقات
• ✅ نشاط تجاري (Business) تم إنشاؤه

من لوحة التحكم

1. من صفحة النشاط، انتقل إلى قسم "Workspace" أو "Setup Workspace"
2. إذا لم يكن لديك اشتراك، ستظهر رسالة مع خيارين:
   • "Subscribe Now": للانتقال إلى صفحة الباقات
   • "Subscribe to Free Plan": للاشتراك في الباقة المجانية
3. بعد الاشتراك، ستظهر صفحة إعداد Workspace

2. عملية إعداد Workspace

صفحة Workspace تعرض عملية إعداد متعددة الخطوات باستخدام نظام Steps:

نظرة عامة على الخطوات

1. إعداد النطاق (Domain Setup): تكوين النطاق الفرعي
2. بيانات المستخدم (User Data): إعداد اسم المستخدم وكلمة المرور
3. إعدادات الأمان (Security Settings): تكوين HmacSecret
4. التثبيت والإزالة (Installation & Removal): تثبيت أو إلغاء تثبيت Workspace

التنقل بين الخطوات

• استخدم أزرار "Previous Step" و "Next Step" للتنقل
• أو اضغط على أي بطاقة من البطاقات السريعة للانتقال مباشرة إلى الخطوة المطلوبة
• يمكنك التنقل بحرية بين الخطوات قبل التثبيت

3. الخطوة 1: إعداد النطاق (Domain Setup)

إعداد Subdomain

1. في الخطوة الأولى، ستجد بطاقة "Domain Setup"
2. إذا كان لديك نطاق موجود، سيظهر النطاق الحالي مع أزرار "Copy" و "Share"
3. اضغط على "Edit" لتعديل النطاق

إدخال اسم النطاق

1. في النافذة المنبثقة، أدخل اسم النطاق الفرعي
2. المتطلبات:
   • يجب أن يكون فريداً عبر المنصة
   • يمكن استخدام الأحرف الإنجليزية الصغيرة (a-z)
   • يمكن استخدام الأرقام (0-9)
   • يمكن استخدام الشرطة (-)
   • لا يمكن أن يبدأ أو ينتهي بشرطة
   • الحد الأدنى: 3 أحرف
   • الحد الأقصى: 63 حرف
3. سيتم التحقق من توفر النطاق تلقائياً أثناء الكتابة
4. النطاق الكامل سيكون: https://[username].awalchat.com

Business UUID

• إذا كان متوفراً، سيظهر Business UUID في بطاقة النطاق
• يمكنك نسخ UUID للاستخدام في التكاملات

4. الخطوة 2: بيانات المستخدم (User Data)

إعداد بيانات تسجيل الدخول

1. في الخطوة الثانية، ستجد بطاقة "User Data"
2. أدخل المعلومات التالية:

البريد الإلكتروني (Email)

• المتطلبات:
  • يجب أن يكون بريد إلكتروني صحيح
  • يُستخدم لتسجيل الدخول إلى Workspace
• يمكن تغييره: نعم، من إعدادات Workspace

كلمة المرور (Password)

• المتطلبات:
  • الحد الأدنى: 6 أحرف
  • يُنصح باستخدام كلمة مرور قوية
• يمكن تغييرها: نعم، من إعدادات Workspace

3. اضغط على "Save" لحفظ البيانات

5. الخطوة 3: إعدادات الأمان (Security Settings)

تكوين HmacSecret

1. في الخطوة الثالثة، ستجد بطاقة "Security Settings"
2. HmacSecret هو مفتاح أمان يُستخدم لـ:
   • مصادقة API
   • التحقق من Webhooks
   • التكاملات الخارجية الآمنة

توليد HmacSecret

1. إذا لم يكن لديك HmacSecret، اضغط على زر "Generate" (أيقونة Reload)
2. سيتم توليد مفتاح جديد تلقائياً
3. أو يمكنك إدخال مفتاح مخصص

حفظ HmacSecret

عرض ونسخ HmacSecret

• اضغط على أيقونة العين لعرض المفتاح
• اضغط على أيقونة النسخ لنسخ المفتاح
• يمكنك فتح نافذة منبثقة لعرض المفتاح بشكل كامل

متطلبات HmacSecret

• الحد الأدنى: 32 حرف
• الصيغة: يمكن أن يحتوي على أحرف وأرقام ورموز

6. الخطوة 4: التثبيت والإزالة (Installation & Removal)

حالة Workspace

قبل التثبيت، تحقق من حالة Workspace:

• Ready: جاهز للتثبيت
• Installed: مثبت ولكن غير نشط
• Active: نشط ويعمل
• Stopped: متوقف

تثبيت Workspace

1. إذا كانت الحالة "Ready"، ستظهر بطاقة "Installation & Removal"
2. اضغط على زر "Install"
3. ستظهر نافذة تأكيد
4. اضغط على "Confirm" لتأكيد التثبيت
5. ⚠️ مهم: لا تغلق الصفحة أثناء عملية التثبيت

عملية التثبيت

أثناء التثبيت، النظام يقوم بـ:

• إنشاء بيئة Workspace
• إعداد قواعد البيانات
• تكوين الأمان
• إعداد جميع الخدمات اللازمة
• تفعيل النطاق الفرعي

المدة المتوقعة: 2-5 دقائق

إلغاء تثبيت Workspace

1. إذا كانت Workspace مثبتة ونشطة، ستظهر زر "Uninstall"
2. اضغط على "Uninstall"
3. ستظهر نافذة تأكيد تحذيرية
4. ⚠️ تحذير: هذه العملية لا يمكن التراجع عنها
5. اضغط على "Confirm" لتأكيد الإلغاء

7. الوصول إلى Workspace

بعد التثبيت الناجح:

الرابط

Workspace متاح على:

https://[subdomain].awalchat.com

حيث [subdomain] هو اسم النطاق الذي أدخلته في الخطوة الأولى.

تسجيل الدخول

1. استخدم البريد الإلكتروني و كلمة المرور التي أدخلتها في الخطوة الثانية
2. سجّل الدخول إلى Workspace

طرق الوصول

يمكنك الوصول إلى Workspace من:

• الرابط المباشر: https://[subdomain].awalchat.com
• لوحة التحكم: من صفحة Workspace، اضغط على الرابط
• صفحة إدارة Workspace: من قائمة Workspace في لوحة التحكم

تحديث البيانات

بعد التثبيت، يمكنك تحديث:

• النطاق: لا يمكن تغييره بعد الإنشاء
• البريد الإلكتروني: من الخطوة 2 (User Data)
• كلمة المرور: من الخطوة 2 (User Data)
• HmacSecret: من الخطوة 3 (Security Settings) - احذر، إعادة التوليد قد يكسر التكاملات

مخطط تدفق العملية

البدء
  ↓
التحقق من الاشتراك
  ↓ (نعم)
إعداد النطاق (Domain Setup)
  ↓
إعداد بيانات المستخدم (User Data)
  ↓
إعداد HmacSecret (Security Settings)
  ↓
التحقق من الحالة (Ready?)
  ↓ (نعم)
تثبيت Workspace
  ↓
التحقق من الحالة (Active?)
  ↓ (نعم)
✅ Workspace جاهز للاستخدام

مقارنة الباقات وميزات Workspace

يوضح الجدول التالي ميزات Workspace المتاحة في كل باقة:

اختيار الباقة المناسبة

• الباقة المجانية: مناسبة للبدء والاختبار، أو للمشاريع الصغيرة
• الباقة الأساسية: مناسبة للشركات الصغيرة والمتوسطة
• الباقة المتقدمة: مناسبة للشركات الكبيرة مع احتياجات متعددة
• الباقة الاحترافية: مناسبة للمؤسسات الكبيرة مع متطلبات عالية

دليل البدء السريع (Quick Start Guide)

في 5 دقائق فقط! ⚡

اتبع هذه الخطوات السريعة لإعداد Workspace:

الخطوة 1: التحقق من الاشتراك (30 ثانية)

• تأكد من وجود اشتراك نشط
• إذا لم يكن لديك اشتراك، اضغط على "Subscribe to Free Plan"

الخطوة 2: إعداد النطاق (1 دقيقة)

• اضغط على "Edit" في بطاقة Domain Setup
• أدخل اسم نطاق فريد (مثال: mybusiness)
• انتظر التحقق من التوفر
• اضغط "Save Changes"

الخطوة 3: إعداد بيانات المستخدم (1 دقيقة)

• أدخل بريدك الإلكتروني
• أدخل كلمة مرور قوية (6+ أحرف)
• اضغط "Save"

الخطوة 4: إعداد HmacSecret (1 دقيقة)

• اضغط على زر "Generate" لتوليد مفتاح جديد
• ⚠️ مهم: انسخ المفتاح واحفظه في مكان آمن
• اضغط "Save"

الخطوة 5: التثبيت (2 دقيقة)

• تحقق من أن الحالة "Ready"
• اضغط "Install"
• أكد التثبيت
• انتظر حتى تكتمل العملية (2-5 دقائق)
• ✅ Workspace جاهز!

نصائح سريعة

💡 اسم النطاق: استخدم اسماً قصيراً وواضحاً يمثل نشاطك
💡 HmacSecret: احفظه فوراً - لن تتمكن من استرجاعه
💡 كلمة المرور: استخدم كلمة مرور قوية وفريدة
💡 التثبيت: لا تغلق الصفحة أثناء التثبيت

ماذا بعد؟

بعد إعداد Workspace:

1. ✅ ربط WhatsApp: دليل ربط WhatsApp
2. ✅ استخدام API: مرجع API
3. ✅ إدارة Workspace: عد إلى صفحة Workspace لتحديث الإعدادات

روابط الوصول السريع

الوصول إلى هذه الصفحات مباشرة من لوحة التحكم:

• ⚙️ إعدادات مساحة العمل - إدارة مساحة العمل (استبدل {businessId} بمعرف نشاطك)
• 📊 لوحة تحكم النشاط - العودة إلى لوحة التحكم (استبدل {businessId} بمعرف نشاطك)
• 📱 ربط WhatsApp - ربط WhatsApp (استبدل {businessId} بمعرف نشاطك)

الخطوات التالية

بعد إنشاء Workspace بنجاح:

👉 ربط WhatsApp

👉 مرجع API - لاستخدام HmacSecret في التكاملات

ملاحظات مهمة

قائمة التحقق قبل البدء

قبل البدء في إعداد Workspace، تأكد من:

• لديك اشتراك نشط في إحدى الباقات
• تم إنشاء نشاط تجاري (Business)
• اخترت اسم نطاق مناسب (لا يمكن تغييره لاحقاً)
• لديك بريد إلكتروني صالح
• أعددت كلمة مرور قوية
• فهمت أهمية HmacSecret وستحفظه بشكل آمن

حالات Workspace

يوضح الجدول التالي جميع الحالات الممكنة لـ Workspace:

أفضل الممارسات

اختيار اسم النطاق

• ✅ استخدم اسماً قصيراً وواضحاً
• ✅ تجنب الأحرف الخاصة المعقدة
• ✅ استخدم اسم يمثل نشاطك التجاري
• ❌ لا تستخدم أسماء طويلة جداً
• ❌ لا تستخدم أرقام عشوائية فقط

إدارة HmacSecret

• ✅ احفظه في مدير كلمات المرور
• ✅ لا تشاركه مع أي شخص
• ✅ لا تضعه في الكود المصدري
• ✅ استخدمه فقط في التكاملات الآمنة
• ❌ لا تعيد توليده إلا عند الضرورة القصوى

الأمان

• ✅ استخدم كلمة مرور قوية (8+ أحرف، أحرف كبيرة وصغيرة، أرقام ورموز)
• ✅ غيّر كلمة المرور بانتظام
• ✅ استخدم بريد إلكتروني احترافي
• ✅ لا تشارك بيانات تسجيل الدخول

أسئلة شائعة (FAQ)

هل يمكنني تغيير اسم النطاق بعد الإنشاء؟

لا، اسم النطاق لا يمكن تغييره بعد الإنشاء. اختره بعناية من البداية.

ماذا يحدث إذا فقدت HmacSecret؟

يمكنك إعادة توليد HmacSecret من الخطوة 3، لكن تحذير: هذا سيكسر جميع التكاملات الموجودة التي تستخدم المفتاح القديم.

كم من الوقت تستغرق عملية التثبيت؟

عادة ما تستغرق 2-5 دقائق، لكن قد تستغرق وقتاً أطول في أوقات الذروة.

هل يمكنني إلغاء التثبيت وإعادة التثبيت لاحقاً؟

نعم، يمكنك إلغاء التثبيت وإعادة التثبيت لاحقاً. لكن احذر: إلغاء التثبيت سيوقف جميع الخدمات.

هل أحتاج إلى Workspace لاستخدام WhatsApp Integration؟

نعم، يجب أن يكون لديك Workspace مثبت ونشط قبل إمكانية إدارة أرقام WhatsApp.

ما الفرق بين "Installed" و "Active"؟

• Installed: Workspace مثبت ولكن قد لا يكون نشطاً بالكامل
• Active: Workspace نشط ويعمل بكامل طاقته

استكشاف الأخطاء

المشكلة: لا يمكن إنشاء Workspace

الأسباب المحتملة:

• Subdomain مستخدم مسبقاً
• صيغة Subdomain غير صحيحة
• الباقة لا تدعم إنشاء Workspace
• لا يوجد اشتراك نشط

الحلول:

1. جرب اسم Subdomain مختلف
2. تأكد من اتباع قواعد التسمية
3. تحقق من أن باقاتك تتضمن ميزة Workspace
4. تأكد من وجود اشتراك نشط
5. تواصل مع الدعم إذا استمرت المشكلة

المشكلة: فشل التثبيت

الأسباب المحتملة:

• مشاكل في الاتصال بالإنترنت
• صيانة الخوادم
• تكوين غير صحيح
• لم تكتمل جميع الخطوات الأساسية

الحلول:

1. تحقق من اتصال الإنترنت
2. انتظر بضع دقائق وأعد المحاولة
3. تحقق من صحة جميع المعلومات
4. تأكد من إكمال جميع الخطوات (Domain, User Data, HmacSecret)
5. تحقق من حالة Workspace (يجب أن تكون "Ready")
6. تواصل مع الدعم مع تفاصيل الخطأ

المشكلة: لا يمكن الوصول إلى Workspace بعد التثبيت

الأسباب المحتملة:

• Workspace لم يكتمل التثبيت
• بيانات تسجيل الدخول غير صحيحة
• النطاق لم يتم تفعيله بعد

الحلول:

1. تحقق من حالة Workspace (يجب أن تكون "Active")
2. تأكد من استخدام البريد الإلكتروني وكلمة المرور الصحيحة
3. انتظر بضع دقائق بعد التثبيت
4. جرب مسح ذاكرة التخزين المؤقت للمتصفح
5. تواصل مع الدعم إذا استمرت المشكلة

المشكلة: HmacSecret لا يعمل في التكاملات

الأسباب المحتملة:

• تم نسخ المفتاح بشكل غير صحيح
• تم إعادة توليد المفتاح
• المفتاح غير صحيح

الحلول:

1. تأكد من نسخ المفتاح بالكامل (بدون مسافات إضافية)
2. تحقق من أنك تستخدم المفتاح الصحيح (الأحدث)
3. أعد إدخال المفتاح في التكامل
4. إذا فشل، قم بتوليد مفتاح جديد (مع العلم أن هذا قد يكسر التكاملات الأخرى)

الدعم والمساعدة

إذا واجهت أي مشاكل:

• 📧 البريد الإلكتروني: support@awalchat.com
• 💬 الدردشة المباشرة: متوفرة في لوحة التحكم
• 📱 واتساب: تواصل معنا مباشرة عبر واتساب
• 📚 الدليل الكامل: راجع دليل الإعداد