ربط WhatsApp

بعد إنشاء Workspace، الخطوة التالية هي ربط حساب WhatsApp Business لتفعيل ميزات الرسائل.

المتطلبات قبل البدء

قبل ربط WhatsApp، تأكد من توفر:

• ✅ Workspace نشط (مثبت ويمكن الوصول إليه)
• ✅ حساب WhatsApp Business (شخصي أو تجاري)
• ✅ حساب Meta Business (للوصول إلى API)
• ✅ صلاحيات الإدارة على حساب WhatsApp Business

---

1. الوصول إلى صفحة ربط WhatsApp

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

1. من صفحة النشاط، انتقل إلى "WhatsApp Integration" أو "Integrations" → "WhatsApp"
2. إذا لم يكن Workspace مثبتاً، ستظهر رسالة توضيحية تطلب إعداد Workspace أولاً مع زر "إعداد مساحة العمل"
3. بعد إنشاء Workspace، ستظهر قائمة أرقام WhatsApp المتاحة

---

2. إضافة حساب WhatsApp جديد

الطريقة 1: Embedded Signup (الطريقة الموصى بها)

هذه الطريقة الأسهل والأسرع لربط حساب WhatsApp Business:

1. من صفحة WhatsApp Integration، اضغط على "Create" أو "Add WhatsApp Account"
2. ستظهر صفحة إعداد WhatsApp
3. اضغط على زر "Connect with Facebook" أو "Facebook Embedded Signup"
4. سيتم فتح نافذة تسجيل الدخول في Meta Business
5. سجّل الدخول باستخدام بيانات حساب Meta Business
6. امنح الصلاحيات المطلوبة:
   • الوصول إلى حساب WhatsApp Business
   • الوصول إلى معلومات العمل
   • صلاحيات إدارة الرسائل
7. اختر حساب WhatsApp Business الذي تريد ربطه
8. بعد الموافقة، سيتم توجيهك تلقائياً إلى صفحة تفاصيل الحساب

3. إكمال إعداد الحساب

بعد إضافة الحساب، يجب إكمال الخطوات التالية لتفعيل جميع الميزات:

الخطوة 1: الاشتراك في Webhooks (Subscribe to WABA)

1. من صفحة تفاصيل الحساب، ستجد بطاقة "Subscribe to WABA"
2. اضغط على زر "Subscribe"
3. سيتم الاشتراك في Webhooks تلقائياً لاستقبال الرسائل والأحداث

الخطوة 2: تسجيل رقم الهاتف (Register Phone)

1. من صفحة التفاصيل، ستجد بطاقة "Register Phone"
2. اضغط على زر "Register"
3. سيتم تسجيل رقم الهاتف مع WhatsApp Business API
4. بعد التسجيل الناجح، ستتغير حالة الرقم إلى "CONNECTED"

الخطوة 3: إرسال رسالة اختبار (Send Test Message)

1. من صفحة التفاصيل، ستجد بطاقة "Send Test Message"
2. أدخل رقم الهاتف الذي تريد إرسال رسالة اختبار إليه
3. اضغط على "Send"
4. إذا نجحت العملية، ستتلقى رسالة على الرقم المحدد

الخطوة 4: تحرير الملف الشخصي (Edit Business Profile)

1. من صفحة التفاصيل، ستجد قسم "Edit Business Profile"
2. يمكنك تحديث:
   • صورة الملف الشخصي: يجب أن تكون 192x192 بكسل على الأقل
   • العنوان: عنوان العمل
   • البريد الإلكتروني: بريد العمل
   • الوصف: وصف العمل (حد أقصى 512 حرف)
   • الصناعة: نوع النشاط التجاري
   • المواقع الإلكترونية: روابط المواقع
3. اضغط على "Update" لحفظ التغييرات

---

4. إدارة أرقام WhatsApp

من الصفحة الرئيسية لـ WhatsApp Integration، يمكنك:

1. عرض جميع الأرقام: قائمة بجميع أرقام WhatsApp المرتبطة
2. مزامنة الأرقام: اضغط على زر "Sync WABA Numbers" لمزامنة الأرقام من Meta
3. تعيين رقم افتراضي: من القائمة، اختر "Set as Default"
4. تعيين للفرع: من القائمة، اختر "Assign to Branch" لربط الرقم بفرع محدد
5. عرض التفاصيل: اضغط على "View Details" للانتقال إلى صفحة التفاصيل

---

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

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

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

---

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

بعد ربط WhatsApp بنجاح:

👉 ربط متجر سلة

---

ملاحظات مهمة

---

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

المشكلة: لا يمكن ربط WhatsApp

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

• Workspace غير مثبت
• بيانات API غير صحيحة
• صلاحيات غير كافية
• حساب WhatsApp Business غير نشط

الحلول:

1. تأكد من أن Workspace مثبت ونشط
2. تحقق من بيانات API من Meta Business
3. تحقق من الصلاحيات في Meta Business
4. تأكد من أن حساب WhatsApp Business نشط
5. راجع رسائل الخطأ للتفاصيل

المشكلة: فشل اختبار API

الحلول:

1. تحقق من صحة Phone Number ID
2. تأكد من أن Access Token صالح
3. تحقق من صلاحيات الحساب
4. راجع رسالة الخطأ

---

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

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

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