WAPI Connect Pro
القائمة
الدليل

أنشئ تطبيقك في Meta

15 دقيقة تقريباً · آخر مراجعة 31 أكتوبر 2026 · الإصدار 2.10.0

يتصل متجرك بواجهة WhatsApp Cloud API الرسمية من Meta عبر تطبيق في Meta تملكه أنت. في نهاية هذا الشرح سيكون لديك حساب مطوّر، وحافظة أعمال باسمك، وتطبيق لواتساب جاهز لإضافة رقمك.

قد تتغيّر شاشات Meta

أسماء الأزرار في هذا الشرح مكتوبة كما ظهرت في شاشات Meta الإنجليزية يوم 17 أكتوبر 2026. إذا وجدت زراً باسم مختلف قليلاً، فابحث عن أقرب اسم إليه، فالخطوات نفسها لا تتغيّر. وإذا كانت لغة فيسبوك لديك هي العربية، فقد تظهر بعض الشاشات بأسماء عربية.

ما تحتاج إليه

  • حساب فيسبوك تسجّل به الدخول إلى موقع المطوّرين في Meta. استخدم حسابك الخاص، وليس حساباً مشتركاً.
  • اسم نشاطك التجاري وعنوانه، وبريد إلكتروني تتابعه. اكتبها كما هي في مستنداتك الرسمية، لأن Meta تراجعها إذا وثّقت نشاطك لاحقاً.
  • جهاز كمبيوتر، لأن استخدام موقع المطوّرين صعب على الجوال.
  • رابط صفحة سياسة الخصوصية في متجرك، مثل https://your-store.com/privacy-policy/. وفي ووردبريس ← «الإعدادات» ← «الخصوصية» ← «دليل السياسة» (Policy Guide) تجد نصاً مقترحاً من الإضافة يمكنك إضافته إلى هذه الصفحة.

خطوات إنشاء التطبيق

  1. أنشئ حساب مطوّر في Meta

    افتح developers.facebook.com، وسجّل الدخول بحساب فيسبوك. في المرة الأولى اضغط «Get started». ستطلب منك Meta أن توافق على شروطها، وأن تؤكّد رقم هاتفك أو بريدك الإلكتروني، وأن تختار الوصف الأنسب لك. عند الانتهاء يظهر «My Apps» في أعلى الصفحة.

  2. أنشئ حافظة أعمال أو اختر حافظتك الحالية

    حافظة الأعمال في Meta (Business portfolio) تجمع تطبيقك وحساب واتساب ورقمك، وكانت Meta تسميها سابقاً Business Manager. افتح business.facebook.com. إذا كنت تنشر إعلانات لمتجرك على فيسبوك أو إنستغرام، فالأرجح أن لديك حافظة بالفعل، فاستخدمها. وإن لم تكن لديك حافظة، فاختر «Create a business portfolio»، واكتب اسم نشاطك، واسمك، وبريدك الإلكتروني للعمل.

    تحتاج إلى صلاحية مدير كاملة (Admin) على الحافظة. هل تُعدّ الحافظة لأحد عملائك؟ استخدم حافظة العميل نفسه، واطلب منه أن يمنحك صلاحية. بذلك يبقى الرقم وسجل محادثاته لدى العميل.

  3. أنشئ التطبيق

    ارجع إلى developers.facebook.com، وافتح «My Apps»، ثم اضغط «Create app». في «App details» اكتب اسماً للتطبيق (اسم متجرك خيار مناسب) وبريداً إلكترونياً للتواصل، ثم اضغط «Next».

  4. اختر حالة الاستخدام الخاصة بواتساب

    في «Use cases» اختر «Connect with customers through WhatsApp»، ثم اضغط «Next». إذا كانت القائمة طويلة، فقد تجدها تحت تصنيف مثل «Business messaging».

  5. اربط التطبيق بحافظة أعمالك

    اختر حافظة الأعمال من الخطوة 2، ثم اضغط «Next». تعرض Meta بعد ذلك ملخصاً بما تحتاج إليه حالة الاستخدام. اضغط «Go to dashboard» (أو «Create app»). وقد تطلب منك Meta كلمة مرور فيسبوك.

  6. افتح قسم واتساب في تطبيقك

    في لوحة التطبيق افتح «Use cases»، واضغط «Customize» بجانب «Connect with customers through WhatsApp». وفي اللوحات القديمة، يظهر واتساب عنصراً مستقلاً في القائمة الجانبية. اتبع خطوات Meta حتى تبدأ استخدام الواجهة (API). ستربط Meta حساب واتساب للأعمال (WABA) بحافظتك، وتمنحك رقماً تجريبياً.

    لديك الآن الصفحتان اللتان ستحتاج إليهما في الشروح التالية: صفحة API Setup، وفيها أرقام هواتفك، ومعرّف رقم الهاتف (Phone Number ID) ومعرّف حساب واتساب للأعمال (WhatsApp Business Account ID)، وصفحة Configuration، وفيها إعدادات رابط الاستقبال (Webhook).

  7. املأ الإعدادات الأساسية

    افتح «App settings» ← «Basic». اكتب رابط سياسة الخصوصية لمتجرك في «Privacy Policy URL»، ثم اضغط «Save changes». ستحتاج إلى هذا الرابط لتحويل التطبيق إلى وضع Live في نهاية شرح رابط الاستقبال.

    في الصفحة نفسها تجد معرّف التطبيق App ID، والمفتاح السري للتطبيق App Secret (اضغط «Show» لإظهاره). يوضّح لك شرح رابط الاستقبال أين تلصق هذا المفتاح. واحفظه سراً كما تحفظ كلمة المرور.

تأكّد من نجاح الخطوات

  • يظهر تطبيقك في «My Apps» في developers.facebook.com.
  • يظهر التطبيق نفسه في إعدادات أعمالك (business.facebook.com/settings) تحت «Accounts» ← «Apps». وهذا يعني أنه تابع لحافظة أعمالك.
  • يحتوي تطبيقك على صفحة API Setup، وفيها رقم تجريبي من Meta.

الخطوة التالية: أضف رقمك الخاص باتباع شرح رقم الهاتف.

مشكلات شائعة وحلولها

لا أجد «Connect with customers through WhatsApp»

تصفّح كل حالات الاستخدام، أو ابحث في القائمة عن كلمة «WhatsApp». ما زالت بعض الحسابات تعرض أنواع التطبيقات بدلاً من حالات الاستخدام. في هذه الحالة اختر النوع «Business»، ثم أضف واتساب من لوحة التطبيق («Add product» ← WhatsApp ← «Set up»).

هل يمكنني استخدام تطبيق أنشأته من قبل؟

نعم، إذا كان تابعاً لحافظة الأعمال نفسها، وأُضيف إليه واتساب. لكن التطبيق يرسل أحداث واتساب إلى رابط استقبال (Callback URL) واحد فقط. فإذا كانت أداة أخرى تستخدم التطبيق نفسه، فأنشئ تطبيقاً جديداً لمتجرك، حتى لا تستقبل إحدى الأداتين رسائل الأخرى.

هل يجب أن تراجع Meta تطبيقي؟

لا، ليس في هذه الحالة. فالتطبيق الذي يعمل فقط مع حافظة أعمالك وحساب واتساب الخاص بك ورقمك لا يحتاج إلى مراجعة التطبيقات (App Review) من Meta. فهذه المراجعة مخصّصة للتطبيقات التي تدير حسابات واتساب لشركات أخرى.

تطلب Meta توثيق نشاطي التجاري. هل يجب أن أوثّقه الآن؟

يمكنك البدء بدونه، وتوثيق نشاطك (Business verification) لاحقاً من إعدادات الأعمال، وقد يستغرق ذلك بضعة أيام. ويرفع التوثيق عدد العملاء الذين يمكنك بدء محادثة معهم كل يوم. فالحسابات الجديدة تبدأ بحد منخفض (250 عميلاً في اليوم وقت كتابة هذا الشرح، 17 أكتوبر 2026).

باسم من يجب أن يكون التطبيق وحافظة الأعمال؟

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

لا تريد إعداد خطوات Meta بنفسك؟

في خدمة الإعداد (تُدفع مرة واحدة) نُعدّ معك التطبيق، ورقمك، ورمز الوصول الدائم، ورابط الاستقبال، على حساب Meta الخاص بك.