كيف تحصل على مفتاح WhatsApp API (Token)؟ خطوة بخطوة

كثير من أصحاب الأعمال الذين يبحثون عن "كيف أحصل على مفتاح WhatsApp API؟" يضيعون بين صفحات المطورين التي تظهر لهم. الإجابة المختصرة: لا يوجد في WhatsApp Cloud API "مفتاح API" بالمعنى التقليدي. بدلًا من ذلك تستخدم رمز وصول (access token) تمنحه Meta. نشرح فيما يلي ما هو هذا الرمز، وما أنواعه، وكيف تحصل على الرمز الدائم، دون إغراقك في المصطلحات التقنية.

هل مفتاح WhatsApp API ورمز الوصول (token) الشيء نفسه؟

عمليًا نعم. الناس يقولون "API key"، ووثائق Meta تقول "access token". وكلاهما يؤدي الوظيفة نفسها: يتيح لبرنامجك أن يقول لـ Meta "أنا مخوَّل بإرسال الرسائل نيابةً عن حساب WhatsApp هذا".

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

إذا كنت تريد معرفة ما هو WhatsApp Business API وما الفرق بينه وبين التطبيق، فاطّلع أولًا على مقالنا ما هو WhatsApp Business API.

ما أنواع الرموز، وأيها يجب أن تستخدم؟

يبرز في دليل رموز الوصول لدى Meta ثلاثة أنواع خاصة بـ WhatsApp. ويتوقف اختيارك على ما إذا كنت تتصل بالـ API لأعمالك الخاصة أم نيابةً عن شركات أخرى.

باختصار: إذا كنت ستربط برنامجك الخاص بـ WhatsApp، فما تحتاجه هو رمز مستخدم النظام. وهو ما يُسمّى شائعًا "الرمز الدائم".

لماذا لا يكفي الرمز المؤقت؟

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

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

كيف تحصل على رمز دائم خطوة بخطوة؟

تستند الخطوات التالية إلى وثائق Meta الخاصة ببدء استخدام WhatsApp Cloud API وبرموز الوصول. كتبنا أسماء الشاشات بمسمياتها الإنجليزية التي تستخدمها Meta؛ وقد تظهر بشكل مختلف في الواجهة العربية.

ما يجب تجهيزه قبل البدء

• حافظة أعمالك على Meta (حساب Business Manager). شرحنا عملية التوثيق في مقالنا توثيق الأعمال على Meta.
• حساب مطور على Meta وتطبيق (app) مضاف إليه حالة استخدام WhatsApp.
• حساب WhatsApp ورقم هاتف مرتبطان بهذه الحافظة.
• مستخدم يملك صلاحية المسؤول في الحافظة، إذ لا تُتاح إعدادات مستخدم النظام إلا بهذه الصلاحية.

الخطوات

1. أنشئ مستخدم نظام. ادخل إلى قسم Business settings في Meta Business Suite، ثم انقر على System users من القائمة الجانبية. أنشئ مستخدمًا جديدًا بزر Add، وامنحه اسمًا واختر دوره: Admin أو Employee.
2. عيّن التطبيق. اختر المستخدم الذي أنشأته وانقر على Assign assets. اختر تطبيقك وفعّل صلاحية Manage app ضمن Full control.
3. عيّن حساب WhatsApp. من الشاشة نفسها امنح هذا المستخدم حساب WhatsApp الخاص بك أيضًا.
4. أنشئ الرمز. اضغط على زر Generate token. في النافذة التي تظهر اختر تطبيقك وحدد مدة صلاحية الرمز.
5. أضف الأذونات. الأذونات الثلاثة التي تطلبها Meta هي: business_management وwhatsapp_business_management وwhatsapp_business_messaging. اكتب "business" في مربع البحث لتجدها بسرعة.
6. انسخه واحفظه. بمجرد ظهور الرمز على الشاشة انسخه فورًا واحفظه في مكان آمن.

إذا أردت التأكد من أن الرمز أُنشئ بالأذونات الصحيحة، يمكنك لصقه في أداة Access Token Debugger من Meta. تعرض الأداة نوع الرمز، والتطبيق الذي ينتمي إليه، وأذوناته، وحالة انتهاء صلاحيته.

هل الرمز الدائم لا ينتهي أبدًا فعلًا؟

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

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

كيف تحافظ على أمان الرمز؟

Meta واضحة بشأن هذه الرموز: تعامل معها ككلمة مرورك. فمن يملك الرمز يستطيع إرسال رسائل من رقمك وإدارة قوالبك. لذلك نوصي بالقواعد التالية:

• لا تضعه في شيفرة موقعك. الرمز الموجود في شيفرة تعمل في المتصفح متاح لأي أحد. يجب أن يبقى الرمز في جانب الخادم فقط.
• لا ترسله بالبريد الإلكتروني أو في رسالة. إذا احتجت إلى تسليمه لوكالة أو مبرمج، فاستخدم وسيلة آمنة مثل مدير كلمات المرور.
• لا تمنح صلاحيات أكثر من اللازم. إذا كان تطبيقك سيصل إلى بضعة حسابات فقد يكفي دور Employee بدلًا من Admin.
• لا ترفعه إلى مستودع الشيفرة. بدلًا من كتابة الرمز داخل الشيفرة، احفظه في الإعدادات السرية على الخادم.
• لا تنتظر إذا شككت في تسرّبه. أنشئ رمزًا جديدًا، وحدّث برنامجك، وألغِ الرمز القديم.

هل تتعامل الشركة التي تستخدم لوحة تحكم مع الرمز؟

لا. كل هذه الخطوات مخصصة للشركات التي تربط برنامجها الخاص بـ WhatsApp مباشرةً. إذا كنت تعمل عبر لوحة تحكم جاهزة فأنت لا تنشئ الرمز ولا تنسخه ولا تحفظه.

Chatopya مزود تقنية (Tech Provider) معتمد من Meta. عند إعداد WhatsApp Business API نتولى نحن توثيق الأعمال على Meta وتقديم الطلب نيابةً عن الشركة. يستغرق إعداد اللوحة نحو 5 دقائق؛ وإذا لم يسبق تسجيل الرقم لدى Meta إطلاقًا تُضاف مدة المراجعة الخاصة بـ Meta. بعد ذلك تدير رسائلك وقوالبك وفريقك مباشرةً من اللوحة.

وماذا لو أردت ربط نظام ERP الخاص بك أو برنامجك المخصص؟ في Chatopya يُقدَّم الوصول إلى الـ API وتكامل ERP/التكامل المخصص ضمن باقة Enterprise. يمكنك الاطلاع على الباقات في صفحة الأسعار.

ما الأخطاء الأكثر شيوعًا؟

• الإطلاق الفعلي برمز مؤقت. كل شيء يعمل في اليوم الأول، ثم يتوقف في اليوم التالي.
• إنشاء الرمز بأذونات ناقصة. إذا نقص أحد الأذونات الثلاثة تفشل بعض العمليات.
• تجاوز الوصول إلى الحسابات. إذا لم يُعيَّن حساب WhatsApp وحساب المراسلة لمستخدم النظام، فالرمز وحده لا يفيد.
• إيداع الرمز لدى شخص واحد. عندما يترك هذا الشخص العمل لا يعرف أحد أين يوجد المفتاح. الميزة الأساسية لمستخدم النظام أنه مرتبط بالشركة لا بشخص.

الأسئلة الشائعة