الترخيص وتفعيل Pro

الخطة المجانية طريقة مدعومة ودائمة لتشغيل Perfex CRM Integration for WHMCS. فهي تزامن العملاء وجهات الاتصال باتجاه واحد، من WHMCS إلى Perfex، في الوقت الفعلي. ولا تحتاج إلى مفتاح لذلك أبداً.

أما رخصة Pro فتفتح ما تبقّى. وتغطي هذه الصفحة شراءها وتفعيلها وفحصها وإزالتها.

ما الذي تفتحه Pro

ما تفتحه Pro	ماذا يعني ذلك يومياً
🔁 مزامنة العملاء وجهات الاتصال باتجاهين	العنوان الذي يُصحَّح في Perfex ينتقل عائداً إلى WHMCS، وفق سياسة التعارض التي اخترتها
📄 نسخ الفواتير	تظهر فواتير WHMCS على عميل Perfex مع بنودها وصف الضريبة وحالتها
💳 مزامنة المدفوعات والمعاملات	فاتورة WHMCS المدفوعة تقلب نسختها في Perfex إلى Paid، مع تسجيل بوابة الدفع ومعرّف المعاملة
🛒 مزامنة الطلبات	يصبح طلب WHMCS عميلاً محتملاً في Perfex، أو ملاحظة على العميل، أو لا شيء، حسب تفضيلك
🎫 مزامنة تذاكر الدعم	تنتقل التذاكر والردود وتغييرات الحالة في الاتجاهين، مع مهام Perfex اختيارية لكل تذكرة لأغراض الجداول الزمنية
🌐 لوحة الخدمات والنطاقات	تبويب WHMCS في كل ملف عميل داخل Perfex، يسرد خدمات ذلك العميل ونطاقاته
⏬ معالج التعبئة الرجعية	استيراد عملائك وفواتيرك وخدماتك ونطاقاتك الحالية، لا النشاط الجديد وحده
🗂️ قوائم ربط الأقسام المنسدلة	ربط أقسام تذاكر WHMCS بأقسام Perfex بالاختيار من قائمة بدلاً من كتابة المعرّفات

المقارنة الكاملة جنباً إلى جنب موجودة في جدول المجانية مقابل Pro.

الرخصة تعيش على جانب WHMCS فقط

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

شراء Pro: نافذة الدفع المنبثقة

هذا هو المسار السريع، ولا يحتاج إلى أي نسخ ولصق على الإطلاق.

1. في أي من صفحتَي الإدارة، انقر رابط الترقية:
   • في WHMCS: Addons > Perfex CRM Bridge. يظهر الرابط باسم Buy a Pro licence بجانب مربع Pro License Key، وباسم Upgrade to Pro على صف الرخصة في قائمة التحقق وفي مربعات التعريف بـ Pro.
   • في Perfex: Setup > WHMCS Bridge، ضمن لوحة WHMCS plan، الزر Upgrade to Pro.
2. تُفتح نافذة منبثقة آمنة للدفع في مكانها، فوق الصفحة التي كنت فيها أصلاً.
3. أكمل عملية الشراء.
4. يتم التفعيل تلقائياً:
   • إذا بدأت من WHMCS: يُكتب مفتاح الرخصة الوارد في استجابة الدفع داخل مربع Pro License Key في نموذج الإعدادات نفسه، ويُرسَل ذلك النموذج نيابةً عنك. ويتحقق الحفظ من المفتاح مباشرةً، ويقلب الخطة إلى Pro، ويخبر جانب Perfex، كل ذلك في الطلب نفسه.
   • إذا بدأت من Perfex: يُمرَّر المفتاح إلى تثبيت WHMCS لديك عبر قناة الجسر الموقّعة. ويتحقق WHMCS منه مباشرةً قبل تخزين أي شيء، ثم يفعّل Pro، ويدفع حالة الخطة الجديدة عائدةً على الفور، فتنقلب لوحة الخطة في Perfex إلى Pro في مكانها دون إعادة تحميل. ولا يخزّن Perfex المفتاح أبداً.
5. تصبح Pro فعّالة فوراً. لا انتظار لنبضة cron، ولا شيء يُكتب.

النافذة المنبثقة تحسين لا اعتماد

إذا حجب امتداد متصفح، أو سياسة أمان محتوى صارمة، أو شبكة بطيئة سكربت النافذة المنبثقة، فسيتصرف الرابط كما كان يتصرف دائماً ويفتح صفحة الدفع المستضافة في تبويب جديد. لا شيء يتعطل؛ فقط تُنهي العملية باللصق اليدوي أدناه.

إذا أُغلق المتصفح قبل اكتمال التفعيل

مفتاحك لا يزال بحوزتك. وهناك شبكتا أمان، بهذا الترتيب:

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

ثم اتبع المسار اليدوي أدناه.

تفعيل مفتاح يدوياً

استخدم هذا كلما كان لديك مفتاح جاهز: من بريد الشراء، أو من بوابة العملاء، أو عند نقل رخصة إلى تثبيت WHMCS مختلف.

1. في WHMCS، افتح Addons > Perfex CRM Bridge.
2. مرّر إلى Settings > Pro licence.
3. الصق المفتاح في Pro License Key. تبدأ المفاتيح بـ sk_.
4. انقر Save Settings.

هذا هو التفعيل بأكمله. فحفظ مفتاح تغيّر فعلياً يشغّل الفحص المباشر في حينه، بحيث تعود الصفحة وهي تعرض خطتك بالفعل. لا تحتاج إلى الضغط على أي شيء آخر، ولا تحتاج إلى انتظار نبضة cron.

ويخبرك الشريط بواحد من ثلاثة أمور بالضبط:

الشريط	المعنى	ما العمل
🟢 أخضر - "Settings saved. Licence verified - your Pro plan is active..."	أكّد خادم الترخيص صحة المفتاح. ويذكر رأس الصفحة وصف License / plan في قائمة التحقق كلمة Pro بالفعل، واختفت مربعات التعريف بـ Pro، وأصبح معالج التعبئة الرجعية متاحاً.	لا شيء. لقد انتهيت.
🔴 أحمر - "Settings saved. The licence server rejected this key..."	رُفض المفتاح، والرسالة تذكر سبب الخادم نفسه: مفتاح غير معروف، أو اشتراك منتهٍ، أو رخصة ملغاة، أو استنفاد حصة التفعيل.	تأكد من أن المفتاح ملصوق تماماً كما يظهر في بريد الشراء، دون أي حرف ناقص أو زائد، ثم احفظ مجدداً.
🟠 كهرماني - "Settings saved. Could not reach the licence server..."	لا موافقة ولا رفض: تعذّر على خادمك الوصول إلى خدمة الترخيص في هذه اللحظة.	المفتاح محفوظ فعلاً وتستمر المحاولات تلقائياً. تحقق من أن خادمك يستطيع الوصول إلى api.freemius.com عبر HTTPS، ثم انقر Check licence now. ومهلة السماح تحميك في غضون ذلك.

عبارة "Settings saved." صحيحة دائماً، مهما كان اللون

تُكتب الإعدادات في قاعدة البيانات قبل تشغيل أي فحص للرخصة، لذا فإن الشريط الأحمر لا يعني أبداً "فشل الحفظ". بل يعني "حُفظت، ورُفض مفتاحك". ولن تضطر أبداً إلى إعادة كتابة النموذج.

حفظ الإعدادات غير المتعلقة بالرخصة لا يكلّف شيئاً

لا يُطلق الفحص إلا مفتاح رخصة تغيّر فعلاً. أما إيقاف المزامنة مؤقتاً، أو تغيير وجهة الطلبات، أو تعديل مسؤول الرد على التذاكر، فلا يجري أي اتصال شبكي على الإطلاق، ويبقى الشريط عبارة بسيطة هي "Settings saved."

Check licence now

يقع زر Check licence now في أعلى صفحة الوحدة في WHMCS، بجانب Test Connection و Run Sync Now.

وهو يفرض إعادة فحص فورية للمفتاح المخزّن أصلاً، متجاوزاً حد الفحص مرة واحدة يومياً. استخدمه عندما:

• تكون قد جدّدت رخصتك أو مدّدتها للتو وتريد استعادة Pro فوراً؛
• يعود الحفظ بشريط كهرماني وتكون قد أصلحت منذ ذلك الحين مشكلة الشبكة أو الجدار الناري؛
• تريد تأكيد الحالة الراهنة قبل فتح تذكرة دعم.

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

وفي حال عدم وجود أي مفتاح مخزّن، يجيب الزر بشريط أحمر يذكر أن المفتاح فارغ وأن التثبيت على الخطة المجانية. ولا يغادر أي طلب خادمك.

البقاء مفعّلاً: إعادة الفحص اليومية ومهلة السماح لمدة 14 يوماً

بمجرد تخزين مفتاح، يعيد cron الخاص بـ WHMCS التحقق منه مرة واحدة يومياً. ولا يتعين عليك فعل أي شيء.

وإذا تعذّر الوصول إلى خدمة الترخيص، فإن الوحدة لا توقف عملك. فتلك الحالة تُقرأ على أنها "لا نعرف"، لا على أنها "مرفوض"، وتُبقي مهلة سماح مدتها 14 يوماً خطة Pro تعمل بكامل طاقتها أثناء إعادة المحاولات.

وهناك ثلاث تفاصيل تستحق المعرفة:

• ساعة مهلة السماح تبدأ من آخر فحص ناجح، لا من آخر محاولة. فالعد التنازلي المعروض في الصفحة يمثل أياماً متبقية حقيقية، ولا يعيد ضبط نفسه في كل مرة تفشل فيها محاولة.
• الرفض الحقيقي ينهي مهلة السماح فوراً. فإذا صرّح خادم الترخيص بأن الرخصة منتهية أو ملغاة أو غير صالحة، فهذه إجابة، ولا تنطبق مهلة السماح. وحجب نقطة نهاية الترخيص في جدارك الناري لا يمكنه إبقاء رخصة ملغاة على قيد الحياة.
• مهلة السماح تمدّد ولا تؤسّس. فالمفتاح الذي لم يُؤكَّد ولو مرة واحدة لا يملك مهلة سماح يعتمد عليها. وإذا لصقت مفتاحاً جديداً تماماً بينما خدمة الترخيص غير قابلة للوصول، فسيُخزَّن المفتاح وتُعاد المحاولة، لكن Pro لن تُفعَّل إلى أن ينجح فحص فعلي.

حالات الخطة التي قد تراها في رأس الصفحة

نص الرأس	المعنى
Free plan - no licence key set.	لا يوجد مفتاح. هذه هي الخطة المجانية، وتعمل بشكل طبيعي.
Pro license set - awaiting first verification.	يوجد مفتاح مخزّن لكنه لم يُؤكَّد قط. انقر Check licence now.
Pro active until YYYY-MM-DD (UTC)	كل شيء على ما يرام.
Pro active - lifetime licence	رخصة بلا تاريخ انتهاء.
Pro (grace) - could not reach the licence server, retrying daily. Pro keeps working for N more day(s).	انقطاع مؤقت. لا شيء معطّل بالنسبة إليك حتى الآن.
Free plan - this licence has expired.	جدّد الرخصة، ثم انقر Check licence now.
Free plan - this licence was cancelled.	أُلغيت الرخصة أو جرى استردادها. تواصل مع الدعم إن كان ذلك خطأً.
Free plan - the licence key was rejected.	مفتاح خاطئ، أو استُنفدت حصة التفعيل. وتحمل الرسالة صياغة الخادم نفسه.
Free plan - the licence server could not be reached and the grace period has run out.	أصلح الاتصال بنقطة نهاية الترخيص، ثم انقر Check licence now.

وتظهر الجملة نفسها في صف License / plan ضمن قائمة تحقق الإعداد، فلا تضطر أبداً إلى البحث عنها.

خانات التفعيل

يستهلك كل تثبيت WHMCS خانة تفعيل واحدة من رخصتك. وتولّد الوحدة معرّفاً ثابتاً مرة واحدة وتعيد استخدامه إلى الأبد، لذا فإن إعادة الفحص أو إعادة الحفظ أو نقل موقعك إلى نطاق مختلف لا يستهلك خانة ثانية أبداً.

وإذا رأيت رفضاً يذكر أن الرخصة مستخدمة بالفعل على العدد الأقصى من التثبيتات، فإما أن تزيل المفتاح من التثبيت الذي لم يعد بحاجة إليه، وهو ما يحرّر الخانة فوراً، أو تتواصل مع الدعم بشأن حصتك.

إزالة مفتاح والعودة إلى الخطة المجانية

1. في WHMCS، افتح Addons > Perfex CRM Bridge > Settings > Pro licence.
2. أشّر على Remove the stored key (revert to Free).
3. انقر Save Settings.

وما يحدث هو:

• يعود التثبيت إلى الخطة المجانية فوراً، مهما كان ما لا يزال مخزناً مؤقتاً. وتتوقف ميزات Pro.
• تُحرَّر خانة التفعيل، فتصبح الرخصة قابلة للتفعيل على تثبيت آخر.
• يُبلَّغ جانب Perfex بخفض الخطة، كي لا تستمر لوحة WHMCS plan لديه في الإعلان عن Pro لبقية اليوم.

أزل المفتاح قبل ترحيل موقع أو إيقافه

إذا حذفت تثبيت WHMCS دون إزالة المفتاح أولاً، تبقى خانة تفعيله مستهلكة. وإزالة المفتاح تستغرق خمس ثوانٍ وتوفر عليك جولة مراسلات مع الدعم لاحقاً.

ماذا يحدث لبياناتك عند انتهاء Pro

لا يُحذف شيء. وفي التثبيت المجاني:

• تستمر مزامنة العملاء وجهات الاتصال في العمل، باتجاه واحد، تماماً كما كانت دائماً.
• يتوقف WHMCS عن إدراج أحداث الفواتير والمدفوعات والطلبات والخدمات والنطاقات والتذاكر في الطابور. فالبوابة تقع عند المصدر، وبذلك لا يتراكم شيء ولا تُعاد المحاولات بلا جدوى.
• تغييرات جانب Perfex التي كانت مدرجة أصلاً في الطابور لأجل WHMCS تُرفض برسالة واضحة هي "Two-way sync requires Pro on the WHMCS side" في لوحة Outbound queue، ثم تُعاد المحاولة، وتنتقل في النهاية إلى حالة الرسائل الميتة.
• يبقى كل ما جرت مزامنته أصلاً داخل Perfex. ولا يزال تبويب WHMCS في ملفات العملاء يعرض آخر اللقطات المخزّنة؛ لكنه يتوقف عن التحديث فقط.

وبمجرد إعادة تفعيل مفتاح صالح، يستأنف كل شيء عند الحدث التالي.

استكشاف أخطاء الترخيص وإصلاحها

العَرَض	السبب	الحل
حفظ المفتاح لا يُحدث أي أثر ظاهر	لصقت المفتاح نفسه المخزّن أصلاً. فلا يُطلق الفحص إلا مفتاح تغيّر.	انقر Check licence now.
الشريط كهرماني في كل مرة	خادمك لا يستطيع الوصول إلى نقطة نهاية الترخيص عبر HTTPS.	اسمح بحركة HTTPS الصادرة إلى api.freemius.com عبر أي جدار ناري أو وكيل خروج على خادم WHMCS. ثم انقر Check licence now.
رسالة "The licence key was rejected" رغم أن المفتاح يبدو صحيحاً	لصق ناقص، أو استنفاد حصة التفعيل.	أعد نسخ المفتاح من بريد الشراء دفعة واحدة. طول المفاتيح 32 حرفاً وقد تحتوي على علامات ترقيم، فلا تحذف منها شيئاً. وإذا ذكرت الرسالة عدد التثبيتات، فحرّر خانة.
Perfex لا يزال يعرض Free بينما WHMCS يعرض Pro	لم تكن حالة الخطة قد وصلت إلى Perfex بعد.	انقر Check licence now أو Test Connection في WHMCS؛ فكلاهما يوصل حالة الخطة إلى Perfex في الحال. ثم أعد تحميل صفحة إعدادات Perfex.
لوحة الخطة في Perfex تعرض Unknown	لم يبلّغ جانب WHMCS قط، أو لم يبلّغ منذ فترة طويلة.	انقر Test Connection في WHMCS، ثم أعد تحميل صفحة Perfex. فإن بقيت Unknown، فقد يكون cron الخاص بـ WHMCS متوقفاً، أو أن الجانبين لم يعودا مقترنين.

المزيد في استكشاف الأخطاء وإصلاحها.