ربط واتساب للأعمال (Meta)

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

لمن هذه الصفحة؟

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

محتويات الصفحة

• قبل أن تبدأ
• الخطوة 1: إنشاء تطبيق في Meta
• الخطوة 2: إضافة واتساب ونسخ المعرّفين
• الخطوة 3: توليد رمز الوصول الدائم
• الخطوة 4: إنشاء قوالب الترحيل الثلاثة
• الخطوة 5: إدخال البيانات في لوحة المدرسة
• الخطوة 6 (اختيارية): ربط الويب هوك لمعرفة حالة التسليم
• مشكلات شائعة

قبل أن تبدأ

ما تحتاجه

المطلوب	ملاحظات
حساب فيسبوك	يُفضل أن يكون حساب مسؤول في المدرسة وليس حساباً شخصياً لموظف قد يغادر
حافظة أعمال (Business Portfolio) باسم المدرسة في Meta Business Manager	إن لم تكن موجودة، أنشئها من business.facebook.com
رقم جوال للمدرسة	يجب ألا يكون مسجلاً حالياً في تطبيق واتساب أو واتساب للأعمال على هاتف. إن كان مسجلاً، احذف حسابه من التطبيق أولاً
وسيلة دفع في حساب Meta	رسائل الأعمال مدفوعة لـ Meta حسب عددها ونوعها، وتُحاسب عليها المدرسة مباشرة من Meta

روابط سريعة

الأداة	الرابط	الاستخدام
Meta for Developers (التطبيقات)	developers.facebook.com/apps	إنشاء تطبيق Meta وإدارته
Meta Business Manager	business.facebook.com	إدارة حافظة أعمال المدرسة
مستخدمو النظام (الرمز الدائم)	business.facebook.com/settings/system-users	توليد رمز الوصول الدائم
WhatsApp Manager (القوالب)	business.facebook.com/wa/manage/templates	إنشاء قوالب الرسائل وإدارتها
توثيق Meta الرسمي	developers.facebook.com/docs/whatsapp/cloud-api	مرجع Meta الرسمي للخدمة

الخطوة 1: إنشاء تطبيق في Meta

1. افتح Meta for Developers.
2. سجّل الدخول بحساب فيسبوك المرتبط بحافظة أعمال المدرسة.
3. اضغط زر Create App الأخضر أعلى الصفحة.
4. اختر Other (أو Business) واضغط Next.
5. اختر نوع التطبيق Business واضغط Next.
6. أدخل App Name، مثل: School WhatsApp.
7. أدخل App Contact Email: بريد المدرسة.
8. في Business Portfolio اختر حافظة أعمال المدرسة.
9. اضغط Create App. قد يطلب منك إدخال كلمة مرور فيسبوك مرة أخرى.

إنشاء التطبيق في Meta for Developers

الخطوة 2: إضافة واتساب ونسخ المعرّفين

1. في لوحة التطبيق الجديد، انزل إلى قسم Add products to your app.
2. ابحث عن WhatsApp واضغط Set up.
3. اختر حافظة أعمال المدرسة واضغط Continue.
4. من القائمة الجانبية افتح WhatsApp ثم API Setup (قد تظهر باسم Getting Started).

ستجد في هذه الصفحة المعرّفين المطلوبين:

WhatsApp API Setup

Phone Number ID:               104567890123456   [Copy]
WhatsApp Business Account ID:  109876543210987   [Copy]

في صفحة Meta	يُدخل في لوحة المدرسة في خانة
Phone Number ID	معرف رقم الهاتف
WhatsApp Business Account ID	معرف حساب النشاط التجاري

انسخ الرقمين واحفظهما.

صفحة API Setup ومكان المعرّفين

إضافة رقم المدرسة الحقيقي

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

1. في نفس صفحة API Setup، انزل إلى Step 5: Add a phone number.
2. أدخل اسم العرض (اسم المدرسة كما سيظهر لأولياء الأمور) ورقم جوال المدرسة.
3. وثّق الرقم بالرمز الذي يصلك برسالة نصية أو مكالمة.

بعد إضافة الرقم، معرف رقم الهاتف الذي تستخدمه هو معرف رقم المدرسة وليس الرقم التجريبي.

وضع التطوير والوضع المباشر

طالما التطبيق في وضع التطوير (Development)، لا تصل الرسائل إلا للأرقام المضافة في قائمة الاختبار، وتفشل بقية الرسائل بالخطأ 131030. بعد اكتمال الإعداد، حوّل التطبيق إلى الوضع المباشر (Live).

الخطوة 3: توليد رمز الوصول الدائم

لا تستخدم الرمز المؤقت

الرمز الظاهر في صفحة API Setup مؤقت وينتهي خلال 24 ساعة. لو استخدمته، ستعمل الرسائل يوماً واحداً ثم تتوقف. للاستخدام الفعلي يجب توليد رمز دائم لمستخدم نظام كما يلي.

أ. إنشاء مستخدم نظام

1. افتح إعدادات الأعمال ← مستخدمو النظام.
2. اختر حافظة أعمال المدرسة.
3. اضغط Add (أو Create System User).
4. أدخل اسماً، مثل: School WhatsApp System User.
5. اجعل الدور (System User Role) هو Admin.
6. اضغط Create System User.

إنشاء مستخدم النظام

ب. ربط التطبيق بمستخدم النظام

1. اختر مستخدم النظام الذي أنشأته، واضغط Assign Assets.
2. افتح Apps واختر تطبيقك.
3. فعّل Full Control (Manage App).
4. اضغط Save Changes.

ج. توليد الرمز

1. اختر مستخدم النظام، واضغط Generate New Token.
2. اختر تطبيقك من القائمة.
3. في Token Expiration اختر Never (أو أطول مدة متاحة).
4. في Available Permissions فعّل الصلاحيتين:

الصلاحية	لماذا؟
whatsapp_business_messaging	إلزامية: لإرسال الرسائل
whatsapp_business_management	إلزامية: لإدارة القوالب، ولعرض بيانات الحساب في لوحة المدرسة مثل تقييم الجودة وتكلفة الشهر

5. اضغط Generate Token.
6. انسخ الرمز (يبدأ عادة بـ EAAG أو EAAL) واحفظه في مكان آمن. لن يظهر لك مرة أخرى.

توليد الرمز واختيار الصلاحيات

الخطوة 4: إنشاء قوالب الترحيل الثلاثة

لماذا هذه القوالب؟

لا يسمح واتساب للمدرسة بأن تبدأ محادثة بنص حر خارج نافذة الـ 24 ساعة؛ يجب أن تكون الرسالة داخل قالب معتمد من فئة Utility. لذلك يستخدم النظام ثلاثة قوالب ترحيل في كل منها خانة {{1}}، ويضع فيها نص أي رسالة تكتبها في لوحة المدرسة. بهذا تعدّل نصوص رسائلك متى شئت دون إعادة الاعتماد من Meta. الشرح الكامل في نظام قوالب الترحيل.

إنشاء القالب

1. افتح WhatsApp Manager ← Message Templates.
2. تأكد أن حساب واتساب للأعمال الصحيح مختار من القائمة أعلى اليسار.
3. اضغط Create Template، وأنشئ القوالب الثلاثة التالية.

إنشاء قالب رسالة في WhatsApp Manager

القالب 1: قالب ترحيل النص

الإعداد	القيمة
Category	Utility
Name	school_message
Language	العربية (ar)
Header	None (بدون)
Footer	اختياري، مثل: اسم المدرسة
Buttons	بدون

نص الرسالة (Body):

رسالة جديدة من المدرسة:

{{1}}

شكراً لكم.

مثال لمحتوى {{1}} (تطلبه Meta عند المراجعة): تم تسجيل حضور الطالب أحمد محمد اليوم 05-10-2026.

ثم اضغط Submit.

القالب 2: قالب ترحيل المستندات

الإعداد	القيمة
Category	Utility
Name	school_message_document
Language	العربية (ar)
Header	Document (مستند)، وارفع ملف PDF نموذجياً من جهازك لمراجعة Meta
Footer	اختياري
Buttons	بدون

نص الرسالة (Body):

مرحباً،

{{1}}

تجدون المستند مرفقاً.

مثال لمحتوى {{1}}: مرفق إيصال رسوم الفصل الدراسي الأول.

ثم اضغط Submit.

القالب 3: قالب ترحيل الصور

الإعداد	القيمة
Category	Utility
Name	school_message_image
Language	العربية (ar)
Header	Image (صورة)، وارفع صورة JPG أو PNG نموذجية لمراجعة Meta
Footer	اختياري
Buttons	بدون

نص الرسالة (Body):

مرحباً،

{{1}}

تجدون الصورة مرفقة.

مثال لمحتوى {{1}}: إعلان اليوم الرياضي السنوي.

ثم اضغط Submit.

قواعد مهمة للقوالب

القاعدة	التفاصيل
الاسم	أحرف إنجليزية صغيرة وأرقام وشرطة سفلية _ فقط. ويُكتب في لوحة المدرسة مطابقاً حرفياً
اللغة	استخدم نفس اللغة في القوالب الثلاثة، وأدخل رمزها (مثل ar) في لوحة المدرسة
المتغيّر	يجب أن يحتوي نص كل قالب على {{1}} مرة واحدة
الاعتماد	قوالب Utility بهذا الشكل تُعتمد غالباً خلال دقائق. انتظر حتى تصبح حالتها Approved

هل القوالب الثلاثة إلزامية؟

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

الخطوة 5: إدخال البيانات في لوحة المدرسة

1. ادخل لوحة التحكم بحساب مدير المدرسة.
2. افتح تكامل واتساب من القائمة الجانبية، ثم تبويب الإعداد.
3. أدخل:

الحقل في لوحة المدرسة	القيمة
تفعيل واتساب	مفعّل
معرف رقم الهاتف	Phone Number ID من الخطوة 2
معرف حساب النشاط التجاري	WhatsApp Business Account ID من الخطوة 2
رمز الوصول الدائم	الرمز من الخطوة 3 (EAAG...)
قالب ترحيل ميتا الافتراضي (الاسم + اللغة)	school_message ورمز اللغة ar
قالب مستندات ميتا الافتراضي (للملفات / المرفقات)	school_message_document
قالب صور ميتا الافتراضي (لمرفقات الصور)	school_message_image

4. اضغط حفظ الإعدادات.
5. اضغط اختبار الاتصال. الإشعار الأخضر يعني أن الربط ناجح.
6. اضغط إرسال رسالة تجريبية، وأدخل رقم جوالك بمفتاح الدولة دون + (مثل 966501234567)، وتأكد من وصولها.

تبويب الإعداد في لوحة المدرسة

نجاح اختبار الاتصال

الخطوة 6 (اختيارية): ربط الويب هوك لمعرفة حالة التسليم

لتظهر في سجلات الرسائل حالتا تم التسليم ومقروءة:

1. في تبويب الإعداد بلوحة المدرسة، انسخ رابط الويب هوك (Webhook URL) ورمز تحقق الويب هوك من قسم إعدادات الويب هوك (Webhook).
2. في Meta for Developers افتح تطبيقك، ثم WhatsApp ← Configuration (إعدادات Webhook).
3. الصق الرابط في Callback URL، والرمز في Verify token، واضغط Verify and save.
4. في قائمة الحقول (Webhook fields) فعّل الاشتراك في messages.

مشكلات شائعة

المشكلة	السبب والحل
فشل اختبار الاتصال	تأكد أن الرمز المستخدم هو الدائم وليس المؤقت، وأن الصلاحيتين مفعّلتان، وأن المعرّفين منسوخان كاملين
الرسائل تعمل يوماً ثم تتوقف	استُخدم الرمز المؤقت. ارجع إلى الخطوة 3
الخطأ 131030 مع أغلب الأرقام	التطبيق ما زال في وضع التطوير، أو ما زال الرقم التجريبي مستخدماً. أضف رقم المدرسة وحوّل التطبيق إلى Live
الخطأ 132001	اسم القالب أو رمز اللغة في لوحة المدرسة لا يطابق Meta حرفياً، أو أن القالب لم يُعتمد بعد
الخطأ 132000	القالب لا يحتوي على {{1}}، أو أن نوع ترويسته لا يطابق نوعه (بدون، مستند، صورة)
الخطأ 401	الرمز انتهى أو أُلغي أو ينقصه صلاحية الإرسال. ولّد رمزاً جديداً وأدخله في تبويب الإعداد
لا تظهر تكلفة الشهر أو تقييم الجودة في اللوحة	الرمز ينقصه صلاحية whatsapp_business_management
رُفض القالب من Meta	تأكد أن الفئة Utility وليست Marketing، وأن النص لا يحتوي على محتوى ترويجي، وأن الاسم بالأحرف المسموحة فقط

بعد نجاح الربط، تعرّف على كل ما يمكنك فعله في تكامل واتساب.