آخر تحديث: 5 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: صفحة أكواد أخطاء Cloud API، ودليل معالجة أخطاء Graph API، وتوثيق رموز الوصول ومستخدمي النظام من Meta
الإجابة المختصرة: الخطأ 190 يعني حسب Meta أن رمز الوصول (Access Token) الذي أرسلت به الطلب انتهت صلاحيته، والحل المكتوب بجواره: احصل على رمز جديد. وأشهر الأسباب: التكامل يعمل بالرمز المؤقت من صفحة API Setup الذي ينتهي خلال ساعات، أو برمز 60 يوماً لم يُجدَّد، أو برمز أُلغي. والحل الدائم: رمز مستخدم النظام (System User) بالصلاحيات الثلاث، محفوظ على الخادم، مع تذكير تجديد قبل انتهائه.
محتوى المقال:
- ما معنى الخطأ 190؟
- لماذا انتهى الرمز؟ 5 أسباب حقيقية
- كيف تعرف السبب في دقيقتين؟
- حل الخطأ 190 خطوة بخطوة
- الأكواد القريبة منه
- كيف تمنع تكراره؟
- إذا كان رقمك مربوطاً بمظبوت
- كيف يساعدك مظبوت؟
- أسئلة شائعة
ما معنى الخطأ 190 في واتساب API؟
تضع Meta الكود 190 في مجموعة «أخطاء التفويض» (Authorization errors) بصفحة أكواد أخطاء Cloud API، ونص التفاصيل: Your access token has expired، أي انتهت صلاحية رمز الوصول. والحل المكتوب: احصل على رمز جديد. وفي دليل معالجة أخطاء Graph API تسمّيه Meta «Access token has expired»، وتضيف رموزاً فرعية تشرح السبب في حقل error_subcode:
| الرمز الفرعي | اسمه عند Meta | معناه عملياً |
|---|---|---|
| 463 | Expired | الرمز انتهى أو أُلغي أو صار غير صالح |
| 467 | Invalid Access Token | الوصف نفسه: انتهى أو أُلغي أو غير صالح |
| 460 | Password Changed | رمز شخص غيّر كلمة مرور فيسبوك، فعليه تسجيل الدخول من جديد |
| 458 | App Not Installed | صاحب الرمز لم يعد مسجلاً في التطبيق، فيلزم إعادة التفويض |
حسب صفحة أكواد أخطاء WhatsApp Cloud API ودليل Handling errors في Graph API من Meta، اطّلعنا عليهما في 5 نوفمبر 2026.
- النطاق: كل طلب يحمل هذا الرمز يفشل، من إرسال الرسائل إلى إنشاء القوالب. الرقم نفسه سليم، وحساب واتساب لم يُقيَّد.
- ليس حظراً: مشكلة «مفتاح» لا مشكلة «رقم». وما إن تضع رمزاً صالحاً يعود الإرسال فوراً.
- اقرأ الرد كاملاً: حقول code وerror_subcode وmessage وfbtrace_id، والأخير معرّف تطلبه منك Meta إن راسلت الدعم.
لماذا انتهت صلاحية الرمز؟ 5 أسباب حقيقية
| السبب | علامته | الحل الصحيح |
|---|---|---|
| 1. الرمز المؤقت من صفحة API Setup | التكامل نجح يوم الإطلاق ثم توقف بعد ساعات | رمز مستخدم النظام بدلاً منه |
| 2. رمز 60 يوماً لم يُجدَّد | توقف مفاجئ بعد شهرين تقريباً من الإنشاء أو آخر تجديد | جدّده أو أنشئ غيره، وضع تذكيراً قبل اليوم الخمسين |
| 3. الرمز أُلغي | زميل ألغى الرمز أو أبطل كل رموز مستخدم النظام، أو أُزيل تطبيق منصة من Connected apps | رمز جديد، أو إعادة ربط المنصة |
| 4. رمز شخصي مرتبط بموظف | غيّر الموظف كلمة مروره (460) أو غادر الشركة | انقل التكامل إلى مستخدم نظام يملكه النشاط |
| 5. رمز قديم في مكان منسي | جدّدت الرمز في الخادم الرئيسي ونسيت خادم التجربة أو سكربتاً قديماً | مكان واحد للرمز تقرأ منه كل الأنظمة |
حسب توثيق Meta لرموز الوصول ومستخدمي النظام ودليل معالجة الأخطاء، اطّلعنا عليها في 5 نوفمبر 2026. والفرق بين أنواع الرموز في ما هو Access Token (رمز الوصول) في واتساب API؟
كيف تعرف سبب الخطأ 190 في دقيقتين؟
- حدد الرمز المستخدم فعلاً: من أي متغير في الخادم يقرأ نظامك الرمز؟ وهل في الفريق أكثر من نسخة؟
- افحصه بأداة Access Token Debugger من Meta: تعرض هل الرمز صالح، وتاريخ انتهائه، ونوعه، وصلاحياته. الصق الرمز في الأداة وحدها، لا في محادثة أو ملف مشترك.
- اقرأ الرمز الفرعي: 460 يعني رمزاً شخصياً تغيّرت كلمة مرور صاحبه، و463 أو 467 يعني رمزاً انتهى أو أُلغي.
- راجع آخر تغيير في إعدادات الأعمال: هل أبطل أحد رموز مستخدم النظام؟ هل أُزيل تطبيق من Integrations ← Connected apps؟
كيف تحل الخطأ 190 خطوة بخطوة؟
- أوقف إعادة المحاولة التلقائية: كل طلب بالرمز القديم سيفشل، وتكراره لا يفيد ويملأ السجلات.
- أنشئ مستخدم نظام إن لم يكن موجوداً: من إعدادات الأعمال ← System users، بدور Employee، وامنحه تطبيقك بصلاحية Manage app، ثم حساب واتساب وحساب الرسائل معاً كما يطلب نموذج حسابات Meta الجديد. الخطوات في ما هو System User (مستخدم النظام) في واتساب API؟
- اضغط Generate token: اختر التطبيق، ثم مدة الصلاحية: دائم (Never expires) أو 60 يوماً، وهو ما توصي به Meta للحد من خطر التسرّب. ثم الصلاحيات الثلاث: business_management وwhatsapp_business_management وwhatsapp_business_messaging.
- ضع الرمز الجديد في خزنة الأسرار على الخادم واحذف القديم من كل مكان، ثم أعد تشغيل الخدمة إن كانت تقرأ الرمز عند البدء فقط.
- اختبر بطلب قراءة: GET على معرّف الرقم؛ إن رجعت بياناته فالرمز يعمل، ثم أرسل رسالة لرقم من فريقك.
- أعد إرسال ما فشل: الطلبات المرفوضة بالخطأ 190 لم تُسلَّم أي رسالة، وMeta تحاسب على الرسائل المُسلَّمة. ابدأ بالأهم: رموز التحقق وتأكيدات الطلبات والمواعيد. والرسالة الحرة لعميل خارج نافذة الـ 24 ساعة تحتاج قالباً (الخطأ 131047).
مثال من الإسكندرية: عيادة أسنان بنى لها مبرمج مستقل تذكير المواعيد برمز 60 يوماً. في اليوم الحادي والستين فشلت كل التذكيرات بالخطأ 190، وغاب أربعة مرضى. الحل: رمز جديد في متغيرات الخادم، وتنبيه بريدي عند أول رد 190، وتذكير تجديد في تقويم العيادة كل 50 يوماً.
ما الأكواد القريبة من الخطأ 190؟
| الكود | المعنى حسب Meta | الحل |
|---|---|---|
| 0 | تعذّرت مصادقة مستخدم التطبيق؛ غالباً رمز منتهٍ أو أُبطل | رمز جديد |
| 200 | لم يُرسل رمز مع الطلب أصلاً، وتقول Meta إنه مختلف عن 190 | تأكد من ترويسة Authorization |
| 3 و10 و200 حتى 299 و131005 | صلاحية ناقصة أو أُزيلت | افحص الرمز بأداة Debugger وأضف الصلاحية أو الحساب الناقص |
| 131031 | الحساب مقيّد أو تعذّر التحقق من بيانات الطلب | لا علاقة له بالرمز (شرح 131031) |
| 131037 | رقم 555 بلا اسم عرض معتمد | يخص الرقم لا الرمز (شرح 131037) |
حسب صفحة أكواد أخطاء Cloud API من Meta، اطّلعنا عليها في 5 نوفمبر 2026. القائمة الكاملة في دليل أكواد أخطاء واتساب API.
كيف تمنع تكرار الخطأ 190؟
- لا رمز مؤقت في التشغيل: رمز صفحة API Setup للتجربة فقط.
- مستخدم نظام لكل تكامل: بدور Employee على الحساب المطلوب وحده، فإبطال رمز نظام الفواتير لا يوقف نظام الحجز.
- دورة تجديد مكتوبة لرموز 60 يوماً: بالترتيب الذي توصي به Meta: جدّد، ثم انشر الجديد، ثم ألغِ القديم. والإلغاء يسري فوراً.
- تنبيه عند أول 190: اجعل نظامك يرسل تنبيهاً لإنسان بالكود والرمز الفرعي بدل أن يعيد المحاولة صامتاً.
- الرمز على الخادم فقط: لا في كود الموقع الظاهر للمتصفح، ولا في تطبيق جوال، ولا في لقطة شاشة.
- سجل بمن يملك الصلاحية: من يستطيع إنشاء الرموز وإبطالها في إعدادات الأعمال، ومن يزيل التطبيقات المتصلة (إضافة موظفين وصلاحيات في حساب Meta للأعمال).
ماذا تفعل إذا كان رقمك مربوطاً بمظبوت؟
- الربط العادي بلا رموز تنسخها: بزر «ربط واتساب» تكمل التسجيل المدمج عند Meta، فيحصل مظبوت على رمز تكامل أعمال مرتبط بحسابك. وتقول Meta إن هذا الرمز لا ينتهي افتراضياً، ويستطيع صاحب الحساب إلغاءه في أي وقت.
- إن أزلت مظبوت من Connected apps أو سحبت صلاحياته: أعد الربط بزر «ربط واتساب» مع منح كل الصلاحيات التي تطلبها Meta.
- قبل كل حملة: يتحقق مظبوت من الرقم ورمز الوصول عند Meta قبل وضع الرسائل في طابور الإرسال، وزر «مزامنة» في بطاقة الحساب يعيد فحص الرمز والاشتراك في الويبهوك.
- لمن يدير تطبيق Meta بنفسه: بطاقة «رمز الوصول إلى واتساب» في «إعدادات واتساب» لإدخال رمز مستخدم النظام الجديد.
- نظامك يتحدث مع مظبوت لا مع Meta: عند إرسال القوالب من متجرك عبر API مظبوت تستخدم مفتاح API من صفحة «API»، فيبقى رمز Meta داخل مظبوت.
مثال من الرياض: مدير جديد في شركة تأجير سيارات «نظّف» قائمة التطبيقات المتصلة في إعدادات الأعمال وأزال تطبيقاً لم يعرفه. توقفت ردود الفريق، فأعاد الربط بزر «ربط واتساب» خلال دقائق، وأضاف قاعدة: لا إزالة لتطبيق متصل قبل سؤال مسؤول واتساب.
كيف يساعدك مظبوت؟
- ربط رسمي عبر Meta في دقائق دون إنشاء مستخدم نظام أو تجديد رموز بنفسك، مع فحص تلقائي للصلاحيات.
- رقمك الحالي مع بقاء تطبيق واتساب بيزنس، والربط الرسمي يقلل مخاطر الحظر اللي بتسببها الأدوات غير الرسمية، مع الالتزام بسياسات واتساب.
- API وWebhooks موقّعة لربط متجرك أو نظام الحجز، وصندوق وارد لفريقك، وحملات بالقوالب.
- بدون أي عمولة على رسائل Meta، والاشتراك من 6$ شهرياً بعد خصم 50% (السعر الأصلي 12$).
أسئلة شائعة
هل الخطأ 190 يعني أن رقمي محظور؟
لا. الخطأ يخص رمز الوصول المرفق بالطلب، والرقم وحساب واتساب سليمان. ضع رمزاً صالحاً ويعود الإرسال فوراً.
كم مدة صلاحية رمز الوصول المؤقت؟
تقول Meta إن رمز صفحة API Setup ينتهي خلال ساعات وتحتاج رمزاً جديداً كل بضع ساعات، فهو للتجربة فقط.
هل أختار الرمز الدائم أم رمز 60 يوماً؟
توصي Meta برمز 60 يوماً للحد من خطر التسرّب، مع تجديد منتظم. والدائم مناسب حسب Meta لمن يقبل هذا الخطر مقابل عمل متواصل بلا تدخل، وبعض الشركات ملزمة بالرموز المنتهية.
ما الفرق بين الخطأ 190 والخطأ 200؟
190 يعني أن الرمز موجود لكنه انتهى أو أُلغي، و200 يعني أن الطلب وصل بلا رمز أصلاً أو بصلاحية ناقصة. وتنص Meta على أن الحالتين مختلفتان.
هل تُحاسب الرسائل التي فشلت بالخطأ 190؟
لا. Meta تحاسب على الرسائل المُسلَّمة، والطلب المرفوض بسبب الرمز لم يُسلِّم أي رسالة.
اقرأ أيضاً:
المصادر
- Meta: WhatsApp Cloud API error codes (190 و0 و3 و10 و200 و131005) (اطّلعنا عليها في 5 نوفمبر 2026)
- Meta: Graph API Handling errors (الرموز الفرعية 458 و460 و463 و467 وحقول الرد) (اطّلعنا عليها في 5 نوفمبر 2026)
- Meta: Access tokens (الرمز المؤقت ورمز مستخدم النظام ورمز تكامل الأعمال) (اطّلعنا عليها في 5 نوفمبر 2026)
- Meta: Install apps, generate, refresh and revoke tokens (الدائم و60 يوماً والتجديد والإلغاء) (اطّلعنا عليها في 5 نوفمبر 2026)
- Meta: Facebook Login for Business (رمز تكامل الأعمال وإلغاؤه) (اطّلعنا عليها في 5 نوفمبر 2026)
- لوحة مظبوت: «إعدادات واتساب» وصفحة «API»، كما راجعناهما في 5 نوفمبر 2026
اربط رقمك رسمياً.. بدون رموز تنسخها أو تجددها بنفسك
مع مظبوت: تسجيل مدمج من Meta يحصل على رمز الوصول ويفحص صلاحياته تلقائياً، وفحص للرقم والرمز قبل كل حملة، وAPI وWebhooks لنظامك، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%، مع 250,000 توكن ذكاء اصطناعي مجاناً للحسابات الجديدة.
