تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.
تاريخ تحديث المصدر باللغة الإنجليزية: ‏١٧ نوفمبر

إدارة أرقام هواتف النشاط التجاري

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

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

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

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

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

لا يمكن للنشاط التجاري التسجيل باستخدام دفق التسجيل المُضمن من خلال رقم هاتف تم تسجيله بالفعل في إصدارات تطبيق واتساب للأعمال أو تطبيق مستخدم واتساب.

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

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

تعليمات لعملاء الأنشطة التجارية

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

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

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

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

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

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

الحصول على أرقام الهواتف

استخدم نقطة النهاية GET /<WABA_ID>/phone_numbers للحصول على قائمة بأرقام هواتف النشاط التجاري في حساب واتساب للأعمال WABA الخاص بعميل النشاط التجاري.

الطلب

curl 'https://graph.facebook.com/<API_VERSION>/<CUSTOMER_WABA_ID>/phone_numbers' \ -H 'Authorization: Bearer <CUSTOMER_BUSINESS_TOKEN>' 

الاستجابة

عند نجاح العملية:

{ "data": [ { "verified_name": "<VERIFIED_DISPLAY_NAME>", "code_verification_status": "<VERIFICATION_STATUS>", "display_phone_number": "<DISPLAY_PHONE_NUMBER>", "quality_rating": "<QUALITY_RATING>", "platform_type": "CLOUD_API", "throughput": { "level": "<THROUGHPUT_LEVEL>" }, "webhook_configuration": { "application": "<WEBHOOK_CALLBACK_URL>" }, "id": "<BUSINESS_PHONE_NUMBER_ID>" } ], "paging": { "cursors": { "before": "<BEFORE_CURSOR>", "after": "<AFTER_CURSOR>" } } } 

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

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

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

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

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

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

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

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

تتيح لك نقطة النهاية 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",
    }
  ]
}

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

الاسمالوصف

name_status

حالة مراجعة طلب اسم العرض الحالي.

انقر على السهم في العمود الأيمن لعرض الخيارات المتوفرة.

الخيارات المتوفرة

  • APPROVED: تمت الموافقة على الاسم. يمكنك تنزيل الشهادة الآن.
  • DECLINED: لم تتم الموافقة على الاسم. لا يمكنك تنزيل الشهادة.
  • EXPIRED: انتهت صلاحية شهادتك ولا يمكنك تنزيلها بعد الآن.
  • PENDING_REVIEW: طلب الاسم الذي أجريته قيد المراجعة. لا يمكنك تنزيل الشهادة.
  • NONE: لا توجد شهادة متوفرة.

new_name_status

يمثل حالة مراجعة طلب تغيير اسم العرض. يقوم هذا الحقل بإرجاع البيانات فقط إذا تم طلب تغيير اسم العرض.

certificate

يمكن إرجاع الشهادة الحالية لرقم الهاتف هذا.

new_certificate

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

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

لمعرفة ما إذا تم التحقق من رقم الهاتف عبر كلمة المرور لمرة واحدة (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}"

Use the WhatsApp Business Account > Phone Numbers endpoint to get a phone number's ID. See Retrieve Phone Numbers for usage details.

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

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

معلمات الطلب

الاسمالوصف

field

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

operator

يمكن أن يحتوي على الطريقة التي تريد بها فلترة الحسابات. وفي هذا المثال، يجب استخدام EQUAL.

value

تتضمن وضع الحساب الذي تبحث عنه.

انقر على السهم في العمود الأيمن للتعرف على القيم المدعومة.

القيم المدعومة

  • SANDBOX: الحساب غير مثبّت.

  • LIVE: الحساب غير مؤهل للاختبار التجريبي غير المثبّت أو أنه تمت ترقيته إلى حساب تم التحقق منه.

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

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

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"
	}
   }
}