استرداد أرقام الهواتف

يمكنك استرداد أرقام الهواتف التي سجل بها النشاط التجاري في حساب واتساب للأعمال باستخدام API إدارة حساب واتساب للأعمال.

قبل البدء

ستحتاج إلى ما يلي:

• معرف حساب واتساب للأعمال لأرقام هواتف النشاط التجاري التي تريد استردادها
• رمز وصول مستخدم النظام المرتبط بحساب واتساب للأعمال
• الإذن whatsapp_business_management

التقييدات

• لا يمكن لواجهة API هذه سوى استرداد أرقام الهواتف التي تم تسجيلها. غير مسموح بإضافة أو تحديث أو حذف أرقام الهواتف باستخدام API.

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

للحصول على قائمة بكل أرقام الهواتف المرتبطة بحساب واتساب للأعمال، أرسل طلب GET إلى نقطة النهاية حساب واتساب للأعمال > أرقام الهواتف.

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

عينة من الطلب

curl -X GET "https://graph.facebook.com/v21.0/{whatsapp-business-account-id}/phone_numbers
      ?access_token={system-user-access-token}"

عند نجاح العملية، يتم إرجاع كائن JSON يتضمن قائمة بكل أسماء الأنشطة التجارية وأرقام الهواتف ومعرفات أرقام الهواتف وتقييمات الجودة المرتبطة بالنشاط التجاري. يتم فرز النتائج حسب تاريخ إكمال التسجيل في التسجيل المُضمن بالترتيب التنازلي، بحيث يكون الإعداد الأحدث أولاً.

{
  "data": [
    {
      "verified_name": "Jasper's Market",
      "display_phone_number": "+1 631-555-5555",
      "id": "1906385232743451",
      "quality_rating": "GREEN"
      
    },
    {
      "verified_name": "Jasper's Ice Cream",
      "display_phone_number": "+1 631-555-5556",
      "id": "1913623884432103",
      "quality_rating": "NA"
    }
  ]
}

عينة من الطلب

curl -X GET "https://graph.facebook.com/v21.0/{whatsapp-business-account-id}/phone_numbers
      ?access_token={system-user-access-token}]&sort=['last_onboarded_time_ascending']"

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

{
  "data": [
   {
      "verified_name": "Jasper's Ice Cream",
      "display_phone_number": "+1 631-555-5556",
      "id": "1913623884432103",
      "quality_rating": "NA"
    },
    {
      "verified_name": "Jasper's Market",
      "display_phone_number": "+1 631-555-5555",
      "id": "1906385232743451",
      "quality_rating": "GREEN"     
    }   
  ]
}

فلترة أرقام الهواتف

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

المعلمات

عينة من الطلب

curl -i -X GET "https://graph.facebook.com/v21.0/{whatsapp-business-account-ID}/phone_numbers?filtering=[{"field":"account_mode","operator":"EQUAL","value":"SANDBOX"}]&access_token=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"
	}
   }
}

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

للحصول على معلومات حول رقم الهاتف، أرسل طلب GET إلى نقطة النهاية رقم هاتف واتساب للأعمال:

بنية الطلب

GET https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>

عينة من الطلب

curl \
'https://graph.facebook.com/v15.0/105954558954427/' \
-H 'Authorization: Bearer EAAFl...'

عند نجاح العملية، يتم إرجاع كائن JSON يتضمن اسم النشاط التجاري ورقم الهاتف ومعرف رقم الهاتف وتقييم الجودة لرقم الهاتف الذي تم الاستعلام عنه.

{
  "code_verification_status" : "VERIFIED",
  "display_phone_number" : "15555555555",
  "id" : "105954558954427",
  "quality_rating" : "GREEN",
  "verified_name" : "Support Number"
}

الحصول على حالة اسم العرض (إصدار تجريبي)

يمكنك تضمين fields=name_status كمعلمة سلسلة استعلام للحصول على حالة اسم العرض المرتبط برقم هاتف محدد. هذا الحقل متوفر حاليًا كإصدار تجريبي ولا يتوفر لكل المطوّرين.

عينة من الطلب

curl \
'https://graph.facebook.com/v15.0/105954558954427?fields=name_status' \
-H 'Authorization: Bearer EAAFl...'

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

{
  "id" : "105954558954427",
  "name_status" : "AVAILABLE_WITHOUT_REVIEW"
}

يمكن أن تكون القيمة name_status أحد الخيارات التالية:

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

لاحظ أن الشهادات تكون صالحة لمدة 7 أيام.

تعرَّف على المزيد

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