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

إعداد واتساب Business API: المتطلبات والخطوات

دليل إعداد منصة واتساب الرسمية: أصول Meta والرقم والصلاحيات والقوالب والدفع والويب هوك والاختبارات وملكية الاسترداد.

إعداد واتساب Business API: المتطلبات والخطوات

يربط إعداد WhatsApp Business API رقم الشركة بمنصة واتساب للأعمال الرسمية من Meta حتى تستقبل البرامج الرسائل، ويعمل فريق كامل، وترسل القوالب المعتمدة، وتنفذ الأتمتة والتكاملات. يبدأ الإعداد الآمن بالملكية والاستعداد، لا بنسخ رمز وصول إلى أداة مجهولة.

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

المتطلبات قبل البدء

  • محفظة أعمال تملكها الشركة ومدير مخول. وجود مدير مناسب إضافي توصية لاستمرارية العمل، وليس شرطاً عاماً ثابتاً من Meta.
  • بيانات النشاط القانونية والموقع والبريد والعنوان والمستندات التي قد تطلبها Meta.
  • رقم مناسب لمسار الربط: جديد، أو منقول، أو رقم تطبيق أعمال مؤهل للتعايش.
  • إمكانية استقبال مكالمة أو رسالة أو تأكيد داخل التطبيق عند طلب Meta.
  • اسم عرض يمثل النشاط بدقة.
  • وسيلة دفع تملكها الشركة إذا تطلب الحساب ذلك.
  • مسؤولون معروفون للاسترداد والفوترة والقوالب والحملات والتكاملات.

اختر مسار الإعداد

المسارالأنسبأهم اعتبار
الإعداد المضمن عبر منصةشركة تريد صندوقاً وحملات وأتمتة دون بناء كل شيءاحتفاظ الشركة بملكية أصول Meta
بناء Cloud API مباشرفريق هندسي يبني تطبيق المراسلةيمتلك إعداد التطبيق والرموز والويب هوك والأمان والتشغيل
التعايش مع تطبيق الأعمالفريق مؤهل يريد إبقاء التطبيق أثناء الانتقالتحدد Meta أهلية الرقم
نقل رقم رسميرقم على المنصة ينتقل بين مزودينخطط للقوالب والفوترة والويب هوك والتراجع

يذكر مرجع Cloud API الرسمي من Meta محفظة الأعمال وحساب واتساب للأعمال ورقم النشاط كأصول أساسية.

خطوات الإعداد

  1. أمّن محفظة الأعمال: راجع المديرين والمصادقة واحذف الحسابات القديمة وسجل مسؤول الاسترداد.
  2. ابدأ إعداد Meta الرسمي: سجل الدخول من المنصة أو مسار المطور، ولا تعط مزوداً كلمة مرورك.
  3. اختر أو أنشئ WABA: استخدم الحساب المملوك للشركة والمخصص للرقم والفوترة.
  4. أضف الرقم: اختر المسار القياسي أو النقل أو التعايش وأكمل التحقق الذي تعرضه Meta.
  5. راجع اسم العرض والملف: استخدم بيانات العلامة الصحيحة وانتظر المراجعة عند الحاجة.
  6. اضبط الدفع والقوالب: أضف وسيلة الدفع وقدّم رسائل مرتبطة بحالات حقيقية.
  7. اربط الأحداث: اشترك في الويب هوك المطلوب وتحقق من توقيع الطلبات.
  8. اختبر الاتجاهين: النص والوسائط والرد والقالب وحالات التسليم والإلغاء والتحويل البشري.

الإعداد عبر WA Smart Sender

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

دليل إعداد اتصال واتساب Business API
شاهد دليل الاتصالات قبل ربط رقم الإنتاج.

قائمة اختبار الإنتاج

  • تنشئ رسالة واردة جهة الاتصال الصحيحة أو تطابقها.
  • يرد موظف باسمه ويرى الآخرون ملكية المحادثة.
  • تتحدث حالات التسليم والقراءة والفشل.
  • يصل قالب معتمد إلى جهة اختبار موافقة عند الحاجة.
  • توقف كلمة الإلغاء الحملات اللاحقة.
  • تتوقف الأتمتة عند استلام موظف وتملك بديلاً آمناً.
  • تطابق الوسائط والاحتفاظ والصلاحيات سياسة الشركة.
  • لا تكرر إعادة الويب هوك الرسائل أو الإجراءات.
  • يمكن استرداد الإدارة دون الاعتماد على موظف أو وكالة واحدة.

أعطال شائعة

اختيار محفظة أو WABA خاطئ

توقف قبل إضافة رقم الإنتاج وتحقق من المالك والمديرين بدلاً من إنشاء حسابات مكررة.

تعذر التحقق من الرقم

راجع مسار الربط والوصول للرقم وتسجيله الحالي والتحقق بخطوتين وتعليمات Meta. لا تكرر تخمين الرموز.

الشروط أو الدفع أو التوثيق غير مكتمل

اقرأ حالة الجاهزية وأكمل متطلب Meta المحدد؛ قد يكون الرقم متصلاً لكنه غير قادر على بدء الرسائل.

الوارد يصل والرد يفشل

افحص حالة الرقم والصلاحيات والويب هوك والدفع والقالب ورمز الخطأ من Meta.

الأمان والملكية

استخدم أقل صلاحية وهوية تملكها الشركة وحفظ الأسرار والتحقق من توقيع الويب هوك وسجل التدقيق وخطة خروج الموظف. لا تنشر رموز الوصول في الكود أو الصور. يجب أن تعرف الشركة كيف تلغي المزود وتحتفظ برقمها وأصولها.

أسئلة شائعة

هل Cloud API هو الـAPI الرسمي؟

نعم، تستضيفه Meta وهو جزء من منصة واتساب للأعمال الرسمية.

هل أحتاج إلى مطور؟

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

هل يمكن إبقاء تطبيق واتساب بزنس؟

توفر Meta التعايش للأرقام المؤهلة. تظهر الإتاحة أثناء الإعداد؛ راجع دليل التعايش.

كم يستغرق الإعداد؟

قد يكون الربط سريعاً عند جاهزية الأصول، لكن مراجعة الاسم والتوثيق والدفع والنقل والأهلية تضيف وقتاً. لا توجد مدة واحدة مضمونة.

متى أطلق الحملات؟

بعد نجاح خدمة الوارد والقوالب والموافقة والإلغاء والدفع ومراقبة الجودة والملكية ومعالجة الفشل.

اجعل الاتصال قابلاً للاسترداد

وثق معرفات الأصول والمديرين والاسترداد ومسار الرقم والفوترة ومسؤول التكامل. ثم اختبر الاتصال وأضف الأتمتة بعد ثبات الرسائل والملكية البشرية.

احفظ سجل تسليم واضحاً

سجل معرف محفظة الأعمال وWABA وPhone Number ID بصورة منفصلة؛ رقم الهاتف الظاهر ليس هو معرف الإرسال عبر API. أضف مسؤول الفوترة والتكامل والاسترداد، وحدد مكان حفظ الأسرار دون وضع رموز الوصول نفسها في وثيقة مشتركة.

لكل اختبار سجل التوقيت وجهة الاختبار والنتيجة المتوقعة وما حدث فعلياً والمراجع المسؤول. نجاح رسالة واردة لا يثبت نجاح بدء محادثة بقالب أو إيقاف الرسائل أو استرداد الإدارة. احتفظ بالحالات الفاشلة مفتوحة حتى معالجة سببها.