ما هو Access Token (رمز الوصول) في واتساب API؟ شرح مبسط بالأمثلة

آخر تحديث: 5 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: توثيق Meta لأنواع رموز الوصول في منصة واتساب للأعمال ولمستخدمي النظام، ولوحة مظبوت كما راجعناها في 5 نوفمبر 2026

الإجابة المختصرة: Access Token (رمز الوصول) نص سري طويل يرفقه نظامك مع كل طلب إلى واتساب Cloud API ليثبت لـ Meta من أنت وما المسموح لك به. أنواعه ثلاثة: رمز مستخدم مؤقت من لوحة التطبيق ينتهي خلال ساعات ويصلح للتجربة فقط، ورمز مستخدم النظام (System User) الذي تختار أن يكون دائماً أو صالحاً 60 يوماً، ورمز تكامل الأعمال الذي تحصل عليه المنصات عبر التسجيل المدمج.

هذه صفحة تعريف بالمصطلح. والمفهوم المكمّل له: ما هو Webhook (الويبهوك)؟، فالرمز للإرسال إلى Meta، والويبهوك للاستقبال منها.

محتوى المقال:

ما هو Access Token في واتساب API؟

كل طلب يرسله نظامك إلى Meta، سواء إرسال رسالة أو إنشاء قالب أو قراءة بيانات رقم، يحمل في ترويسته سطراً مثل Authorization: Bearer . هذا الرمز هو ما تتعرف به Meta على صاحب الطلب، وتعرف منه ما يحق له.

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

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

ما أنواع رموز الوصول في واتساب API؟

النوعلمنكيف تحصل عليهمدة الصلاحية
رمز المستخدم (User access token)أول رسالة اختبارApp Dashboard ← WhatsApp ← API setup، وتولّد الصفحة رمزاً جديداً مع كل زيارة؛ أو Graph API Explorerقصيرة؛ تقول Meta إنك ستحتاج رمزاً جديداً «كل بضع ساعات»
رمز مستخدم النظام (System user token)الشركات التي تبني تكاملها بنفسهاإعدادات الأعمال ← System users ← Generate tokenدائم (Never expires) أو 60 يوماً، حسب اختيارك عند الإنشاء
رمز تكامل الأعمال (Business integration system user token)المنصات: Tech Provider وSolution Partnerيكمل العميل التسجيل المدمج، فتستبدل المنصة الكود العائد برمز على خادمهاافتراضياً لا ينتهي، ويستطيع العميل إلغاءه في أي وقت

حسب صفحات Access tokens وSystem users وFacebook Login for Business من Meta، اطّلعنا عليها في 5 نوفمبر 2026.

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

لماذا توقف التكامل بعد ساعات؟ الرمز المؤقت مقابل الدائم

أشهر خطأ عند البداية: يجرب المبرمج الإرسال برمز صفحة API setup، فينجح كل شيء، ثم تتوقف الرسائل بعد ساعات بالخطأ 190 «انتهت صلاحية رمز الوصول». السبب أن هذا رمز مستخدم مؤقت صُمم للتجربة. الحل رمز مستخدم النظام، وهو ما يسميه كثيرون «الرمز الدائم»، مع أن له خيارين:

  • دائم (Never expires): تقول Meta إنه مناسب عندما تستطيع تحمّل خطر تسرّب الرمز مقابل عمل متواصل دون تدخل.
  • 60 يوماً: تصفه Meta بأنه «Recommended» للحد من خطر التسرّب. يبدأ العد من الإنشاء أو آخر تجديد، فإن لم تجدده خلال 60 يوماً يسقط وتحتاج رمزاً جديداً.
  • إلزامي لبعض الشركات: تقول Meta إن بعض الشركات يجب أن تستخدم الرموز المنتهية، ويظهر لها خطأ إن طلبت رمزاً دائماً.

كيف تنشئ رمز مستخدم النظام خطوة بخطوة؟

  1. أنشئ مستخدم النظام: من إعدادات الأعمال في محفظة أعمالك ← System users ← أضف مستخدماً بدور Admin أو Employee.
  2. اربط التطبيق: امنحه تطبيقك بصلاحية Manage app.
  3. امنحه الحسابات: وصول Partial أو Full إلى حساب واتساب للأعمال. مستخدم Admin يصل افتراضياً لكل الحسابات، أما Employee فيحتاج منحاً صريحاً لكل حساب؛ وفي نموذج حسابات Meta الجديد تذكر الصفحة حساب WhatsApp وحساب Messaging، فامنحه الاثنين.
  4. اضغط Generate token: اختر التطبيق ومدة الصلاحية، ثم الصلاحيات الثلاث: business_management وwhatsapp_business_management وwhatsapp_business_messaging.
  5. انسخ الرمز واحفظه فوراً في خزنة أسرار على الخادم، لا في ملف مشترك.

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

ما الصلاحيات المطلوبة وما أخطاء الرمز الشائعة؟

الصلاحيةماذا تتيح
whatsapp_business_messagingإرسال الرسائل والقوالب من أرقام الحساب
whatsapp_business_managementإدارة حساب واتساب للأعمال: القوالب والأرقام والإعدادات والاشتراك في الويبهوك
business_managementالوصول إلى أصول محفظة الأعمال
كود الخطأمعناه حسب Metaالحل
190انتهت صلاحية رمز الوصولرمز جديد، ويفضل رمز مستخدم النظام
0تعذّرت المصادقة؛ غالباً رمز منتهٍ أو أُلغيرمز جديد
3 و10 و200 حتى 299صلاحية ناقصة أو أُزيلتافحص الرمز بأداة Access Token Debugger وأضف الصلاحية الناقصة
200 (بلا رمز)لم يُرسل رمز مع الطلبتأكد من ترويسة Authorization

حسب صفحة أكواد أخطاء WhatsApp Cloud API من Meta، اطّلعنا عليها في 5 نوفمبر 2026. والمرجع الكامل في أكواد أخطاء واتساب API ومعناها وحلها.

كيف تحمي رمز الوصول؟

  • على الخادم فقط: لا تضعه في كود موقعك الظاهر للمتصفح، ولا في تطبيق جوال، ولا في رسالة واتساب أو ملف Excel مشترك أو لقطة شاشة.
  • أقل صلاحية لازمة: مستخدم نظام بدور Employee على الحساب المطلوب فقط، ووصول Partial عندما يكفي، كما توصي Meta.
  • رموز 60 يوماً مع تدوير منتظم: الترتيب الذي توصي به Meta: جدّد الرمز، ثم انشر الجديد، ثم ألغِ القديم عبر oauth/revoke، والإلغاء يسري فوراً.
  • عند التسرّب: ألغِ الرمز فوراً وأنشئ غيره. ولو كان رمز منصة، فإزالة تطبيقها من إعدادات الأعمال ← Integrations ← Connected apps تلغي رمزها.
  • افحص قبل أن تشك: أداة Access Token Debugger تعرض صلاحية الرمز وتاريخ انتهائه وصلاحياته.
  • الرمز غير سر التطبيق: App Secret يوقّع إشعارات الويبهوك، والرمز يأذن بالطلبات؛ احمِ الاثنين.

مثالان على رمز الوصول من القاهرة وجدة

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

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

كيف يتعامل مظبوت مع رمز الوصول؟

  • لا تنسخ أي رمز عند الربط: بزر «ربط واتساب» تسجّل دخولك عند Meta وتختار حسابك ورقمك، فتعيد Meta كوداً يستبدله مظبوت على خادمه برمز مرتبط بحسابك، كما في دليل التسجيل المدمج.
  • يفحص الصلاحيات فوراً: يتأكد أن الرمز يحمل whatsapp_business_management وwhatsapp_business_messaging على حسابك. وإن نقصت صلاحية تظهر رسالة تطلب إزالة الربط ثم إعادته مع منح كل الصلاحيات التي تطلبها Meta.
  • قبل كل حملة: يتحقق مظبوت من الرقم ورمز الوصول عند Meta قبل وضع الرسائل في طابور الإرسال.
  • زر «مزامنة»: في بطاقة الحساب بـ «إعدادات واتساب» يعيد فحص الرمز والاشتراك في الويبهوك.
  • للربط اليدوي: بطاقة «رمز الوصول إلى واتساب» في الصفحة نفسها فيها خانات رمز الوصول وPhone Number ID ومعرف حساب الأعمال ومعرف التطبيق، مع رابط لدليل Meta لإنشاء رمز دائم، لمن يدير تطبيق Meta بنفسه.
  • نظامك لا يحتاج رمز Meta: عند الإرسال من متجرك عبر API مظبوت تستخدم مفتاح API من صفحة «API» ورمز دخول لحساب موظف، فيبقى رمز Meta داخل مظبوت.

كيف يساعدك مظبوت؟

  • ربط رسمي عبر Meta في دقائق دون إنشاء مستخدم نظام أو نسخ رموز، مع فحص تلقائي للصلاحيات.
  • ربط رقمك الحالي مع بقاء تطبيق واتساب بيزنس، والربط الرسمي يقلل مخاطر الحظر اللي بتسببها الأدوات غير الرسمية، مع الالتزام بسياسات واتساب.
  • صندوق وارد للفريق، وحملات بالقوالب، وموظف ذكاء اصطناعي يفهم الرسائل الصوتية.
  • API وWebhooks موقّعة لربط متجرك أو نظام الحجز.
  • بدون أي عمولة على رسائل Meta، والاشتراك من 6$ شهرياً بعد خصم 50% (السعر الأصلي 12$).

أسئلة شائعة

هل رمز الوصول هو كلمة مرور حسابي على فيسبوك؟

لا. هو مفتاح منفصل يصدر لتطبيق أو مستخدم نظام بصلاحيات محددة، ويمكن إلغاؤه دون تغيير كلمة مرورك. لكنه يُحمى بالدرجة نفسها.

كم مدة صلاحية الرمز المؤقت من صفحة API setup؟

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

هل أحتاج رمز وصول إذا ربطت رقمي عبر منصة؟

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

ماذا أفعل إذا تسرّب رمز الوصول؟

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

ما معنى الخطأ 190 في واتساب API؟

انتهت صلاحية رمز الوصول. استبدله برمز جديد، والأفضل رمز مستخدم النظام بدل الرمز المؤقت.

المصادر

اربط رقمك رسمياً.. بدون رموز تنسخها أو تجددها بنفسك

مع مظبوت: تسجيل مدمج من Meta يحصل على رمز الوصول ويفحص صلاحياته تلقائياً، وصندوق وارد لفريقك، وحملات بالقوالب، وAPI وWebhooks لنظامك، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%، مع 250,000 توكن ذكاء اصطناعي مجاناً للحسابات الجديدة.

ابدأ تجربتك المجانية