إنتقل إلى المحتوى الرئيسي

التهيئة

بعد تثبيت وتنشيط وحدة WhatsApp Cloud API Chat & Marketing، تحتاج لتهيئة الاتصال بين Perfex CRM وMeta WhatsApp Cloud API. يتضمن ذلك إعداد تطبيق Meta، وإنشاء بيانات اعتماد API، وتهيئة webhooks، وضبط إعدادات الوحدة.

تهيئة تطبيق Meta​

يتم الوصول إلى WhatsApp Cloud API من خلال تطبيق Meta (Facebook). إذا لم تقم بإنشاء واحد بعد، اتبع هذه الخطوات.

الخطوة 1 — إنشاء حساب Facebook Developers​

  1. اذهب إلى developers.facebook.com.
  2. سجّل الدخول بحساب Facebook الخاص بك.
  3. إذا طُلب منك، سجّل كمطور بقبول الشروط والتحقق من حسابك.

الخطوة 2 — إنشاء تطبيق Meta​

  1. في لوحة تحكم Facebook Developers، انقر Create App.
  2. اختر Business كنوع التطبيق (أو Other إذا لم يكن Business متاحاً لنوع حسابك).
  3. أدخل اسم التطبيق (مثل "Perfex CRM WhatsApp") وبريدك الإلكتروني للتواصل.
  4. اختر حساب الأعمال الخاص بك (أو أنشئ واحداً إذا لزم الأمر).
  5. انقر Create App.

الخطوة 3 — إضافة WhatsApp إلى تطبيقك​

  1. في لوحة تحكم تطبيقك الجديد، ابحث عن WhatsApp في قائمة المنتجات وانقر Set Up.
  2. اتبع الإعداد الموجّه لربط حساب WhatsApp Business.
  3. يتم توفير رقم هاتف اختباري تلقائياً للتطوير. يمكنك إضافة رقم هاتف أعمالك المحقق لاحقاً.
معلومات

رقم الهاتف الاختباري يتيح لك إرسال رسائل إلى ما يصل إلى 5 أرقام مسجلة مسبقاً. للاستخدام الإنتاجي، أضف وحقق رقم هاتف أعمالك الخاص في إعدادات حساب WhatsApp Business.

الخطوة 4 — إنشاء رمز وصول دائم​

رمز الوصول المؤقت الافتراضي ينتهي بعد 24 ساعة. للإنتاج، أنشئ رمز مستخدم نظام دائم:

  1. اذهب إلى business.facebook.com وانتقل إلى Business Settings > System Users.
  2. أنشئ مستخدم نظام جديد (أو استخدم موجوداً) بصلاحيات Admin.
  3. انقر Generate New Token، اختر تطبيق WhatsApp الخاص بك، وامنح الأذونات التالية:
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. انسخ الرمز المُنشأ — هذا هو رمز الوصول الدائم الخاص بك.
تحذير

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

تهيئة Webhook​

تسمح Webhooks لـ WhatsApp بإشعار نسخة Perfex CRM الخاصة بك بالرسائل الواردة وإيصالات التسليم وتحديثات الحالة في الوقت الفعلي.

إعداد Webhook​

  1. في لوحة تحكم Facebook Developers، اذهب إلى صفحة WhatsApp > Configuration في تطبيقك.
  2. تحت Webhook، انقر Edit.
  3. أدخل عنوان URL للاستدعاء المقدم من الوحدة (موجود في WhatsApp Module > Settings في Perfex CRM). عادةً يتبع هذا التنسيق: 
    https://your-perfex-domain.com/whatsapp_cloud_api/webhook
  4. أدخل رمز التحقق المعروض في إعدادات الوحدة.
  5. انقر Verify and Save.
  6. اشترك في حقول webhook التالية:
    • messages
    • message_template_status_update
تلميح

يجب أن يعمل تثبيت Perfex CRM عبر HTTPS بشهادة SSL صالحة. ستقوم Meta برفض عناوين URL لـ webhook التي تستخدم HTTP أو تحتوي على شهادات غير صالحة/موقعة ذاتياً.

إعدادات الوحدة​

بعد إكمال إعداد تطبيق Meta، هيّئ الوحدة داخل Perfex CRM.

  1. انتقل إلى وحدة WhatsApp Cloud API في الشريط الجانبي لـ Perfex CRM.
  2. اذهب إلى Settings وأدخل ما يلي:
الإعدادالوصف
Access Tokenرمز مستخدم النظام الدائم المُنشأ أعلاه
Phone Number IDموجود في صفحة WhatsApp > Getting Started في تطبيق Meta
WhatsApp Business Account IDموجود في إعدادات WhatsApp في تطبيق Meta
Webhook Verify Tokenسلسلة نصية مخصصة تحددها — يجب أن تتطابق مع ما أدخلته في إعداد webhook لـ Meta
App IDمعرّف تطبيق Meta الخاص بك (موجود في لوحة تحكم التطبيق)
  1. انقر Save Settings.
  2. استخدم زر Test Connection للتحقق من أن الوحدة يمكنها التواصل مع WhatsApp Cloud API.

تهيئة التضمين​

للإعدادات المتقدمة، تدعم الوحدة تضمين أداة محادثة WhatsApp في صفحات خارجية أو بوابات العملاء. انتقل إلى WhatsApp Module > Settings > Embed لإنشاء مقتطف كود التضمين وتخصيص مظهر الأداة (الألوان، الموضع، رسالة الترحيب).

التحقق من الأعمال​

لفتح سعة المراسلة الكاملة والوصول إلى جميع فئات القوالب، أكمل التحقق من أعمالك في Meta:

  1. اذهب إلى business.facebook.com > Business Settings > Security Center.
  2. انقر Start Verification واتبع العملية الموجّهة.
  3. أرسل مستندات أعمالك حسب طلب Meta.
  4. يستغرق التحقق عادةً 2-5 أيام عمل.
معلومات

بدون التحقق من الأعمال، تقتصر مراسلاتك على 250 مستلماً فريداً في كل فترة 24 ساعة متحركة. بعد التحقق، تزداد الحدود تدريجياً بناءً على جودة الرسائل وحجمها.

ما التالي؟​

  • دليل الاستخدام — تعلم كيفية استخدام واجهة المحادثة وتشغيل الحملات وتهيئة الروبوتات وإدارة القوالب
  • سجلات WhatsApp — عرض سجلات شاملة لجميع التفاعلات الآلية