التهيئة

بعد تثبيت وتنشيط وحدة تكامل WHMCS، تحتاج لتهيئة الاتصال بنسخة WHMCS الخاصة بك وتحديد كيفية تدفق البيانات إلى Perfex CRM. تغطي هذه الصفحة إعداد API وتفضيلات المزامنة وربط الحقول والجدولة الآلية.

الاتصال بـ WHMCS

تتواصل الوحدة مع WHMCS من خلال API الرسمي. ستحتاج إلى بيانات اعتماد API صالحة قبل المتابعة.

إنشاء بيانات اعتماد WHMCS API

1. سجّل الدخول إلى لوحة إدارة WHMCS.
2. انتقل إلى Setup > Staff Management > Manage API Credentials.
3. انقر Generate New API Credential.
4. أدخل وصفاً (مثل "Perfex CRM Integration").
5. انسخ API Identifier وAPI Secret — ستحتاج كليهما في الخطوة التالية.

تحذير

احفظ بيانات اعتماد API بشكل آمن. يُعرض API Secret مرة واحدة فقط أثناء الإنشاء. إذا فُقد، ستحتاج لإنشاء بيانات اعتماد جديدة.

إدخال بيانات الاعتماد في Perfex CRM

1. في Perfex CRM، انتقل إلى إعدادات وحدة WHMCS Integration.
2. أدخل التفاصيل التالية:
   • WHMCS URL — عنوان URL الكامل لتثبيت WHMCS الخاص بك (مثل https://billing.example.com)
   • API Identifier — المعرّف المُنشأ في الخطوة السابقة
   • API Secret — المفتاح السري المُنشأ في الخطوة السابقة
3. انقر Test Connection للتحقق من أن Perfex CRM يمكنه التواصل بنجاح مع نسخة WHMCS الخاصة بك.
4. انقر Save Settings بمجرد نجاح اختبار الاتصال.

تلميح

إذا فشل اختبار الاتصال، تأكد من أن عنوان IP خادم Perfex CRM مُدرج في القائمة البيضاء في WHMCS تحت Setup > General Settings > Security > API IP Access Restriction. تحقق أيضاً من تهيئة HTTPS وصحة عنوان URL لـ WHMCS.

إعدادات المزامنة

تتيح لك لوحة إعدادات المزامنة التحكم في البيانات المُستوردة وكيفية التعامل معها داخل Perfex CRM.

أنواع البيانات

نوع البيانات	الوصف
Clients	مزامنة ملفات العملاء بما في ذلك الاسم والبريد الإلكتروني والهاتف والعنوان وتفاصيل الشركة
Invoices	مزامنة الفواتير مع البنود والإجماليات والضرائب وحالة الدفع وتواريخ الاستحقاق
Contacts	مزامنة جهات الاتصال الإضافية المرتبطة بكل حساب عميل WHMCS

فعّل أو عطّل كل نوع بيانات حسب احتياجاتك. كحد أدنى، يجب تفعيل Clients لأن الفواتير وجهات الاتصال مرتبطة بسجلات العملاء.

التعامل مع التكرارات

عندما يتطابق سجل مُزامن مع عميل موجود في Perfex CRM (مطابقة بعنوان البريد الإلكتروني)، يمكنك اختيار كيفية التعامل مع التعارض:

• Skip — لا تستورد السجل إذا كان تطابق موجوداً بالفعل
• Update — استبدل سجل Perfex CRM الحالي ببيانات WHMCS
• Create New — أنشئ سجلاً منفصلاً بغض النظر عن التكرارات

معلومات

الإعداد المُوصى به هو Update، الذي يحافظ على بيانات Perfex CRM متزامنة مع WHMCS مع تجنب إدخالات عملاء مكررة.

ربط الحقول

يتيح لك قسم ربط الحقول تحديد كيفية تطابق حقول WHMCS مع حقول Perfex CRM. تأتي الوحدة بإعدادات افتراضية معقولة، لكن يمكنك تخصيص الربط لـ:

• الحقول القياسية — الاسم والبريد الإلكتروني والهاتف والعنوان والشركة والمدينة والولاية والرمز البريدي والدولة
• الحقول المخصصة — ربط حقول WHMCS المخصصة بحقول Perfex CRM المخصصة

لتعديل ربط الحقول:

1. اذهب إلى WHMCS Integration > Settings > Field Mapping.
2. لكل حقل WHMCS، اختر حقل Perfex CRM المقابل من القائمة المنسدلة.
3. انقر Save Mapping.

جدول المزامنة الآلي

بدلاً من تشغيل المزامنة يدوياً، يمكنك تهيئة جدول آلي باستخدام مهمة cron على الخادم.

إعداد مهمة Cron

أضف الإدخال التالي إلى crontab الخادم لتشغيل المزامنة بالفترة المطلوبة:

# Run WHMCS sync every 6 hours
0 */6 * * * php /path/to/perfex/index.php whmcs_integration sync >/dev/null 2>&1

اضبط توقيت cron بناءً على مدى تكرار تغيّر بيانات WHMCS. الفترات الشائعة تشمل:

الفترة	تعبير Cron	حالة الاستخدام
كل ساعة	0 * * * *	بيئات فوترة عالية الحجم
كل 6 ساعات	0 */6 * * *	الاستخدام القياسي (مُوصى به)
مرة يومياً	0 2 * * *	بيئات منخفضة الحجم

تحذير

تشغيل المزامنة بشكل متكرر جداً على مجموعات بيانات كبيرة قد يزيد حمل الخادم. راقب موارد خادمك بعد تفعيل المزامنة الآلية واضبط الفترة وفقاً لذلك.

ما التالي؟

• دليل الاستخدام — تعلم كيفية تشغيل المزامنة اليدوية وإدارة العملاء والفواتير المُستوردة واستخدام الروبوتات والقوالب وجهات الاتصال الجماعية