كيف تُفعّل واتساب للأعمال API؟ دليل خطوة بخطوة
كيفية تفعيل واتساب للأعمال API خطوة بخطوة: حافظة الأعمال والتوثيق ورقم الهاتف واسم العرض وEmbedded Signup والقوالب وصولًا إلى الإطلاق الفعلي.
بقلم OmniChannels.ai Editorial Team · مراجعة BroadNet Messaging Solutions Team
واتساب
الإجابة المختصرة
لتفعيل WhatsApp Business API، أنشئ حافظة أعمال لدى Meta أو استخدم محفظتك الحالية، وأكمل توثيق النشاط التجاري، واختر رقم هاتف يستقبل رسالة SMS أو مكالمة صوتية وغير نشط على WhatsApp، واختر اسم عرض يطابق علامتك التجارية، واربط الرقم عبر مسار Embedded Signup لدى مزوّدك، وأضف وسيلة دفع، وسجّل الرقم برمز PIN للتحقق بخطوتين، ثم قدّم قوالب رسائلك الأولى للاعتماد قبل الإطلاق.
في هذه الصفحة
أهم النقاط
- بحسب Meta، يجب أن يكون رقم الهاتف المخصص للـ API مملوكًا لك، ويتضمن رمز الدولة والمنطقة، ويستقبل رسالة SMS أو مكالمة صوتية؛ والأرقام القصيرة (short codes) غير مدعومة.
- يجب حذف الأرقام المستخدمة حاليًا على WhatsApp من التطبيق قبل تسجيلها، ما لم يُستخدم خيار التعايش (coexistence) من Meta لأرقام Business App المؤهلة.
- يتيح Embedded Signup إنشاء حافظة أعمال وحساب WhatsApp Business ورقم هاتف أو اختيارها من داخل منصة المزوّد.
- يرفع توثيق النشاط التجاري عدد أرقام الهاتف التي يمكنك تسجيلها، وهو أحد الطرق للوصول إلى حدود مراسلة أعلى.
- اعتماد القوالب ووسيلة دفع صالحة ورمز PIN للتحقق بخطوتين هي العوائق المعتادة قبل الإطلاق.
هذا الدليل موجّه إلى مسؤول التسويق أو تجربة العملاء أو تقنية المعلومات الذي يتولى إطلاق نشاطه التجاري على WhatsApp Business API. يستعرض كل خطوة من خطوات التفعيل بالترتيب، ويشرح ما تفحصه Meta في كل مرحلة، وينتهي بقائمة تحقق للإطلاق وبأكثر الأخطاء التي تواجهها الفرق.
ما الذي تحتاجه قبل أن تبدأ؟
جهّز أربعة أشياء: صلاحية مدير على حافظة الأعمال الخاصة بشركتك لدى Meta، ومستندات نشاطك التجاري، ورقم هاتف مخصصًا، واسم علامة تجارية يعرفه العملاء. ومعظم حالات التأخير سببها غياب أحد هذه الأمور.
| العنصر | المتطلب | لماذا يهم |
|---|---|---|
| حافظة أعمال Meta | صلاحية مدير؛ واسم النشاط القانوني وعنوانه مُدخلان | تملك حساب WhatsApp Business (WABA) |
| مستندات النشاط | الرخصة التجارية أو السجل التجاري، وإثبات العنوان | مطلوبة لتوثيق النشاط التجاري |
| الموقع الإلكتروني | على نطاق تملكه، ويُظهر اسم نشاطك | يدعم التوثيق ومراجعة اسم العرض |
| رقم الهاتف | مملوك لك، برمز الدولة والمنطقة، ويستقبل SMS أو مكالمة صوتية | مطلوب للتسجيل؛ والأرقام القصيرة غير مدعومة |
| اسم العرض | يطابق علامتك التجارية وموقعك | يظهر في ملفك على WhatsApp وتراجعه Meta |
| وسيلة الدفع | بطاقة أو خط ائتمان المزوّد | مطلوبة لإرسال القوالب المدفوعة |
| آلية الموافقة (opt-in) | موافقة واضحة من العملاء على تلقي رسائل WhatsApp | تشترطها سياسة WhatsApp |
كيف تُفعّل WhatsApp Business API خطوة بخطوة؟
اتبع هذه الخطوات بالترتيب. وإذا كنت تفعّل عبر مزوّد، فعادةً ما تتم الخطوات من 3 إلى 6 داخل مسار Embedded Signup الخاص به.
الخطوة 1: جهّز حافظة أعمال Meta
سجّل الدخول إلى Meta Business Suite بحساب Facebook شخصي هو مدير في حافظة أعمال الشركة، أو أنشئ محفظة. استخدم الاسم القانوني والعنوان كما يظهران بالضبط في مستنداتك. وأضف مديرين اثنين على الأقل حتى لا تفقد الوصول إذا غادر أحدهما.
الخطوة 2: ابدأ توثيق النشاط التجاري
ابدأ توثيق النشاط التجاري من مركز الأمان (Security Centre) في حافظة أعمالك. تطلب Meta مستندات تؤكد الاسم القانوني والعنوان والهاتف أو البريد الإلكتروني، وقد تتحقق عبر رمز أو فحص للنطاق. تختلف المتطلبات بحسب الدولة وتتغير مع الوقت، لذا اتبع التعليمات الظاهرة على الشاشة.
يمكنك بدء التفعيل قبل اكتمال التوثيق، لكن Meta تطبق حدودًا أدنى حتى ذلك الحين: تبدأ المحافظ الجديدة برقمي هاتف مسجَّلين وحد مراسلة قدره 250 مستخدمًا فريدًا خارج نافذة خدمة العملاء، بحسب توثيق Meta.
الخطوة 3: اختر رقم الهاتف
اختر رقمًا سيبقى مع النشاط التجاري لسنوات، مثل خط أرضي أو خط جوال مخصص. تشترط Meta أن يكون الرقم:
- مملوكًا لك ويتضمن رمز الدولة والمنطقة؛
- قادرًا على استقبال رسالة SMS أو مكالمة صوتية للتحقق؛
- ليس رقمًا قصيرًا (short code)؛
- غير مسجَّل حاليًا على WhatsApp، إلا إذا استخدمت خيار التعايش (coexistence) من Meta لرقم تطبيق WhatsApp Business مؤهل.
إذا كان الرقم على WhatsApp أو تطبيق WhatsApp Business ولا تريد التعايش، فاحتفظ بنسخة احتياطية مما تحتاجه واحذف الحساب من التطبيق أولًا.
الخطوة 4: اختر اسم العرض
يظهر اسم العرض في ملفك على WhatsApp. استخدم اسم العلامة التجارية الذي يعرفه العملاء، متسقًا مع موقعك الإلكتروني ومستندات نشاطك. تجنب الأسماء العامة ("أفضل العروض")، أو الحروف الكبيرة غير المعتادة، أو إضافة الشعارات الترويجية. تراجع Meta الاسم؛ وتظهر حالته قيد المراجعة أو معتمدًا أو مرفوضًا في WhatsApp Manager.
الخطوة 5: اربط عبر Embedded Signup
Embedded Signup هو المسار من Meta الذي يضعه المزوّدون داخل منصاتهم. تسجّل الدخول عبر Facebook، وتختار حافظة الأعمال أو تنشئها، وتنشئ حساب WhatsApp Business أو تختاره، وتدخل رقم الهاتف واسم العرض، وتتحقق من الرقم برمز عبر SMS أو مكالمة صوتية. وفي النهاية يحصل المزوّد على إذن بإدارة الـ WABA نيابةً عنك، بينما تبقى الملكية لمحفظتك.
الخطوة 6: سجّل الرقم واضبط رمز PIN للتحقق بخطوتين
يجب تسجيل الرقم في Cloud API برمز PIN من ستة أرقام للتحقق بخطوتين. ويتولى مزوّدك ذلك عادةً ضمن التفعيل. احفظ الرمز بأمان: فهو مطلوب لتغيير الرمز أو حذف الرقم لاحقًا.
الخطوة 7: أضف وسيلة دفع
تحتسب Meta رسومًا لكل قالب رسالة مسلَّم، بحسب الفئة ودولة المستلم. أضف بطاقة إلى الـ WABA في WhatsApp Manager، أو تأكد أن خط ائتمان مزوّدك يغطي حسابك. وبدون فوترة صالحة تفشل عمليات إرسال القوالب.
الخطوة 8: أنشئ قوالبك الأولى
خارج نافذة خدمة العملاء البالغة 24 ساعة لا يمكنك إرسال سوى القوالب المعتمدة. ابدأ بثلاثة إلى خمسة قوالب تحتاجها من اليوم الأول:
- قالب تحديثات المعاملات (Utility) لتأكيد الطلب أو الحجز.
- قالب تحديثات المعاملات (Utility) لتحديث الحالة، مثل التوصيل أو التذكير.
- قالب مصادقة (Authentication) إذا كنت ترسل رموز تحقق لمرة واحدة.
- قالب تسويقي واحد لأول حملة موجهة إلى عملاء وافقوا على التلقي.
استخدم المتغيرات للأسماء وأرقام الطلبات، وأبعد اللغة الترويجية عن قوالب تحديثات المعاملات (Utility)، وأنشئ النسختين العربية والإنجليزية كلغتين منفصلتين للقالب نفسه إذا كنت تخدم عملاء في الخليج.
مثال تطبيقي: معهد تدريب في الدوحة يبدأ العمل
"أكاديمية الفنار" (مثال افتراضي) تريد استخدام WhatsApp لاستفسارات الدورات وتذكيرات الحصص.
- الأسبوع 1: يؤكد مدير العمليات صلاحية المدير على حافظة الأعمال، ويرفع السجل التجاري، ويبدأ التوثيق. وتختار الأكاديمية خطها الأرضي الرئيسي الذي يستقبل مكالمة صوتية.
- التفعيل: عبر Embedded Signup لدى المزوّد، تنشئ الأكاديمية WABA، وتدخل اسم العرض "Al Fanar Academy"، وتتحقق من الرقم بمكالمة صوتية.
- القوالب: تقدّم تذكير حصة (Utility) وتأكيد تسجيل (Utility) وإعلان فصل دراسي جديد (Marketing) بالعربية والإنجليزية. يُرفض القالب التسويقي بسبب دعوة غامضة لاتخاذ إجراء، ثم يُعتمد بعد إعادة صياغته.
- الإطلاق: ترسل التذكيرات إلى الطلاب الذين وافقوا على التلقي في نموذج التسجيل، وتوجّه الردود إلى صندوق فريق القبول.
أطول خطوة كانت التوثيق، لا الإعداد التقني.
قائمة التحقق للإطلاق
تأكد من كل بند قبل أول حملة.
- توثيق النشاط التجاري مُقدَّم أو معتمد.
- اسم العرض معتمد.
- رقم الهاتف مسجَّل ورمز PIN للتحقق بخطوتين محفوظ بأمان.
- وسيلة الدفع صالحة ومموَّلة.
- القوالب المطلوبة معتمدة بكل اللغات التي تحتاجها.
- موافقة التلقي (opt-in) مسجَّلة لكل جهة اتصال ستراسلها.
- صندوق الوارد جاهز، والموظفون معيَّنون للرد على الرسائل الواردة.
- رسائل اختبار أُرسلت إلى أرقام داخلية وفُحصت على Android وiOS.
- تقارير التسليم راجعتها لعمليات الإرسال التجريبية.
- حجم الإرسال مخطَّط ضمن حد المراسلة الحالي لديك.
ما أكثر أخطاء الإعداد شيوعًا؟
تندرج معظم الأخطاء ضمن أنماط قليلة. يسردها توثيق رموز الأخطاء لدى Meta؛ وهذه أكثر ما تراه فرق التفعيل.
| رمز الخطأ | المعنى (بحسب Meta) | الحل المعتاد |
|---|---|---|
| 133010 | رقم الهاتف غير مسجَّل | أكمل التسجيل برمز PIN للتحقق بخطوتين |
| 131047 | نافذة خدمة العملاء مغلقة | أرسل قالبًا معتمدًا بدل النص الحر |
| 132001 | القالب غير موجود بتلك اللغة أو غير معتمد | تحقق من اسم القالب ورمز اللغة وحالة الاعتماد |
| 132012 | قيم المتغيرات لا تطابق تنسيق القالب | طابِق عدد المتغيرات وتنسيقها |
| 131042 | مشكلة في وسيلة الدفع | أصلح البطاقة أو خط الائتمان على الـ WABA |
| 131026 | تعذّر تسليم الرسالة | قد لا يستخدم المستلم WhatsApp أو يستخدم نسخة قديمة من التطبيق؛ استخدم قناة أخرى |
| 131049 | حُجبت الرسالة حفاظًا على صحة المنظومة | غالبًا بسبب تكرار الرسائل التسويقية؛ انتظر قبل إعادة الإرسال وراجع الاستهداف |
| 368 | الحساب مقيَّد بسبب مخالفة للسياسة | راجع إشعارات السياسة في WhatsApp Manager وقدّم اعتراضًا إن كان مناسبًا |
وهناك مشكلات متكررة أخرى ليست رموز أخطاء: رقم ما زال نشطًا على تطبيق WhatsApp، واسم عرض لا يطابق الموقع الإلكتروني، ومديرون لا يملكون تحكمًا كاملًا في المحفظة.
كيف تساعدك OmniChannels.ai؟
تفعّل OmniChannels.ai، المدعومة من BroadNet Technologies، أرقام WhatsApp Business API عبر Meta Embedded Signup، فتحتفظ حافظة أعمالك بملكية الـ WABA. يمكنك إنشاء قوالب التسويق (Marketing) وتحديثات المعاملات (Utility) والمصادقة (Authentication)، بما فيها رموز OTP بأنماط one-tap وzero-tap وcopy-code، بمتغيرات ووسائط وأزرار، ثم معاينتها على الهاتف وتتبع اعتمادها. وبعد الإطلاق تدعم الحملات رفع ملفات Excel/CSV والمعاينة والجدولة وتصفية التكرار، مع تقارير تسليم لكل عملية إرسال. وتُدعم العربية والإنجليزية. راجع صفحة WhatsApp Business API والحملات، أو احجز عرضًا توضيحيًا.
الأسئلة الشائعة
هل يمكنني استخدام رقم WhatsApp الحالي للـ API؟
نعم، بشروط. تنص Meta على أن الأرقام المستخدمة حاليًا مع WhatsApp يجب حذفها من التطبيق قبل تسجيلها في الـ API. وبالنسبة لأرقام تطبيق WhatsApp Business المؤهلة، تقدّم Meta أيضًا خيار التعايش (coexistence) أثناء Embedded Signup ليبقى التطبيق يعمل على الرقم نفسه. تحقق من الأهلية في سوقك قبل أن تقرر.
هل توثيق النشاط التجاري لدى Meta إلزامي؟
يمكنك البدء بالإرسال قبل التوثيق، لكن بحدود أدنى. بحسب Meta، تبدأ المحافظ الجديدة برقمي هاتف مسجَّلين وحد مراسلة قدره 250 مستخدمًا فريدًا خارج نافذة الخدمة؛ وتوثيق النشاط التجاري هو إحدى الطرق لرفع سقف عدد الأرقام والتأهل لحد مراسلة أعلى. ينبغي لمعظم الشركات النامية أن توثّق مبكرًا.
ما المستندات المطلوبة لتوثيق النشاط التجاري؟
تطلب Meta عمومًا مستندات تثبت الاسم القانوني للنشاط وعنوانه ورقم هاتفه، مثل الرخصة التجارية أو السجل التجاري أو فاتورة خدمات، إضافة إلى موقع إلكتروني على نطاق تملكه. تختلف المتطلبات بحسب الدولة وتتغير مع الوقت، لذا اتبع التعليمات الظاهرة في مركز الأمان (Security Centre) في Meta Business Suite لمحفظتك.
لماذا رُفض اسم العرض الخاص بي؟
يُرفض اسم العرض عادةً عندما لا يرتبط بوضوح بالنشاط التجاري، أو يستخدم مصطلحات عامة فقط، أو يسيء استخدام الحروف الكبيرة أو علامات الترقيم، أو لا يمكن ربطه بموقعك الإلكتروني أو بنشاط موثّق. استخدم اسم العلامة التجارية الذي يعرفه العملاء، وتأكد من ظهوره في موقعك، ثم أعد التقديم بهوية متسقة.
هل أحتاج إلى مطوّر لتفعيل WhatsApp Business API؟
لا، عندما يقدّم المزوّد Embedded Signup ومنصة جاهزة بصندوق وارد وقوالب وحملات. يلزم مطوّر إذا أردت استدعاء الـ API مباشرة، أو استقبال webhooks في أنظمتك، أو ربط WhatsApp بنظام CRM أو منصة الطلبات لديك.
المصادر
تابع القراءة
مزيد من الأدلةواتساب
فئات قوالب WhatsApp والموافقة عليها وإعادة التصنيف
فئات قوالب WhatsApp: قواعد الفئات التسويقية وتحديثات المعاملات (Utility) والمصادقة، وأسباب رفض القوالب أو إعادة تصنيفها، وكيف تحصل على الموافقة وتحافظ على جودة القالب.
8 دقائق للقراءة
واتساب
روابط المحادثة المباشرة ورموز QR في واتساب: دليل عملي
كيف تنشئ روابط wa.me برسائل معبّأة مسبقاً ورموز QR لواتساب للمطبوعات والتغليف والمتاجر، وكيف تتتبع أي موضع بدأ كل محادثة وتقيس أثره.
8 دقائق للقراءة
التسويق
رسائل المرضى في القطاع الصحي: التذكيرات والنتائج والخصوصية
كيف تراسل العيادات والمستشفيات المرضى عبر WhatsApp وSMS: المواعيد وتعليمات ما قبل الزيارة وإشعارات جاهزية النتائج دون بيانات صحية، مع الموافقة والخصوصية.
8 دقائق للقراءة
