Fynchat · فينشات

معالج الإعداد الأول

ما الذي يحدث في صفحة /onboarding عند أول دخول — معالج من ثلاث خطوات يرحّب بك، يربط حساب WhatsApp فوراً عبر فيسبوك، ثم ينقلك إلى لوحة التحكم.

معالج الإعداد الأول

ما هي صفحة الإعداد الأول؟

صفحة /onboarding هي أول ما تراه بعد إنشاء حسابك في Fynchat: معالج بسيط من ثلاث خطوات يأخذك من الترحيب إلى ربط حساب WhatsApp Business ثم إلى لوحة التحكم. هدفها الوحيد هو توصيل رقم WhatsApp بحسابك بأسرع طريقة.

في الوضع الحالي، طريقة الربط المتاحة في هذه الصفحة هي الربط الفوري عبر فيسبوك (Embedded Signup)، حيث يتولّى Meta معظم الخطوات نيابةً عنك.

ملاحظة (الوصول): صفحة /onboarding متاحة لأي مستخدم مسجَّل دخوله ومُفعَّل بريده الإلكتروني، حتى قبل ربط WhatsApp أو الاشتراك في أي باقة. لا تحتاج إلى صلاحية خاصة لفتحها.

الخطوات الثلاث

يظهر أعلى الصفحة مؤشّر تقدّم بثلاث دوائر تنتقل معك خطوة بخطوة:

الخطوة ماذا يحدث
1. الترحيب 👋 شاشة ترحيب مع زر لبدء الإعداد
2. الربط ربط حساب WhatsApp فوراً عبر فيسبوك
3. تمّ ✅ شاشة نجاح، ثم انتقال تلقائي إلى لوحة التحكم

الخطوة 1: الترحيب

تبدأ الصفحة بشاشة ترحيب تحمل اسم حسابك، وفيها زر واحد لبدء الإعداد. اضغط الزر للانتقال إلى خطوة الربط.

الخطوة 2: الربط الفوري عبر فيسبوك

في هذه الخطوة تظهر لوحة الربط الفوري (Embedded Signup) مع زر أزرق يحمل شعار فيسبوك. عند الضغط عليه تُفتح نافذة من فيسبوك تُكمل فيها الخطوات التي يعرضها Meta. بمجرد إنهائها تعود النافذة إلى الصفحة، ويُنشأ الاتصال تلقائياً، وتنتقل إلى خطوة النجاح. أثناء المعالجة يتحوّل الزر إلى حالة انشغال حتى تكتمل العملية.

ملاحظات مهمة حول زر الربط:

  • يبقى الزر غير مفعّل حتى تكتمل أدوات فيسبوك تحميلها في المتصفح؛ إذا رأيته رمادياً، انتظر لحظات حتى يجهز (تظهر عبارة تنبيه صغيرة أثناء التحميل).
  • إذا لم تكن إعدادات الربط جاهزة من طرفنا، يظهر تنبيه أصفر ويبقى الزر معطّلاً — في هذه الحالة تواصل مع الدعم.

إذا أعادك فيسبوك إلى صفحة /onboarding بعد إتمام الخطوات هناك، يلتقط المعالج نتيجة الربط من الرابط تلقائياً ويُكمل العملية دون تدخّل منك.

الخطوة 3: تمّ الربط

عند نجاح الربط تظهر شاشة نجاح (بعلامة ✅)، ثم تنتقل تلقائياً إلى لوحة التحكم (/dashboard) خلال ثانيتين تقريباً.

إذا كان لديك حساب مربوط بالفعل

إذا سبق أن ربطت حساب WhatsApp واحداً على الأقل، تتغيّر الصفحة قليلاً:

  • يتغيّر عنوان الصفحة ونص الترحيب ليناسبا إضافة حساب جديد بدل الربط الأول.
  • يظهر رابط «التخطّي» يتيح لك الذهاب مباشرة إلى لوحة التحكم دون إكمال المعالج. (يظهر هذا الرابط فقط ما دمت في الخطوة 1 أو 2.)

عند بلوغ حدّ عدد الحسابات

إذا حاولت ربط حساب وتجاوزت العدد المسموح به في باقتك، يظهر تنبيه أحمر يوضّح عدد الحسابات المستخدَمة من أصل المسموح، مع:

  • زر لشراء حساب فرعي إضافي (بالسعر المعروض في التنبيه)،
  • ورابط إلى صفحة الباقات (/billing/plans) لترقية اشتراكك.

اختر أياً منهما لرفع الحدّ ثم أعد المحاولة.

مشاكل شائعة

  • زر الربط رمادي/غير قابل للضغط: أدوات فيسبوك ما زالت قيد التحميل — انتظر قليلاً. وإذا ظهر تنبيه أصفر بأن إعدادات الربط غير متوفّرة، تواصل مع الدعم.
  • أغلقت نافذة فيسبوك أو لم تُكمل الخطوات: ستظهر رسالة خطأ — أعِد الضغط على زر الربط للمحاولة من جديد.
  • الرقم مربوط بحساب آخر (cross_tenant_phone_conflict): يعني أن رقم WhatsApp هذا مُستخدَم بالفعل في حساب آخر داخل النظام، ولا يمكن ربطه مرتين. استخدم رقماً آخر أو تواصل مع الدعم.

روابط سريعة