أضف رقم هاتفك وسجّله

20 دقيقة تقريباً، ثم مراجعة Meta للاسم الظاهر · آخر مراجعة 31 أكتوبر 2026 · الإصدار 2.10.0

الرقم هو هوية متجرك على واتساب. في نهاية هذا الشرح سيظهر رقمك بحالة «Connected» في WhatsApp Manager، وسيكون مسجّلاً على Cloud API من Meta، وسيكون لحساب واتساب وسيلة دفع.

اختر الرقم المناسب

• رقم تملكه وستحتفظ به. يحفظه العملاء في هواتفهم، ويبني الرقم تقييم جودته مع الوقت.
• رقم يستقبل رسالة نصية (SMS) أو مكالمة، لتُرسل إليه Meta رمز تأكيد من 6 أرقام. ويمكنك استخدام رقم أرضي مع خيار المكالمة.
• رقم غير مسجّل في تطبيق واتساب أو واتساب للأعمال. تشغّل الإضافة الرقم على Cloud API عبر تطبيقك الخاص في Meta، لذلك يجب أن يخرج من التطبيق. إذا كان الرقم مسجّلاً في التطبيق حالياً، فاحفظ نسخة مما تحتاج إليه من محادثات، ثم احذف الحساب من التطبيق (الإعدادات ← الحساب ← حذف الحساب). ولن تنتقل محادثات التطبيق إلى الإضافة. ولا توفّر الإضافة إبقاءه في تطبيق واتساب للأعمال في الوقت نفسه (تسمّي Meta ذلك Coexistence، ولا يتاح إلا عبر بعض شركاء Meta).

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

خطوات إضافة الرقم

1. افتح «Add phone number»

   في تطبيقك على Meta، افتح WhatsApp ← API Setup، واضغط «Add phone number». ويمكنك أيضاً إضافة الرقم من WhatsApp Manager (business.facebook.com/wa/manage/) ← «Phone numbers» ← «Add phone number».

2. املأ الملف التعريفي لنشاطك

   تطلب Meta الاسم الظاهر (Display name) الذي يراه العملاء، والتصنيف، ووصفاً قصيراً، والمنطقة الزمنية. اكتب اسم متجرك كما يعرفه العملاء، أي الاسم نفسه الموجود في موقعك وحساباتك على وسائل التواصل. وتراجع Meta الاسم الظاهر.

3. أكّد الرقم

   اكتب الرقم مع رمز الدولة، واختر «Text message» أو «Phone call». ثم اكتب رمز التأكيد المكوّن من 6 أرقام الذي ترسله Meta. بهذا تثبت أن الرقم لك.

4. سجّل الرقم على Cloud API برمز PIN

   التسجيل يفعّل الرقم على Cloud API من Meta. إذا كان WhatsApp Manager يعرض الرقم بحالة «Connected»، فتخطَّ هذه الخطوة. وإلا فاتبع قسم التسجيل برمز PIN أدناه.

5. أضف وسيلة دفع

   تحاسبك Meta على رسائلك من خلال حساب واتساب. أضف بطاقة من WhatsApp Manager في «Payment settings»، أو من صفحة «Billing and payments» في Meta (business.facebook.com/billing_hub/).

   إذا لم تكن هناك وسيلة دفع صالحة، توقف Meta الرسائل المدفوعة. عندها يعرض «تشخيص الاتصال» السبب «مشكلة في الدفع بحسابك على Meta» ضمن الرسائل التي فشلت خلال آخر 24 ساعة، ومعه زر «الإصلاح في Meta» الذي يفتح صفحة الفواتير في Meta. وتحتاج مكالمات واتساب أيضاً إلى وسيلة دفع على الحساب.

6. انتظر مراجعة الاسم الظاهر

   يعرض WhatsApp Manager ← «Phone numbers» حالة الاسم الظاهر بجانب الرقم. إذا رفضته Meta، فعدّله ليطابق اسم متجرك، ثم أرسله مرة أخرى. وإذا كان حقل phone_number_name_update مفعّلاً في رابط الاستقبال (Webhook)، فستظهر النتيجة أيضاً في شاشة «صحة الحساب» في الإضافة (اطّلع على شرح رابط الاستقبال).

7. احفظ المعرّفين لاستخدامهما لاحقاً

   ارجع إلى صفحة API Setup، واختر رقمك. ستجد الآن معرّف رقم الهاتف Phone Number ID الخاص بالرقم، ومعرّف حساب واتساب للأعمال WhatsApp Business Account ID الخاص بحسابك. كلاهما رقم طويل، وليس أيّ منهما رقم هاتفك. ستلصقهما في الإضافة في شرح رمز الوصول.

التسجيل برمز PIN

تأكيد الرقم يثبت أنه لك. أما التسجيل فيفعّله على Cloud API، ويضع له رمز PIN من 6 أرقام للتحقق بخطوتين. لا يحتوي WAPI Connect Pro على زر للتسجيل، ولا الإصدار 2.10.0. لذلك تسجّل الرقم مرة واحدة بطلب واحد إلى Graph API من Meta.

هل تحتاج إلى التسجيل؟ سجّل الرقم إذا عرض WhatsApp Manager حالته «Pending» بدلاً من «Connected»، أو إذا ظهرت في «تشخيص الاتصال» الرسالة «هذا الرقم مسجّل على «…» وليس على Cloud API.»

من المتصفح، عبر أداة Graph API Explorer

1. اختر رمز PIN من 6 أرقام، واكتبه في مكان آمن. إذا كان التحقق بخطوتين مفعّلاً على الرقم من قبل، فاستخدم رمز PIN نفسه.
2. افتح developers.facebook.com/tools/explorer.
3. في «Meta App» اختر تطبيقك. وفي «Access Token» الصق رمز وصول يملك صلاحيات واتساب. يصلح الرمز المؤقت من صفحة API Setup، أو الرمز الدائم من الشرح التالي.
4. غيّر الطريقة الموجودة بجانب خانة الرابط من GET إلى POST.
5. في خانة الرابط اكتب معرّف رقم الهاتف، وبعده /register?messaging_product=whatsapp&pin=123456. وضع رمز PIN الخاص بك مكان 123456.
6. اضغط «Submit». إذا ظهرت النتيجة {"success": true}، فقد سُجّل الرقم بنجاح.

أو من سطر الأوامر (Terminal)

curl -X POST "https://graph.facebook.com/v25.0/PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messaging_product": "whatsapp", "pin": "123456"}'

استبدل PHONE_NUMBER_ID وACCESS_TOKEN و123456 بقيمك الخاصة.

تأكّد من نجاح الخطوات

• يعرض WhatsApp Manager ← «Phone numbers» رقمك بحالة «Connected»، ومعه الاسم الظاهر.
• تصبح بطاقة «رقم واتساب» في «تشخيص الاتصال» خضراء بعد أن تلصق المعرّفين ورمز الوصول (في الشرح التالي). وتعرض البطاقة رقمك والاسم الذي وافقت عليه Meta.
• يعرض زر «اختبار الاتصال» في WAPI Connect ← «الحالة والأدوات» ← «أدوات الاختبار» رقمك وتقييم جودته.

مشكلات شائعة وحلولها