Fynchat
· فينشات إدارة أرقام واتساب
من صفحة «واتساب وMeta» تراقب جاهزية أرقامك المتصلة، وتحرّر بيانات اعتمادها، وتضبط الويبهوك وتتابع أحداثه — دون مغادرة الإعدادات.
ما هي صفحة «واتساب وMeta»؟
صفحة إعدادات واتساب («واتساب وMeta») هي لوحة إدارة كاملة لأرقام WhatsApp Business الخاصة بك. من مكان واحد ترى حالة كل رقم ومدى جاهزيته، وتحرّر بيانات اعتماده لدى Meta، وتضبط الويبهوك وتتابع أحداثه الواردة.
مهم: هذه الصفحة تُدير الأرقام المتصلة مسبقاً وتحرّرها فقط. أمّا إضافة رقم جديد أو ربطه لأول مرة فيتم خارج هذه الصفحة (انظر قسم «إضافة رقم جديد» في الأسفل).
للوصول إلى صفحة «واتساب وMeta» يلزم تسجيل الدخول بحساب مُفعّل (بريد موثّق)، ووجود رقم واتساب مرتبط بالفعل، واشتراك ساري المفعول. إن لم تتوفّر هذه الشروط فقد لا تظهر لك الصفحة.
نظرة عامة على الصفحة
يتصدّر الصفحة شريط صحّة يلخّص وضعك:
- عدد الأرقام المرتبطة بحسابك.
- الجاهزية الإجمالية بمؤشّر لوني (أخضر = جاهز، كهرماني = ينقصه شيء).
- ثلاث بطاقات مؤشرات للويبهوك: إجمالي الأحداث، وأحداث آخر 24 ساعة، والرسائل الواردة.
تحت الشريط تظهر بطاقة لكل رقم، وفيها: شارة الحالة، ونقاط الجاهزية مع شريط صحّة، وقائمة إعداد (WABA ID، وMeta App ID، وAccess Token، وApp Secret)، وصف معلومات مختصر (Phone ID، وإصدار الواجهة، وVerify Token)، وأزرار الإجراءات الخاصة بالرقم (اختبار، تعديل، اكتشاف WABA، اكتشاف App ID).
مؤشّر الجاهزية (نقاط الصحّة)
نقاط الجاهزية للعرض فقط، وتُحسب على مستويين:
- لكل رقم: خمسة فحوص من أصل 5 هي — وجود توكن الوصول، ومعرّف WABA، ومعرّف التطبيق، والسر السري للتطبيق، وأن يكون الرقم نشطاً.
- الإجمالي: يرصد النواقص عبر أرقامك — غياب توكن الوصول أو معرّف WABA أو معرّف التطبيق، إضافةً إلى رابط ويبهوك غير آمن (ليس HTTPS).
كلما اكتملت هذه العناصر ارتفعت النقاط وتحوّل المؤشّر إلى الأخضر.
تعديل بيانات الرقم
زر تعديل يفتح نافذة بيانات الاعتماد لكل رقم. الحقول:
| الحقل | الوصف |
|---|---|
| الاسم (Name) | اسم العرض للرقم، ويظهر كعنوان البطاقة. اختياري. |
| معرّف رقم الهاتف (Phone Number ID) | معرّف رقم الهاتف من Meta Cloud API وهو المفتاح الأساسي للرقم. إلزامي، وتجده في WhatsApp → API Setup → «Phone number ID». |
| رقم الهاتف الظاهر (Display Phone Number) | الرقم بصيغته المقروءة (مثل +9665…)، ويظهر على البطاقة. يُحدَّث تلقائياً عند اختبار الاتصال أو الربط. |
| معرّف حساب الأعمال WABA (Business Account ID) | معرّف حساب WhatsApp Business؛ جزء من قائمة الإعداد، ويمكن اكتشافه تلقائياً. |
| معرّف تطبيق ميتا (Meta App ID) | معرّف تطبيق Meta المستخدَم للرقم؛ جزء من قائمة الإعداد، ويمكن اكتشافه تلقائياً. |
| توكن الوصول (Access Token) | توكن Cloud API السرّي (حقل مخفي). يُرسَل فقط إذا أعدت إدخاله؛ وإن تركته فارغاً يبقى كما هو دون تغيير، ولا يعرض النظام قيمته الخام أبداً. |
| توكن التحقق (Verify Token) | توكن التحقق الخاص بالويبهوك لهذا الرقم؛ قابل للتعديل، ويظهر أيضاً للقراءة فقط في قسم إعداد الويبهوك. |
| السر السري للتطبيق (App Secret) | السر المستخدَم للتحقق من توقيع رسائل الويبهوك (حقل مخفي). يُرسَل فقط إذا أعدت إدخاله. |
| إصدار الواجهة (API Version) | إصدار Graph API للرقم. الخيارات: v25.0 أو v24.0 أو v23.0. |
| نشط (Active) | خانة اختيار لتفعيل الرقم أو تعطيله؛ تتحكّم بشارة «نشط/غير نشط» وتدخل ضمن نقاط الجاهزية. |
عند الحفظ تُرسَل التعديلات وتُحدَّث الصفحة. الحقول السرّية (توكن الوصول والسر السري للتطبيق) المتروكة فارغة لا تُرسَل، فلا يُكتب فوق القيم المحفوظة.
الإجراءات لكل رقم
| الإجراء | ما الذي يفعله |
|---|---|
| اختبار الاتصال (Test) | يتحقّق من بيانات الاعتماد لدى Meta ويعرض الاسم الموثّق وتقييم الجودة، ويملأ الرقم الظاهر تلقائياً، ويحوّل حالة الرقم إلى «متصل». |
| تعديل / حفظ التغييرات (Edit / Save) | يفتح نافذة بيانات الاعتماد ويحفظ تعديلاتك؛ الحقول السرّية الفارغة لا تُرسَل. تُحدَّث الصفحة عند النجاح. |
| اكتشاف معرّف WABA (Discover WABA) | يكتشف معرّف حساب الأعمال تلقائياً عبر Meta. يظهر الزر فقط عند وجود توكن وصول محفوظ وغياب معرّف WABA. |
| اكتشاف معرّف التطبيق (Discover App ID) | يكتشف معرّف تطبيق Meta تلقائياً. يظهر الزر فقط عند وجود توكن وصول محفوظ وغياب معرّف التطبيق. |
إعداد الويبهوك
يوفّر قسم الويبهوك ما تحتاجه لضبط Meta على إرسال الأحداث إليك:
- رابط الاستدعاء (Callback URL): رابط للقراءة فقط تنسخه (زر نسخ) وتلصقه في Meta، مع مؤشّر يبيّن ما إذا كان الرابط آمناً (HTTPS) أم لا.
- توكن التحقق (Verify Token): يُعرض للقراءة فقط لأول رقم، مع زر نسخ، لاستخدامه في إعداد ويبهوك Meta.
- الاشتراك في أحداث الويبهوك: زر يشترك بتطبيقك في ويبهوك WABA ورقم الهاتف لأول رقم، لتبدأ الأحداث الواردة بالتدفّق.
سجل نشاط الويبهوك
أسفل إعداد الويبهوك يظهر سجل النشاط بأحدث الأحداث الواردة (حتى ثمانية)، ويعرض لكل حدث ما إذا كان قد عُولج، ونوعه، وشارة خطأ إن أخفق. زر تحديث يعيد تحميل الإحصاءات والأحداث فقط دون إعادة تحميل الصفحة كاملة.
بطاقتا إجمالي الأحداث وآخر 24 ساعة في أعلى الصفحة تَعُدّان هذه الأحداث نفسها، أمّا بطاقة الرسائل الواردة فهي عدٌّ منفصل للرسائل الواردة المستلمة.
إضافة رقم جديد
إضافة رقم جديد أو ربطه لأول مرة لا تتم داخل هذه الصفحة. في أعلى الصفحة رابط «إدارة الكل» (Manage all)، وعند عدم وجود أي رقم بعد يظهر زر «إضافة» (Add)؛ وكلاهما ينقلك خارج صفحة الإعدادات إلى مكان إضافة الرقم أو ربطه.
لخطوات ربط رقم جديد (عبر Embedded Signup أو الإدخال اليدوي)، راجع مقال «ربط حساب WhatsApp Business».
نصائح واستكشاف الأخطاء
- لا يظهر زر اكتشاف WABA / اكتشاف App ID؟ لا يظهر أيّ منهما إلا بعد حفظ توكن الوصول، وفقط طالما أن المعرّف المقابل ما زال ناقصاً. أدخِل التوكن أولاً.
- الويبهوك يظهر غير آمن؟ يجب أن يكون رابط الاستدعاء عبر HTTPS؛ فالجاهزية الإجمالية تُعلِّم الرابط غير الآمن كنقص يجب معالجته.
- لا تصل أحداث؟ استخدم زر الاشتراك في أحداث الويبهوك، ثم راقب سجل النشاط واضغط تحديث لمتابعة وصولها.
- تعديل دون فقدان الأسرار: اترك توكن الوصول والسر السري للتطبيق فارغين إذا لم ترد تغييرهما؛ فالحقول الفارغة لا تُكتب فوق القيم المحفوظة.
- تحتوي الصفحة أيضاً على قسم استكشاف الأخطاء قابل للطيّ يجمع حلولاً للمشكلات الشائعة.
اقرأ أيضًا
- كيف تحصل على واتساب بزنس API في السعودية — المتطلبات والمدة وأسباب التعثّر
- العلامة الخضراء وتوثيق حساب واتساب
- الفرق بين واتساب العادي وبزنس وAPI