كيف تفعّل إشعارات واتساب في تطبيقات codeyy؟ دليل عملي

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

لماذا واتساب تحديداً لتطبيقك في الخليج؟

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

فكّر في متجر عبايات صغير في الرياض. العميلة تطلب، ثم تنتظر. إن وصلتها رسالة واتساب تقول «طلبك رقم 1042 خرج للتوصيل وسيصلك اليوم بين 4 و6 مساءً»، فقد وفّرت على نفسك مكالمة استفسار، ووفّرت عليها القلق. هذا هو الفرق الحقيقي.

الاستخدامات الأكثر نفعاً التي رأيتها في المشاريع الخليجية:

• تأكيد الطلبات والحجوزات: صالونات، عيادات أسنان، مطاعم تستقبل حجوزات الجمعة.
• تذكير المواعيد: رسالة قبل الموعد بيوم تقلّل الغياب بشكل ملحوظ، وأصحاب العيادات يلاحظون ذلك سريعاً.
• رموز التحقق (OTP): بديل عملي عن الرسائل النصية التي تتأخر أحياناً.
• تحديثات الشحن والدفع: «تم استلام دفعتك بقيمة 250 ريالاً».

نقطة يجب أن تعرفها مبكراً: إشعارات واتساب ليست قناة إعلانية مفتوحة. Meta تراقب جودة رسائلك، وإن أكثرت من الرسائل التسويقية المزعجة سينخفض تقييم رقمك وقد تُقيَّد قدرتك على الإرسال. لذلك أنصح كل من يبدأ بأن يجعل أول استخدام له إشعارات «خدمية» يحتاجها العميل فعلاً، ويؤجل الحملات التسويقية حتى يبني سجلاً نظيفاً. ابدأ بما يريده العميل، لا بما تريد أنت بيعه.

ما الذي تحتاجه قبل تفعيل إشعارات واتساب في تطبيقات codeyy؟

تحتاج أربعة أشياء: حساب أعمال على Meta (Meta Business Portfolio)، ورقم جوال غير مسجّل حالياً على تطبيق واتساب العادي أو واتساب للأعمال، ومشروعاً جاهزاً على codeyy، ووثائق نشاطك التجاري لتوثيق الحساب. بوجود هذه الأربعة، يصبح الإعداد مسألة ساعة أو ساعتين، ثم انتظار المراجعة.

لنتوقف عند كل عنصر لأن التفاصيل هنا هي ما يصنع الفرق.

الرقم: النقطة التي يتعثر عندها الجميع

هذا أكثر سؤال يصلني. «هل أستخدم رقم المحل الحالي؟» يمكنك ذلك، لكن بشرط: يجب حذف الرقم من تطبيق واتساب على الجوال أولاً. الرقم الواحد لا يعمل في التطبيق والمنصة معاً في الإعداد التقليدي. إن كان رقمك القديم يحمل محادثات مهمة مع عملائك، احفظ نسخة منها قبل النقل. نصيحتي الشخصية؟ اشترِ شريحة جديدة مخصصة للإشعارات، وأبقِ رقمك الشخصي بعيداً عن هذه التجربة.

وثائق النشاط

جهّز السجل التجاري (أو الرخصة التجارية في الإمارات)، وعنوان النشاط، وموقعاً إلكترونياً يحمل اسم نشاطك نفسه. التطابق مهم: إن كان اسمك في السجل «مؤسسة نخلة الخليج للتجارة» واسم الموقع مختلف تماماً، قد تتأخر المراجعة.

المشروع على codeyy

إن لم تبنِ تطبيقك بعد، فابدأ من دليل إنشاء أول موقع على codeyy، ثم عُد إلى هنا. وجود صفحة الطلبات أو الحجوزات جاهزة يسهّل عليك تحديد اللحظة التي يُرسَل فيها الإشعار.

الخطوة الأولى: إعداد حساب واتساب للأعمال على Meta

ادخل إلى Meta for Developers وأنشئ تطبيقاً جديداً من نوع «Business»، ثم أضف إليه منتج WhatsApp. ستجد Meta تعطيك رقماً تجريبياً مجانياً للاختبار، ويمكنك من خلاله إرسال رسائل إلى عدد محدود من الأرقام التي تضيفها يدوياً. استخدمه. لا تقفز مباشرة إلى رقمك الحقيقي.

بعد التجربة، اتبع هذا الترتيب:

• أضف رقمك الحقيقي من قسم أرقام الهواتف، وأكّده برمز يصلك عبر رسالة نصية أو مكالمة.
• اختر اسم العرض الذي سيظهر للعملاء. يجب أن يرتبط باسم نشاطك فعلاً؛ أسماء مثل «عروض حصرية» تُرفض غالباً.
• ابدأ توثيق النشاط من إعدادات حساب الأعمال، وارفع وثائقك.
• انسخ ثلاث قيم وضعها في ملف آمن: معرّف رقم الهاتف (Phone Number ID)، ومعرّف حساب واتساب للأعمال (WABA ID)، ورمز الوصول (Access Token).

الفخ الذي لا يخبرك به أحد

رمز الوصول الذي تعرضه لك صفحة البداية في Meta مؤقت، وينتهي خلال 24 ساعة تقريباً. كثيرون يربطونه، تعمل الإشعارات بشكل رائع يوم الإطلاق، ثم تتوقف فجأة صباح اليوم التالي دون أي رسالة خطأ واضحة للعميل. الحل: أنشئ «مستخدم نظام» (System User) من إعدادات حساب الأعمال، وامنحه صلاحية إدارة واتساب، وولّد منه رمزاً دائماً. هذه الخطوة وحدها ستوفر عليك ليلة من القلق.

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

الخطوة الثانية: ربط واجهة واتساب بمشروعك في codeyy

هنا تأتي ميزة البناء بالذكاء الاصطناعي. بدل أن تكتب كوداً، تصف لمساعد codeyy ما تريده بلغة واضحة، وهو يبني منطق الإرسال. المهم أن يكون وصفك محدداً، لا عاماً.

وصف ضعيف: «أضف إشعارات واتساب».

وصف قوي: «عندما يتغير حالة الطلب إلى (تم الشحن)، أرسل رسالة واتساب إلى رقم العميل عبر WhatsApp Cloud API باستخدام القالب order_shipped، وضع رقم الطلب واسم العميل كمتغيرات. احفظ رمز الوصول ومعرّف الرقم كمتغيرات سرية في الخادم، ولا تضعها في كود الواجهة».

لاحظ الفرق. الوصف الثاني يحدد اللحظة، والقالب، والمتغيرات، ومكان حفظ المفاتيح.

أين تحفظ المفاتيح؟

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

وثّق قرارك

أنصح بإضافة قسم صغير في وثيقة المشروع يشرح متى يُرسَل كل إشعار، وأي قالب يستخدم. بعد ثلاثة أشهر، حين تريد إضافة إشعار جديد، ستشكر نفسك. وسيفهم المساعد سياق مشروعك بشكل أفضل في كل تعديل لاحق.

صيغة الرقم

واجهة واتساب تريد الرقم بالصيغة الدولية دون علامة + ودون الصفر في البداية. الرقم السعودي 0551234567 يصبح 966551234567، والإماراتي 0501234567 يصبح 971501234567. اطلب من المساعد تحويل الأرقام تلقائياً، لأن عملاءك سيكتبونها بكل الطرق الممكنة.

الخطوة الثالثة: كتابة قوالب الرسائل واعتمادها

لا يمكنك إرسال أي نص تريده لعميل لم يراسلك مؤخراً. القاعدة في واتساب: إذا راسلك العميل، تُفتح «نافذة خدمة العملاء» لمدة 24 ساعة تستطيع خلالها الرد بحرية. خارج هذه النافذة، أي رسالة تبدأها أنت يجب أن تكون قالباً معتمداً مسبقاً من Meta.

القوالب تنقسم إلى فئات رئيسية:

• خدمية (Utility): تأكيد طلب، تحديث شحنة، تذكير موعد.
• تسويقية (Marketing): عروض، خصومات، إعلان منتج جديد.
• مصادقة (Authentication): رموز التحقق لمرة واحدة.

مثال على قالب خدمي يُعتمد عادة بسرعة:

«مرحباً {{1}}، تم تأكيد حجزك في {{2}} يوم {{3}} الساعة {{4}}. لإلغاء الحجز أو تعديله، رد على هذه الرسالة.»

نصائح تسرّع الاعتماد

• لا تضع عبارات تسويقية داخل قالب خدمي. جملة مثل «واستفد من خصم 20% على زيارتك القادمة» تحوّل القالب إلى تسويقي، وقد يُرفض أو يُعاد تصنيفه بسعر أعلى.
• لا تبدأ القالب أو تنهِه بمتغير. أضف نصاً ثابتاً قبله وبعده.
• قدّم أمثلة واقعية لكل متغير عند التقديم، مثل «أحمد» و«عيادة الابتسامة».
• اكتب نسخة عربية ونسخة إنجليزية منفصلتين إن كان جزء من عملائك من المقيمين غير الناطقين بالعربية، وهذا شائع جداً في دبي والدوحة.

الاعتماد يحدث أحياناً خلال دقائق، وأحياناً يستغرق وقتاً أطول. وإن رُفض القالب، لا تيأس: عدّل الصياغة وأعد التقديم. في تجربتي، الرفض غالباً سببه كلمة واحدة توحي بالتسويق.

كم تكلّف إشعارات واتساب في تطبيقات codeyy؟

التكلفة لها جزآن: اشتراكك في codeyy لبناء التطبيق واستضافته، ورسوم Meta على الرسائل نفسها. Meta تحاسب على كل رسالة قالب تُسلَّم، ويختلف السعر حسب الفئة وبلد رقم المستلم. الرسائل التسويقية هي الأغلى، والردود داخل نافذة الـ24 ساعة مجانية، وكذلك القوالب الخدمية المرسلة داخل تلك النافذة.

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

مثال تقديري لطريقة الحساب

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

نصيحة توفير حقيقية: شجّع العميل على مراسلتك أولاً. زر «تواصل معنا عبر واتساب» في صفحة الطلب يفتح نافذة الـ24 ساعة، فتصبح ردودك داخلها مجانية.

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

الخصوصية والموافقة: لا تتجاهل هذا الجزء

لا ترسل رسالة واتساب لشخص لم يوافق على استقبالها. Meta تشترط الحصول على موافقة صريحة (Opt-in) قبل مراسلة العميل، والأنظمة المحلية تدعم هذا الاتجاه. في السعودية دخل نظام حماية البيانات الشخصية حيز التنفيذ الكامل في سبتمبر 2024، وفي الإمارات هناك قانون اتحادي لحماية البيانات الشخصية. كلاهما يجعل جمع رقم الجوال واستخدامه مسؤولية حقيقية.

عملياً، ماذا تفعل؟

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

المربع لا يجب أن يكون محدداً مسبقاً. هذه تفصيلة صغيرة، لكنها الفرق بين موافقة حقيقية وموافقة شكلية.

واطّلع على سياسة الخصوصية في codeyy لتفهم كيف تُدار بيانات مشروعك على المنصة، ثم اكتب سياسة خصوصية لتطبيقك أنت تذكر فيها صراحة أنك تستخدم واتساب للتواصل. المستخدم الخليجي أصبح أكثر وعياً ببياناته، والشفافية هنا تبني ثقة لا تشتريها الإعلانات.

الاختبار والقياس قبل الإطلاق وبعده

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

قائمة فحص سريعة استخدمها قبل كل إطلاق:

• جرّب رقماً سعودياً وآخر إماراتياً على الأقل للتأكد من تحويل الصيغة.
• جرّب اسماً عربياً طويلاً واسماً إنجليزياً، وتأكد أن الرسالة لا تنكسر.
• أوقف الإنترنت عن جوال الاختبار ثم أعده، وتحقق من وصول الرسالة لاحقاً.
• اسأل: ماذا يحدث لو فشل الإرسال؟ هل يُسجَّل الخطأ في مكان تراه؟

النقطة الأخيرة مهمة جداً. اطلب من مساعد codeyy أن يسجّل كل محاولة إرسال وحالتها في جدول بسيط. من دونه، لن تعرف أن الإشعارات توقفت إلا حين يشتكي عميل.

ماذا تقيس؟

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

خطوتك التالية

ابدأ صغيراً. إشعار واحد خدمي، مثل تأكيد الطلب، يكفي لتتعلم المسار كاملاً: الرقم، والتوثيق، والقالب، والربط، والاختبار. حين ينجح، أضف التذكيرات، ثم فكّر في التسويق لاحقاً. ولا تنسَ الرمز الدائم قبل الإطلاق. للتفاصيل الإضافية حول بناء مشروعك، تصفّح مركز توثيق codeyy.

الأسئلة الشائعة

هل أستطيع استخدام رقم واتساب الذي أستخدمه حالياً لمتجري؟

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

لماذا توقفت إشعارات واتساب بعد يوم من تفعيلها؟

السبب الأكثر شيوعاً هو استخدام رمز الوصول المؤقت الذي تعرضه صفحة البداية في Meta، وهو ينتهي خلال نحو 24 ساعة. الحل أن تنشئ مستخدم نظام من إعدادات حساب الأعمال، وتمنحه صلاحية واتساب، ثم تولّد منه رمزاً دائماً وتستبدل به الرمز القديم في إعدادات مشروعك على الخادم. بعدها اختبر إرسال رسالة للتأكد من عودة الخدمة.

هل يمكنني إرسال عروض تسويقية لكل أرقام عملائي عبر واتساب؟

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

كم يستغرق اعتماد قالب رسالة واتساب؟

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