إدارة أرقام الهواتف والشهادات

يوفر هذا الدليل نظرة عامة على المعلومات المرتبطة بأرقام الهواتف لدى شركاء الحلول والعملاء. بالإضافة إلى ذلك، يتضمن هذا الدليل معلومات حول العملية بالنسبة لشركاء الحلول في حال اضطروا إلى إدارة رقم هاتف العميل وشهاداته.

معلومات أولية حول أرقام الهواتف

تتوفر بعض التفاصيل التي يتعين على الأنشطة التجارية معرفتها فيما يتعلق بأرقام الهواتف والتسجيل المُضمن.

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

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

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

للحصول على معلومات حول كيفية ترحيل رقم هاتف مسجّل بالفعل في واتساب، يمكنك الرجوع إلى ترحيل رقم الهاتف.

تعليمات للعملاء

يكون هذا القسم موجّهًا لعملاء التسجيل المُضمن ويقدم إرشادات حول الإجراءات التي يمكنهم تنفيذها فيما يتعلق بأرقام الهواتف.

إضافة أرقام الهواتف إلى حساب WhatsApp للأعمال

توجد طريقتان لإضافة أرقام أخرى إلى حساب WhatsApp للأعمال (WABA):

1. [موصى به] ابدأ دفق التسجيل المُضمن مرة أخرى، وحدّد مدير الأعمال وحساب واتساب للأعمال (WABA) الحالي، ثم أضف الرقم وتحقق منه.
2. في مدير الأعمال، انتقل إلى علامة التبويب أرقام الهواتف ضمن مدير واتساب، وحدّد إضافة رقم هاتف. عند استخدام هذا الخيار، يتعين على شريك الحلول التحقق يدويًا من رقم الهاتف نظرًا إلى أن ميزة التحقق من الهاتف غير متوفرة في مدير الأعمال. لهذا السبب، يوصى بأن تتبع الأنشطة التجارية تدفق التسجيل المُضمن لإضافة أرقام أخرى.

إرشادات لشركاء الحلول

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

تسجيل أرقام الهواتف في API السحابة

بعد نجاح التحقق من الهاتف من خلال دفق التسجيل المُضمن، يجب أن ينجح التسجيل من خلال إجراء استدعاء API إلى نقطة النهاية register. وفيما يتعلق بذلك، يمكنك توفير إحدى قيم code_method (sms | voice). نظرًا إلى أنه تم التحقق من رقم الهاتف بالفعل، فلا داعي للقلق بشأن رمز التسجيل. لا يلزم إجراء استدعاء واجهة API verify.

بدلاً من ذلك، يمكنك إعادة التحقق من أرقام الهواتف وعرضها على عملائك في دفق التسجيل المضمَّن الجديد. هذا يمنع العملاء من الاتصال بك للحصول على كلمة سر لمرة واحدة أثناء عملية الإعداد. راجع أرقام الهواتف التي تم التحقق منها مسبقًا.

تسجيل أرقام الهواتف داخل المواقع

بعد نجاح التحقق من الهاتف من خلال دفق التسجيل المُضمن، يجب أن ينجح التسجيل من خلال إجراء استدعاء API إلى نقطة النهاية account. فيما يتعلق بذلك، يمكنك توفير إحدى قيم code_method (sms | voice). نظرًا إلى أنه تم التحقق من رقم الهاتف بالفعل، فلا داعي للقلق بشأن رمز التسجيل. ولا يلزم إجراء استدعاء واجهة API verify.

بدلاً من ذلك، يمكنك إعادة التحقق من أرقام الهواتف وعرضها على عملائك في دفق التسجيل المضمَّن الجديد. هذا يمنع العملاء من الاتصال بك للحصول على كلمة سر لمرة واحدة أثناء عملية الإعداد. راجع أرقام الهواتف التي تم التحقق منها مسبقًا.

الحصول على حالة الهاتف والشهادة

تتيح لك نقطة النهاية phone_numbers رؤية حالة اسم عرض رقم الهاتف واسترداد الشهادة بعد تغيير الاسم. لمزيد من المعلومات، يمكنك الرجوع إلى قراءة أرقام الهواتف.

مثال على الطلب

في المثال التالي، استخدم المعرف المرتبط بحساب واتساب للأعمال الذي تم تعيينه.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    new_name_status
  &access_token={system-user-access-token}"

مثال على الاستجابة

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "last_onboarded_time": "2023-08-22T19:05:53+0000",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

معلمات الاستجابة

الحصول على حالة كلمة مرور لمرة واحدة للهاتف

لمعرفة ما إذا تم التحقق من رقم الهاتف عبر كلمة المرور لمرة واحدة (OTP)، تحقق من الحقل code_verification_status المرتبط بالرقم. أرسل أولاً استدعاء GET إلى نقطة النهاية /{whatsapp-business-account-id}/phone_numbers:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

تتضمن الاستجابة code_verification_status مع أحد الخيارات التالية: VERIFIED أو NOT_VERIFIED. تبدو عينة الاستجابة على النحو التالي:

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

بدلاً من ذلك، يمكنك الحصول على الحالة عن طريق استدعاء معرف رقم الهاتف:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"

فلترة أرقام الهواتف حسب وضع الحساب

يمكنك الاستعلام عن أرقام الهواتف وفلترتها حسب وضع account_mode لديها. فيما يتعلق بالطلب، يمكنك استخدام المعلمات المُدرجة أدناه.

معلمات الطلب

مثال على الطلب

في المثال التالي، استخدم المعرف المرتبط بحساب واتساب للأعمال الذي تم تعيينه.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?filtering=[{
    "field":"account_mode",
    "operator":"EQUAL",
    "value":"SANDBOX"}]
  &access_token={system-user-access-token}"

مثال على الاستجابة

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "verified_name": "John’s Cake Shop",
      "quality_rating": "UNKNOWN",
    }
  ],
  "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

معرفة المزيد

• أرقام الهواتف: نظرة عامة على منصة واتساب للأعمال
• أرقام الهواتف: ترحيل رقم مسجّل موجود
• المرجع: حساب واتساب للأعمال