تكامل واتساب

ميزة تكامل واتساب تجعل المدرسة تراسل أولياء الأمور والطلاب والمعلمين والموظفين، وحتى أشخاصاً من خارج النظام، على واتساب مباشرة، من رقم واتساب الخاص بالمدرسة، عبر خدمة WhatsApp Business Cloud API الرسمية من Meta.

الربط بحساب Meta أولاً

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

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

• 1. نظرة عامة
• 2. كيف تصل رسائل المدرسة؟ نظام قوالب الترحيل
• 3. الإعداد وربط الحساب
• 4. لوحة متابعة الاستخدام والتكلفة
• 5. الرسائل التلقائية (تبويب القوالب)
• 6. القوالب اليدوية
• 7. إرسال رسالة جماعية (تبويب أرسل رسالة)
• 8. المستخدمون الخارجيون
• 9. الرسائل المجدولة والمتكررة (تبويب مجدول)
• 10. سجلات الرسائل وإعادة المحاولة
• 11. حل المشكلات
• 12. قائمة التحقق

1. نظرة عامة

ماذا تقدّم لك الميزة؟

الميزة	الشرح
رقم واتساب خاص بمدرستك	كل مدرسة تعمل بحساب واتساب للأعمال ورقم خاص بها، وبياناتها مستقلة تماماً عن أي مدرسة أخرى على المنصة
رسائل تلقائية	تُرسل فوراً عند أحداث في النظام دون تدخل منك: إيصال دفع الرسوم (مع إيصال PDF مرفق تلقائياً)، وتذكير بالرسوم المستحقة، وتنبيه غياب الطالب، وجدول الامتحان، ونشر النتائج، والواجبات الجديدة، والعطلات، وقرارات إجازات الموظفين، والترحيب بالطالب الجديد
نظام قوالب الترحيل (Relay)	ثلاثة قوالب فقط تعتمدها مرة واحدة في Meta، ثم تكتب أي نص تريده من لوحة المدرسة دون أن تنتظر موافقة Meta على كل رسالة. الشرح في القسم 2
إرسال جماعي ومجدول	تعميم لفئة كاملة أو لأشخاص تختارهم أو لقائمة من ملف CSV، الآن أو في موعد لاحق، مرة واحدة أو بشكل أسبوعي أو شهري
المستخدمون الخارجيون	دليل أرقام لأشخاص غير مسجلين في النظام (خريجون، مهتمون بالتسجيل، موردون...)، مع علامات لتقسيمهم إلى مجموعات
سجل كامل وإعادة المحاولة	كل رسالة مسجّلة بحالتها، وإعادة إرسال الرسائل الفاشلة بضغطة واحدة
متابعة حساب Meta والتكلفة	حد المراسلات اليومي من Meta، وتقييم جودة الرقم، والتكلفة المتوقعة لهذا الشهر، من داخل لوحة المدرسة

التبويبات

تجد كل ما سبق في صفحة تكامل واتساب من القائمة الجانبية، موزعاً على تبويبات:

التبويب	ماذا تفعل فيه	القسم في هذه الصفحة
الإعداد	إدخال بيانات الربط مع Meta واختبار الاتصال	القسم 3
القوالب	الرسائل التلقائية: تفعيلها وإيقافها وتعديل نصوصها	القسم 5
القوالب اليدوية	نصوص جاهزة للتعاميم والرسائل الجماعية	القسم 6
أرسل رسالة	الإرسال الجماعي، الآن أو مجدولاً	القسم 7
المستخدمون الخارجيون	دليل الأرقام من خارج النظام واستيراده من CSV	القسم 8
مجدول	متابعة الرسائل المجدولة والمتكررة وإلغاؤها	القسم 9
سجلات الرسائل	حالة كل رسالة وإعادة محاولة الفاشلة	القسم 10

2. كيف تصل رسائل المدرسة؟ نظام قوالب الترحيل

قاعدة الـ 24 ساعة في واتساب

واتساب لا يسمح لأي جهة أعمال (ومنها المدرسة) بأن تبدأ محادثة بنص حر. النص الحر مسموح فقط خلال 24 ساعة من آخر رسالة أرسلها الشخص نفسه إلى رقم المدرسة. خارج هذه النافذة، وهي حالة أغلب رسائل المدرسة، يجب أن تُرسل الرسالة داخل قالب معتمد مسبقاً من Meta من فئة Utility.

لو كان على المدرسة أن تعتمد عند Meta قالباً لكل رسالة، ستنتظر الموافقة مع كل تعديل في النص. لذلك يستخدم النظام فكرة قوالب الترحيل.

الفكرة

تعتمد عند Meta ثلاثة قوالب فقط، في كل منها خانة فارغة اسمها {{1}}:

القالب	الاسم المقترح	يُستخدم عندما تحمل الرسالة
قالب ترحيل النص	school_message	نصاً فقط
قالب ترحيل المستندات	school_message_document	ملف PDF أو Word أو Excel أو CSV أو TXT، مثل إيصال الرسوم
قالب ترحيل الصور	school_message_image	صورة JPG أو PNG

عند إرسال أي رسالة، تلقائية أو جماعية:

1. يجهّز النظام النص كاملاً داخل لوحة المدرسة، ويستبدل كل المتغيّرات (مثل اسم الطالب والمبلغ) بقيمها الحقيقية.
2. يضع النص الجاهز مكان {{1}} في قالب الترحيل المناسب.
3. يرسله عبر Meta إلى واتساب المستلم.

لوحة المدرسة                       قالب الترحيل المعتمد في Meta              واتساب المستلم
(النص + المتغيّرات بعد تعبئتها)  ──►  الخانة {{1}}                     ──►   "رسالة من المدرسة: ..."

النتيجة: تكتب وتعدّل نصوص رسائلك بحرية من لوحة المدرسة، وتصل دائماً لأنها داخل قالب معتمد.

إذا لم تُنشئ قالبَي المستندات والصور

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

3. الإعداد وربط الحساب

ما تحتاجه من Meta

#	المطلوب	أين تجده
1	حساب مطوّر على Meta	developers.facebook.com
2	حساب واتساب للأعمال (WhatsApp Business Account)	Meta Business Manager
3	معرف رقم الهاتف لرقم المدرسة بعد توثيقه	Meta ← WhatsApp ← API Setup
4	رمز الوصول الدائم لمستخدم نظام، بصلاحيتي whatsapp_business_messaging وwhatsapp_business_management	Meta Business Settings ← System Users
5	القوالب الثلاثة معتمدة (Approved)	WhatsApp Manager ← Message Templates

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

الخطوة 1: إدخال البيانات في تبويب الإعداد

افتح تكامل واتساب من القائمة الجانبية، ثم تبويب الإعداد:

الحقل	ماذا تدخل	مثال
تفعيل واتساب	المفتاح الرئيسي للميزة. إيقافه يوقف مؤقتاً كل الرسائل الصادرة دون حذف أي إعداد	مفعّل
معرف رقم الهاتف	من صفحة API Setup في Meta	104567890123456
معرف حساب النشاط التجاري	معرّف حساب واتساب للأعمال (WhatsApp Business Account ID)	109876543210987
رمز الوصول الدائم	رمز مستخدم النظام الدائم، يبدأ عادة بـ EAAG أو EAAL	EAAG...
قالب ترحيل ميتا الافتراضي (الاسم + اللغة)	اسم قالب النص كما أنشأته في Meta حرفياً، ورمز لغته	school_message وar
قالب مستندات ميتا الافتراضي (للملفات / المرفقات)	اسم قالب المستندات	school_message_document
قالب صور ميتا الافتراضي (لمرفقات الصور)	اسم قالب الصور	school_message_image

تبويب الإعداد في تكامل واتساب

رمز اللغة وليس اسمها

في خانة اللغة اكتب رمز لغة القالب كما في Meta، مثل ar للعربية أو en أو en_US للإنجليزية، وليس كلمة "العربية". يجب أن يطابق الرمز لغة القوالب المعتمدة تماماً، وإلا فشل الإرسال.

لا تشارك رمز الوصول الدائم

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

الخطوة 2: الحفظ والاختبار

1. اضغط حفظ الإعدادات. يتحقق النظام تلقائياً من الوصول إلى حسابك في Meta. إذا ظهرت رسالة أن الإعدادات حُفظت لكن اختبار الاتصال فشل، راجع القسم 11.
2. اضغط اختبار الاتصال. ظهور إشعار أخضر يعني أن النظام يتواصل مع Meta بنجاح.
3. اضغط إرسال رسالة تجريبية، وأدخل رقم جوالك بمفتاح الدولة ودون علامة + (مثل 966501234567 أو 201001234567)، وتأكد من وصول الرسالة إلى واتساب.

ملاحظة

الرسالة التجريبية تُرسل عبر قالب جاهز من Meta اسمه hello_world، لذلك قد تصلك بالإنجليزية.

إعدادات الويب هوك (Webhook): لمعرفة حالة التسليم

حتى تظهر في السجل حالات تم التسليم ومقروءة (وليس فقط "تم الإرسال")، يجب أن يُبلغ Meta النظامَ بما يحدث للرسالة بعد إرسالها. لذلك:

1. انسخ رابط الويب هوك (Webhook URL) ورمز تحقق الويب هوك من قسم إعدادات الويب هوك (Webhook) في تبويب الإعداد.
2. في Meta، افتح تطبيقك ثم إعدادات الـ Webhook الخاصة بواتساب، والصق الرابط في خانة Callback URL والرمز في خانة Verify Token، واحفظ.

هذه الخطوة اختيارية للإرسال نفسه، لكنها ضرورية لمعرفة هل وصلت الرسالة فعلاً وهل قُرئت.

4. لوحة متابعة الاستخدام والتكلفة

في صفحة تكامل واتساب تظهر أرقام تساعدك على متابعة الاستخدام:

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

عند الوصول للحد الشهري

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

حافظ على جودة رقمك

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

5. الرسائل التلقائية (تبويب القوالب)

رسائل جاهزة تُرسل تلقائياً وفوراً عند حدوث أمر في النظام. من تبويب القوالب يمكنك لكل رسالة:

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

تبويب القوالب (الرسائل التلقائية)

الرسائل المتاحة

الرسالة	متى تُرسل؟	لمن؟	المتغيّرات المتاحة	المرفق
إيصال دفع الرسوم	عند تسجيل دفعة رسوم معتمدة	ولي الأمر	{{parent_name}} {{student_name}} {{class}} {{amount}} {{school_name}}	إيصال PDF يُنشأ تلقائياً
تذكير بالرسوم المستحقة	عند إرسال تذكير بالرسوم، تلقائياً أو يدوياً	ولي الأمر	{{parent_name}} {{student_name}} {{class}} {{amount}} {{due_date}} {{school_name}}	اختياري
تنبيه غياب	عند تسجيل الطالب غائباً في الحضور اليومي	ولي الأمر	{{parent_name}} {{student_name}} {{class}} {{date}} {{school_name}}	لا يوجد
واجب جديد	عند نشر المعلم واجباً لمادة	ولي الأمر	{{parent_name}} {{student_name}} {{class}} {{subject}} {{due_date}} {{school_name}}	ملف الواجب إن وُجد
موعد امتحان	عند نشر جدول الامتحان	ولي الأمر	{{parent_name}} {{student_name}} {{class}} {{exam_name}} {{date}} {{school_name}}	لا يوجد
نشر النتيجة	عند نشر نتيجة الامتحان أو الدرجات	ولي الأمر	{{parent_name}} {{student_name}} {{class}} {{exam_name}} {{result}} {{school_name}}	لا يوجد
إعلان عطلة	عند إضافة عطلة جديدة	ولي الأمر	{{parent_name}} {{date}} {{holiday_name}} {{school_name}}	لا يوجد
قبول إجازة موظف	عند الموافقة على طلب إجازة معلم أو موظف	المعلم أو الموظف	{{teacher_name}} {{from_date}} {{to_date}} {{school_name}}	لا يوجد
رفض إجازة موظف	عند رفض طلب إجازة معلم أو موظف	المعلم أو الموظف	{{teacher_name}} {{from_date}} {{to_date}} {{school_name}}	لا يوجد
ترحيب بطالب جديد	عند تأكيد تسجيل الطالب	ولي الأمر	{{parent_name}} {{student_name}} {{class}} {{gr_number}} {{school_name}}	لا يوجد
رسالة اختبار الاتصال	عند اختبار الربط من تبويب الإعداد	رقمك	{{school_name}}	لا يوجد

معنى كل متغيّر

المتغيّر كلمة بين قوسين مزدوجين يستبدلها النظام تلقائياً بالقيمة الحقيقية لكل مستلم:

المتغيّر	يُستبدل بـ
{{parent_name}}	اسم ولي الأمر
{{student_name}}	اسم الطالب
{{class}}	الصف والفصل
{{amount}}	المبلغ
{{due_date}}	تاريخ الاستحقاق أو موعد التسليم
{{date}}	التاريخ
{{subject}}	المادة
{{exam_name}}	اسم الامتحان
{{result}}	النتيجة
{{holiday_name}}	اسم العطلة
{{teacher_name}}	اسم المعلم أو الموظف
{{from_date}} و {{to_date}}	بداية الإجازة ونهايتها
{{gr_number}}	رقم السجل العام (GR) للطالب
{{school_name}}	اسم المدرسة

تعديل نص رسالة تلقائية

1. في تبويب القوالب، اضغط تعديل بجانب الرسالة.
2. عدّل النص. تظهر أعلى الخانة المتغيرات المتاحة لهذه الرسالة.
3. احفظ، ثم جرّب بالإرسال التجريبي.

أمثلة جاهزة للنسخ:

• تنبيه الغياب: السيد/ة {{parent_name}}، نفيدكم بغياب الطالب/ة {{student_name}} ({{class}}) اليوم {{date}}. إدارة {{school_name}}
• إيصال دفع الرسوم: السيد/ة {{parent_name}}، تم استلام مبلغ {{amount}} من رسوم الطالب/ة {{student_name}} ({{class}}). مرفق الإيصال. شكراً لكم، {{school_name}}
• واجب جديد: واجب جديد في مادة {{subject}} للطالب/ة {{student_name}} ({{class}})، موعد التسليم {{due_date}}. {{school_name}}

لا تحذف المتغيّرات المطلوبة

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

أرقام الجوال

يحوّل النظام كل أرقام الجوال تلقائياً إلى الصيغة الدولية (أرقام فقط بمفتاح الدولة) قبل الإرسال. لذلك تأكد أن أرقام أولياء الأمور والموظفين مسجلة صحيحة في النظام.

خيارات متقدمة لكل رسالة: قالب Meta خاص

افتراضياً، تُرسل كل رسالة عبر قالب الترحيل. لكن في نافذة تعديل الرسالة خيارات إضافية لمن يريد قالباً مخصصاً لرسالة بعينها:

الخيار	ماذا يفعل
اسم قالب ميتا	اختياري. اسم قالب معتمد في حسابك على Meta خاص بهذه الرسالة. عند تعيينه يُرسل هذا القالب بدلاً من قالب الترحيل. الاسم بأحرف إنجليزية صغيرة وأرقام وشرطة سفلية _ فقط
إرسال نص الرسالة كمتغير قالب	عند تفعيله، يُرسل نص الرسالة المكتوب في اللوحة داخل الخانة {{1}} في القالب الخاص. يتطلب أن يحتوي القالب الخاص على {{1}}. فواصل الأسطر تتحول إلى مسافات

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

متى أحتاج هذا؟

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

6. القوالب اليدوية

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

إنشاء قالب يدوي

1. افتح تبويب القوالب اليدوية، واضغط إنشاء قالب.
2. أدخل:
   • اسم القالب: مثل "تعميم اليوم الرياضي".
   • الفئة.
   • نص الرسالة.
3. اضغط حفظ القالب.

تبويب القوالب اليدوية

المتغيّرات في القوالب اليدوية

• اكتب {{variable_name}} بأي اسم في أي مكان في النص، فيتحول إلى خانة تملؤها عند الإرسال. مثلاً {{event_date}} أو {{place}}.
• متغيّران يُملآن تلقائياً لكل مستلم: {{recipient_name}} (اسم المستلم) و {{school_name}} (اسم المدرسة).

مثال:

عزيزي/عزيزتي {{recipient_name}}،
يسر {{school_name}} دعوتكم لحضور اليوم الرياضي يوم {{event_date}} في {{place}}.

عند الإرسال يطلب منك النظام قيمتي {{event_date}} و {{place}} مرة واحدة، ويملأ الاسم لكل مستلم وحده.

7. إرسال رسالة جماعية (تبويب أرسل رسالة)

قبل البدء

الإرسال الجماعي يعتمد على القوالب اليدوية. إذا لم تُنشئ قالباً بعد، ابدأ من القسم 6.

1. افتح تبويب أرسل رسالة.
2. اختر قالباً من القوالب اليدوية. تظهر معاينة الرسالة.
3. حدد المستلمين:
   • مستخدمو النظام: صفِّ حسب الدور (طلاب، أولياء أمور، معلمون، موظفون)، ثم ضع علامة بجانب من يجب أن يستلم، أو اختر الكل.
   • المستخدمون الخارجيون: اختر من دليل المستخدمين الخارجيين، أو اختر مجموعة بعلامتها، أو ارفع ملف CSV للمرة الواحدة (رفع ملف CSV (خارجي)).
4. املأ المتغيّرات التي يطلبها القالب، مثل التاريخ والمكان. المتغيّرات التلقائية تظهر بعبارة "يتم تعبئتها تلقائيًا لكل مستلم".
5. أرفق ملفاً إن أردت (اختياري):
   • مستند: PDF أو Word أو Excel، حتى 100 ميجابايت.
   • صورة: JPG أو PNG، حتى 5 ميجابايت.
6. اختر موعد الإرسال:

الخيار	ماذا يحدث
إرسال الآن	توضع الرسائل في قائمة الانتظار وتُرسل خلال لحظات
مرة واحدة	تختار تاريخاً ووقتاً في المستقبل، فتُرسل فيه مرة واحدة
تكرار أسبوعي	أول إرسال في التاريخ والوقت المحددين، ثم يتكرر كل أسبوع في نفس اليوم والوقت
تكرار شهري	أول إرسال في التاريخ والوقت المحددين، ثم يتكرر كل شهر في نفس اليوم والوقت

7. اضغط زر الإرسال.

تبويب أرسل رسالة

بعد الإرسال تظهر رسالة بعدد الرسائل التي وُضعت في قائمة الانتظار، وعدد من تم تخطيهم لعدم وجود رقم جوال. ومع الجدولة تظهر رسالة بموعد التشغيل القادم.

من ليس له رقم جوال لا تصله رسالة

المستلم الذي لا يوجد له رقم جوال مسجّل في النظام يتم تخطيه تلقائياً. إذا تكرر ذلك مع أولياء أمور كثيرين، راجع أرقامهم في ولي الأمر.

الصورة أكبر من 5 ميجابايت؟

واتساب لا يقبل صوراً أكبر من 5 ميجابايت. قلّل حجمها، أو احفظها كملف PDF وأرسلها كمستند.

8. المستخدمون الخارجيون

تبويب المستخدمون الخارجيون دليل أرقام بسيط لأشخاص غير مسجلين في النظام كطلاب أو موظفين، مثل:

• الخريجين.
• أولياء أمور مهتمين بالتسجيل (من استفسارات التقديم مثلاً).
• الموردين والمتعاقدين.
• الموظفين السابقين.

تبويب المستخدمون الخارجيون

إضافة مستخدم خارجي

أدخل:

• الاسم.
• رقم الجوال بمفتاح الدولة.
• العلامة (اختيارية): كلمة تجمع الأشخاص في مجموعة، مثل "خريجو 2025" أو "استفسارات القبول" أو "الموردون".

فائدة العلامة: عند الإرسال الجماعي تختار المجموعة كاملة بعلامتها بدل اختيار الأشخاص واحداً واحداً.

استيراد من ملف CSV

لإضافة مئات الأرقام مرة واحدة:

1. اضغط استيراد ملف CSV.
2. ارفع الملف بالصيغة التالية.
3. حدد علامة واحدة تُطبَّق على كل الأسماء في الملف.

الملف عمودان بهذا الترتيب: mobile ثم name:

mobile,name
966501234567,أحمد محمد
201001234567,سارة علي
201112223334,"عبدالله، الدفعة الأولى"

القاعدة	التفاصيل
صيغة الرقم	بمفتاح الدولة، أرقام فقط، دون علامة + ودون أصفار في البداية
الاسم الذي فيه فاصلة	ضعه بين علامتي تنصيص، كما في السطر الأخير
ترميز الملف	عند الحفظ من Excel اختر CSV UTF-8 حتى تظهر الأسماء العربية صحيحة
الأرقام المكررة	إذا استوردت رقماً موجوداً مسبقاً، يُحدَّث اسمه وعلامته ولا يتكرر

تلميح

بفضل قاعدة التحديث، يمكنك إعادة استيراد نفس الملف بعد تصحيحه دون خوف من التكرار.

9. الرسائل المجدولة والمتكررة (تبويب مجدول)

كل رسالة جماعية أرسلتها بخيار مرة واحدة أو تكرار أسبوعي أو تكرار شهري تظهر في تبويب مجدول:

نوع الجدولة	ما يحدث
مرة واحدة	تُرسل في التاريخ والوقت المحددين، ثم تصبح حالتها مكتمل
تكرار أسبوعي	تُرسل كل 7 أيام من موعد البداية
تكرار شهري	تُرسل في نفس اليوم من كل شهر

لكل رسالة مجدولة ترى: موعد التشغيل القادم، وعدد المستلمين، والحالة.

إلغاء رسالة مجدولة

يمكنك إلغاء أي رسالة مجدولة في أي وقت قبل موعدها. بعد الإلغاء لن تُرسل هذه الرسالة المجدولة بعد الآن، وهذا يشمل كل مرات التكرار القادمة.

تبويب مجدول

أمثلة مفيدة للتكرار

• شهري: تذكير أولياء الأمور بموعد سداد القسط في أول كل شهر.
• أسبوعي: تذكير المعلمين يوم الخميس بتسليم خطة الأسبوع القادم.

10. سجلات الرسائل وإعادة المحاولة

كل رسالة يرسلها النظام، تلقائية أو جماعية، تظهر في تبويب سجلات الرسائل مع المستلم ونص الرسالة وحالتها.

تبويب سجلات الرسائل

حالات الرسالة

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

إعادة محاولة الرسائل الفاشلة

قد تفشل الرسائل لأسباب مؤقتة، مثل انقطاع الشبكة أو ضغط على خدمة Meta:

1. افتح تبويب سجلات الرسائل.
2. صفِّ حسب الحالة على فشل.
3. إما أن تحدد رسائل بعينها وتضغط إعادة محاولة المحدد، أو تضغط إعادة محاولة كل الفاشلة.
4. يعيد النظام وضع نفس الرسالة في قائمة الانتظار، ويُحدّث نفس السجل بدل إنشاء سجل جديد.

ملاحظة

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

11. حل المشكلات

رموز الأخطاء من Meta

عند فشل رسالة، يظهر في السجل رمز الخطأ. هذه أشهر الرموز:

رمز الخطأ	ماذا يعني	الحل
131030	رقم المستلم غير مسموح به	الرقم غير مسجّل في واتساب، أو أن تطبيقك في Meta ما زال في وضع التطوير ويرسل فقط لأرقام الاختبار. الحل: أضف الرقم في Meta من WhatsApp ← API Setup ← To ← إدارة قائمة أرقام الهواتف، أو حوّل التطبيق إلى الوضع المباشر (Live)
132001	القالب غير موجود بهذه اللغة	تركيبة اسم القالب + رمز اللغة غير موجودة أو غير معتمدة في حسابك. تأكد أن الاسم مكتوب في تبويب الإعداد مطابقاً لـ Meta حرفياً بأحرف صغيرة، وأن رمز اللغة مطابق (مثلاً en يختلف عن en_US)
132000	عدد المتغيّرات لا يطابق القالب	قالب الترحيل في Meta لا يحتوي على {{1}} في نص الرسالة، أو أن نوع ترويسة القالب لا يطابق نوع الرسالة (بدون، مستند، صورة)
131053	تعذّر على Meta تحميل المرفق	تأكد أن نوع الملف وحجمه مدعومان (الصور حتى 5 ميجابايت، والمستندات حتى 100 ميجابايت). إذا كانا سليمين، تواصل مع الدعم الفني
401	رمز الوصول غير صالح	الرمز انتهى أو غير صحيح أو ينقصه صلاحية whatsapp_business_messaging. أنشئ رمزاً دائماً جديداً من Meta وضعه في تبويب الإعداد

مشكلات أخرى

المشكلة	السبب والحل
ظهرت رسالة "واتساب غير مفعل"	احفظ بيانات الربط وفعّل تفعيل واتساب في تبويب الإعداد أولاً
حُفظت الإعدادات لكن فشل اختبار الاتصال	راجع معرف رقم الهاتف ومعرف حساب النشاط التجاري ورمز الوصول الدائم؛ غالباً نُسخ أحدها ناقصاً، أو استُخدم الرمز المؤقت (ينتهي خلال 24 ساعة) بدل الدائم
الرسائل توقفت فجأة بعد يوم من الربط	استُخدم الرمز المؤقت من صفحة API Setup. أنشئ رمزاً دائماً كما في ربط واتساب للأعمال (Meta)
ظهرت رسالة الوصول إلى الحد الشهري	استهلكت المدرسة حد الرسائل الشهري في خطتها. تُستأنف الرسائل مع بداية الشهر، أو زد الحد بترقية الخطة
رسائل كثيرة بقيت معلق لأكثر من بضع دقائق، أو لم تُرسل رسالة مجدولة في موعدها	تواصل مع الدعم الفني؛ المشكلة في خدمات الإرسال على الخادم وليست في إعداداتك
الصورة رُفضت لأنها أكبر من 5 ميجابايت	قلل حجمها، أو أرسلها كملف PDF
لم تصل الرسالة لبعض المستلمين دون أن تظهر في السجل	ليس لهم رقم جوال مسجّل في النظام، فتم تخطيهم

12. قائمة التحقق

قبل الاعتماد على واتساب في التواصل اليومي، تأكد من:

• إنشاء تطبيق Meta وحساب واتساب للأعمال، وتوثيق رقم المدرسة.
• إنشاء قوالب الترحيل الثلاثة واعتمادها: school_message و school_message_document و school_message_image.
• إدخال معرف رقم الهاتف ومعرف حساب النشاط التجاري ورمز الوصول الدائم ورمز اللغة في تبويب الإعداد.
• نجاح اختبار الاتصال ووصول الرسالة التجريبية.
• ضبط الويب هوك لمعرفة حالات التسليم والقراءة (اختياري ومفيد).
• مراجعة الرسائل التلقائية: تفعيل المطلوب منها، وتعريب نصوصها، وتجربتها بالإرسال التجريبي.
• التأكد من صحة أرقام جوالات أولياء الأمور والموظفين في النظام.
• إنشاء القوالب اليدوية التي تتكرر حاجتك لها، مثل التعاميم والتذكيرات.