الدليل
حل المشكلات: عندما لا يعمل شيء كما ينبغي
في هذه الصفحة المشكلات الأكثر شيوعاً بين متجرك وMeta وجوالك، وأسبابها، وطريقة حلها. ويكتشف «تشخيص الاتصال» أغلبها تلقائياً.
ابدأ من هاتين الشاشتين
- تشخيص الاتصال (WAPI Connect ← «الحالة والأدوات» ← «تشخيص الاتصال»): يفحص كل جزء من الاتصال بين متجرك وواتساب. ويعرض الرسائل التي فشلت خلال آخر 24 ساعة، مع السبب بكلمات بسيطة. اضغط «إعادة الفحص» بعد كل تغيير. ويوضّح شرح تشخيص الاتصال معنى كل بطاقة.
- سجل الرسائل («الحالة والأدوات» ← «سجل الرسائل»): يعرض كل رسالة أرسلتها الإضافة أو استقبلتها، مع حالتها. وإذا فشلت الرسالة، يعرض خطأ Meta.
لا يكتمل التحقق من رابط الاستقبال (Webhook)
تظهر هذه المشكلة عندما تضغط «Verify and save»، فتقول Meta إنها لم تتمكن من التحقق من Callback URL أو رمز التحقق. تحقّق من هذه النقاط بالترتيب:
- رمز التحقق. يجب أن تكون الكلمة في خانة «Verify token» في Meta مطابقة تماماً للكلمة في «الإعدادات» ← «ربط واتساب (API)» ← «رمز التحقق لرابط الاستقبال (Verify Token)». ويجب أن تكون محفوظة في الإضافة قبل أن تضغط «Verify and save». انسخها من جديد، فمسافة واحدة في آخرها تكفي لفشل التحقق.
- رابط الاستقبال (Callback URL). انسخه من الإضافة («لوحة التحكم»، أو «ربط واتساب (API)»، أو «تشخيص الاتصال»). وينتهي الرابط بـ
/wp-json/almorshed-whatsapp/v1/webhook. - الاتصال الآمن (HTTPS). لا تتصل Meta إلا بروابط HTTPS لها شهادة SSL صالحة.
- لا شيء يحجب الوصول إلى موقعك. تمنع هذه الأمور Meta من الوصول إلى موقعك: إضافة حماية، أو جدار حماية، أو قاعدة في Cloudflare تحجب
/wp-json/، أو وضع الصيانة، أو صفحة «قريباً» (Coming soon)، أو كلمة مرور على الموقع كله. ويجب أن تكون الروابط الدائمة (Permalinks) على أي خيار غير «عادي» (Plain).
تُسجَّل كل محاولة فاشلة في «سجل الرسائل» بهذا النص: «فشل التحقق من رابط الاستقبال (Webhook): رمز التحقق (Verify token) غير مطابق، أو الوضع (mode) غير صحيح.» وإذا لم يظهر أي شيء هناك، فطلب Meta لم يصل إلى ووردبريس أصلاً: راجع النقطة 4.
افتح هذا الرابط في المتصفح، بعد وضع عنوان موقعك ورمز التحقق الخاص بك: https://your-store.com/wp-json/almorshed-whatsapp/v1/webhook?hub.mode=subscribe&hub.verify_token=YOUR-TOKEN&hub.challenge=12345. إذا ظهر في الصفحة 12345 فقط، فرابط الاستقبال يرد بشكل صحيح. وإذا ظهرت كلمة «Forbidden»، فرمز التحقق غير مطابق. وإذا ظهرت صفحة خطأ أو صفحة تسجيل دخول، فهناك شيء يحجب الرابط.
رسائل العملاء لا تصل
يعمل الإرسال، لكن رسائل العملاء لا تصل إلى صندوق الرسائل، ولا تبدأ الأتمتة، وتبقى علامتا «وصلت» و«قُرئت» فارغتين. افتح «تشخيص الاتصال»، وانظر إلى بطاقة الاشتراك وبطاقة «استقبال البيانات عبر Webhook».
«لا ترسل Meta رسائل العملاء إلى أي تطبيق»
حساب واتساب للأعمال (WABA) الخاص بك غير مشترك في تطبيقك على Meta. لذلك تتجاهل Meta كل رسالة واردة قبل أن تصل إلى أي موقع. اضغط «الاشتراك الآن»، ثم تأكّد أن رابط الاستقبال في تطبيقك يشير إلى هذا المتجر.
حساب واتساب مشترك في تطبيق آخر
تعرض بطاقة الاشتراك أسماء التطبيقات المشتركة. إذا لم يكن تطبيقك بينها، فلن ترسل Meta أحداث هذا الحساب إلا إلى تلك التطبيقات، مثل تطبيق أداة كنت تستخدمها سابقاً. ويمكنك إضافة اشتراك تطبيقك بطلب واحد إلى Graph API من Meta، باستخدام رمز الوصول الخاص بك (POST /<WABA-ID>/subscribed_apps). وإذا لم ترغب في فعل ذلك بنفسك، فافتح تذكرة دعم، وسنرشدك خطوة بخطوة.
«تُرسل رسائل العملاء إلى عنوان آخر»
يرسل حسابك رسائله إلى عنوان آخر، وغالباً يكون هذا العنوان لأداة كنت تستخدمها سابقاً. اضغط «تحويلها إلى هذا المتجر». ويجب أن يكون رمز التحقق محفوظاً أولاً.
التطبيق ما زال في وضع Development
ما دام تطبيقك على Meta في وضع التطوير (Development)، قد تحجب Meta رسائل العملاء الحقيقيين، حتى لو وصلت حالات رسائلك. أضف رابط سياسة الخصوصية لمتجرك في خانة «Privacy Policy URL» في App settings ← Basic، ثم انشر التطبيق (حوّله إلى وضع Live). اطّلع على شرح رابط الاستقبال ورابط سياسة الخصوصية.
تصل حالات رسائلك، لكن لا تصل أي رسالة من العملاء
فعّل الحقل messages في تطبيقك على Meta (WhatsApp ← Configuration ← Webhook fields)، وتأكّد أن التطبيق في وضع Live. ثم أرسل رسالة من جوال آخر، واضغط «إعادة الفحص».
«رُفضت طلبات حديثة من واتساب»
المقصود هنا الطلبات التقنية التي يرسلها واتساب إلى متجرك. وغالباً يكون المفتاح السري للتطبيق (App Secret) في الإضافة مختلفاً عن المفتاح في تطبيقك على Meta. انسخه من جديد كما هو تماماً، أو احذفه بكتابة - في الخانة ثم الحفظ.
تصل الرسائل إلى معرّف رقم هاتف آخر
يرسل تطبيقك إلى هذا المتجر رسائل رقم آخر. تحقّق من معرّف رقم الهاتف (Phone Number ID) في «الإعدادات» ← «ربط واتساب (API)».
الرسائل لا تُرسل
- «الإرسال متوقف» أو «الإضافة غير مفعّلة» في «تشخيص الاتصال»: ألغِ تحديد «الإيقاف الطارئ»، أو حدّد «تفعيل الإضافة»، في «الإعدادات» ← «عام».
- «توقّف إرسال رسائل واتساب: …» أعلى شاشات الإضافة: انتهى الترخيص وانقضت مهلة الأيام الأربعة عشر بعده، أو أن المفتاح غير مفعّل على هذا الموقع. جدّده أو فعّله من جديد في «الإعدادات» ← «الترخيص». وتستمر رسائل العملاء في الوصول والحفظ خلال ذلك.
- «رسائل تنتظر في قائمة المهام بالخلفية»: المهام المجدولة (WP-Cron) لا تعمل على خادمك. اضغط «تشغيلها الآن»، واطلب من شركة الاستضافة إعداد مهمة Cron فعلية على الخادم لووردبريس.
- فشلت الرسالة: تجد السبب ورمز خطأ Meta في «أخطاء الإرسال» داخل «تشخيص الاتصال»، وفي «سجل الرسائل». ويشرح الجدول أدناه أشهر الرموز.
أشهر رموز الأخطاء وحلولها
ترسل Meta رمزاً رقمياً مع كل رسالة فاشلة. وتعرضه الإضافة بجانب السبب، في «تشخيص الاتصال» و«سجل الرسائل» وتقارير الحملات.
| الرمز | معناه | ما تفعله |
|---|---|---|
| 131005، 10 | لا توجد صلاحية: رمز الوصول لا يملك الصلاحية التي يحتاج إليها، أو لم يعد يملكها | أنشئ رمزاً دائماً لمستخدم النظام (System User) فيه whatsapp_business_messaging وwhatsapp_business_management وbusiness_management، وضعه في «الإعدادات» ← «ربط واتساب (API)»، ثم استأنف الإرسال أو أعد المحاولة. |
| 131030 | رقم المستلم ليس في قائمة الأرقام المسموح بها. يحدث هذا فقط مع الرقم التجريبي العام من Meta. | أضف المستلم إلى قائمة مستلمي الرقم التجريبي في تطبيقك على Meta، أو أرسل من رقم متجرك المسجّل. |
| 131047 | مرّ أكثر من 24 ساعة على آخر رسالة من العميل، لذلك لا يمكن أن ترسل إلا قالباً | أرسل قالباً معتمداً. في صندوق الرسائل يظهر «الإرسال بقالب فقط» مع زر «إرسال قالب». وعندما يرد العميل، يمكنك الكتابة بحرية مرة أخرى. |
| 131026 | لا يمكن الوصول إلى الرقم على واتساب: الرقم غير مسجّل في واتساب، أو يستخدم العميل إصداراً قديماً من واتساب | لن تفيد إعادة الإرسال. تحقّق من الرقم، أو تواصل مع العميل بوسيلة أخرى، واطلب منه أن يحدّث واتساب أو أن يراسل رقمك أولاً. |
| 133010 | رقم متجرك غير مسجّل على WhatsApp Cloud API | سجّله برمز PIN من 6 أرقام، كما في شرح رقم الهاتف، ثم استأنف الإرسال. |
| 133016 | محاولات كثيرة لتسجيل هذا الرقم أو إلغاء تسجيله خلال وقت قصير | تسمح Meta بـ 10 طلبات تسجيل للرقم الواحد كل 72 ساعة. انتظر، ثم حاول مرة واحدة بمعرّف رقم الهاتف ورمز الوصول ورمز PIN الصحيحة. |
| 100 | رفضت Meta بيانات الرسالة. السبب غالباً متغيّر فارغ أو غير صحيح، أو رابط صورة غير صحيح، أو قيمة لا تقبلها Meta | تحقّق من متغيّرات القالب وقيم «إذا كان فارغاً، استخدم…»، وتأكّد أن ملفات عنوان الرسالة (Header) على روابط https عامة. |
| 190 | رمز الوصول منتهي الصلاحية أو غير صالح، وغالباً يكون الرمز المؤقت الذي يعمل 24 ساعة فقط | ضع رمز وصول دائماً جديداً في الإعدادات (حدّد «استبداله برمز جديد»)، ثم أعد المحاولة. |
| 131042 | مشكلة في الدفع بحسابك على Meta: مبلغ غير مدفوع، أو لا توجد بطاقة صالحة | ادفع المبلغ أو حدّث البطاقة في صفحة الفواتير في Meta (زر «الإصلاح في Meta»)، ثم استأنف الإرسال أو أعد المحاولة. |
| 131049 | «حجبها واتساب»: تحدّد Meta عدد الرسائل التسويقية التي يستقبلها الشخص الواحد من كل الشركات | لا تُعِد الإرسال الآن، وحاول بعد بضعة أيام. |
| 131050 | أوقف العميل الرسائل التسويقية من متجرك | لا تحتاج إلى فعل شيء. تنقل الإضافة العميل إلى قائمة «أوقف الرسائل التسويقية». |
| 132001 | القالب غير موجود: لا يوجد قالب بهذا الاسم وهذه اللغة، أو أنه غير معتمد | قارن اسم القالب ورمز لغته في الإضافة بما يظهر في WhatsApp Manager. |
| 132000 | عدد المتغيّرات لا يطابق القالب المعتمد | املأ كل متغيّر في القالب، دون زيادة أو نقص. |
| 132015، 132016 | أوقفت Meta القالب مؤقتاً أو عطّلته بسبب انخفاض جودته | اطّلع على ماذا تفعل إذا رُفض القالب أو توقف. |
| 131048 | بلغت حد الرسائل المزعجة (Spam): حظر كثير من الأشخاص رسائلك أو أبلغوا عنها | قلّل الرسائل التسويقية، وأرسلها فقط إلى العملاء المهتمين الذين وافقوا. |
| 131056، 130429 | رسائل كثيرة إلى الشخص نفسه، أو إرسال بسرعة كبيرة | انتظر قليلاً. وفي الحملات، خفّض سرعة الإرسال وأعد المحاولة. |
إذا لم يكن الرمز في هذه القائمة، تعرضه شاشات الإضافة بالشكل «خطأ واتساب …» مع نص Meta الأصلي. وتجد القائمة الكاملة في مرجع رموز الأخطاء من Meta.
ماذا تفعل إذا رُفض القالب أو توقف
- مرفوض: تعرض شاشة «القوالب» (WAPI Connect ← «القوالب») سبب Meta بكلمات بسيطة بجانب الجزء الذي يحتاج إلى إصلاح، ويعرضه WhatsApp Manager أيضاً. أشهر الأسباب: عرض ترويجي داخل قالب إشعارات (Utility)، أو متغيّر في بداية النص أو نهايته، أو متغيّران متتاليان، أو قيمة مثال ناقصة، أو محتوى يخالف قواعد Meta. أصلح القالب وأرسله مرة أخرى، أو أنشئ قالباً جديداً باسم آخر.
- متوقف مؤقتاً (الخطأ 132015): حظر كثير من العملاء رسائل هذا القالب أو أبلغوا عنها. تفشل الرسائل التي تستخدمه، وتُعلَّق الحملات الجارية التي تستخدمه قبل أن تخرج أي رسالة. اجعل الرسالة أكثر فائدة، وأرسلها فقط إلى العملاء الذين وافقوا، أو استخدم قالباً آخر.
- معطّل (الخطأ 132016): أوقفت Meta القالب نهائياً. أنشئ قالباً جديداً.
إذا كان حقلا Webhook message_template_status_update وmessage_template_quality_update مفعّلين، فستتحدّث شاشة «القوالب» تلقائياً، وتسجّل «صحة الحساب» كل تغيير وتذكر أين يُستخدم القالب وتنبّهك. وتجد تفاصيل أكثر في شرح قوالب الرسائل.
بلغت حد الإرسال اليومي
تحدّد Meta عدد العملاء المختلفين الذين يمكنك مراسلتهم بقالب خلال أي فترة مدتها 24 ساعة. ولا تُحسب ردودك على العملاء الذين كتبوا لك ضمن هذا الحد. وتبدأ الحسابات الجديدة بحد منخفض (250 عميلاً في اليوم وقت كتابة هذا الشرح، 17 أكتوبر 2026).
- اعرف أين وصلت من الحد في صحة الحساب: حدّك، وعدد العملاء الذين راسلهم متجرك في آخر 24 ساعة.
- قبل إطلاق الحملة، تنبّهك شاشة إنشاء الحملة برسالة «العدد أكبر مما يسمح به واتساب اليوم»، وتعرض عليك «الإرسال إلى … فقط». أرسل إلى الباقين في اليوم التالي.
- يمكن أن يرتفع الحد من 250 إلى 2,000 بعد توثيق نشاطك التجاري في Meta، أو بعد وصول 2,000 رسالة قالب إلى عملاء مختلفين خلال 30 يوماً بجودة جيدة. ومن 2,000 يرتفع تلقائياً عندما تستخدم نصفه على الأقل بجودة جيدة. وMeta وحدها هي التي تستطيع تغيير الحد.
- تحسب الإضافة رسائلها فقط. فإذا كانت أداة أخرى ترسل من الرقم نفسه، فستبلغ حد Meta أسرع مما تعرضه الشاشة.
الإشعارات لا تصل إلى آيفون
- إصدار iOS 16.4 أو أحدث. لا تستقبل أجهزة آيفون ذات الإصدارات الأقدم إشعارات من تطبيقات الويب.
- فتح التطبيق من أيقونة الشاشة الرئيسية. أضف تطبيق صندوق الرسائل إلى الشاشة الرئيسية من سفاري (مشاركة ← «إضافة إلى الشاشة الرئيسية»)، وافتحه دائماً من هذه الأيقونة، لأن زر «تفعيل الإشعارات» لا يظهر داخل تبويب سفاري.
- السماح بالإشعارات. في تطبيق صندوق الرسائل افتح «الإعدادات» ← «الإشعارات» ← «تفعيل الإشعارات»، ثم اضغط «سماح». وإذا رفضت الإذن من قبل، فستظهر رسالة «الإشعارات محظورة». عندها افتح إعدادات آيفون ← الإشعارات، ثم افتح تطبيق صندوق الرسائل (اسمه «الرسائل» إذا لم تغيّره)، واسمح بالإشعارات. بعد ذلك افتح صندوق الرسائل مرة أخرى.
- تجربة الإشعار. اضغط «إرسال إشعار تجريبي». إذا لم يصل، فتأكّد أن وضع التركيز أو «عدم الإزعاج» متوقف، وأن موقعك يعمل على HTTPS. ويجب أيضاً أن يستطيع خادمك الوصول إلى خدمة الإشعارات من Apple، فجدار الحماية الذي يحجب الاتصالات الصادرة يوقف كل الإشعارات.
- يصل الإشعار التجريبي، لكن الرسائل لا تصل. معنى ذلك أن رسائل العملاء لا تصل إلى المتجر. اطّلع على رسائل العملاء لا تصل.
فعّل الإشعارات على كل جوال على حدة. وإذا سجّلت الخروج من جوال، تتوقف الإشعارات عليه. وتعرض بطاقة «إشعارات الجوال» في «تشخيص الاتصال» عدد الأجهزة التي تصلها الإشعارات. وتجد تفاصيل أكثر في شرح تطبيق صندوق الرسائل.
هل ما زلت تواجه المشكلة؟
افتح تذكرة دعم، واكتب فيها عنوان موقعك، وإصدار الإضافة، وما فعلته، وما كنت تتوقعه، وما حدث فعلاً. وأضف نص الخطأ ورمزه من «تشخيص الاتصال» أو «سجل الرسائل». ولا ترسل أبداً رمز الوصول أو المفتاح السري للتطبيق أو كلمات المرور.