يوفر هذا الدليل نظرة عامة على المعلومات المرتبطة بأرقام الهواتف لدى شركاء الحلول والعملاء. بالإضافة إلى ذلك، يتضمن هذا الدليل معلومات حول العملية بالنسبة لشركاء الحلول في حال اضطروا إلى إدارة رقم هاتف العميل وشهاداته.
تتوفر بعض التفاصيل التي يتعين على الأنشطة التجارية معرفتها فيما يتعلق بأرقام الهواتف والتسجيل المُضمن.
تحتاج الأنشطة التجارية إلى رقم مخصص لاستخدام WhatsApp من خلال التسجيل المُضمن. وإذا كان يتوفر لدى النشاط التجاري رقم مسجّل بشكل نشط في واتساب مسنجر أو تطبيق واتساب للأعمال، فلن يتمكّن من استخدام رقم الهاتف نفسه.
يمكن أن يتوفر لدى الأنشطة التجارية أرقام هواتف متعددة مرتبطة بحساب الأعمال من Meta، لذلك كل ما يجب فعله هو إضافة رقم هاتف آخر واستخدامه في واتساب.
لا يمكن للنشاط التجاري التسجيل باستخدام دفق التسجيل المُضمن من خلال رقم هاتف تم تسجيله بالفعل في إصدارات تطبيق واتساب للأعمال أو تطبيق مستخدم واتساب.
لمزيد من المعلومات التفصيلية حول أرقام الهواتف ومنصة واتساب للأعمال، يمكنك الرجوع إلى أرقام الهواتف.
للحصول على معلومات حول كيفية ترحيل رقم هاتف مسجّل بالفعل في واتساب، يمكنك الرجوع إلى ترحيل رقم الهاتف.
يكون هذا القسم موجّهًا لعملاء التسجيل المُضمن ويقدم إرشادات حول الإجراءات التي يمكنهم تنفيذها فيما يتعلق بأرقام الهواتف.
توجد طريقتان لإضافة أرقام أخرى إلى حساب WhatsApp للأعمال (WABA):
يكون هذا القسم موجّهًا إلى شركاء الحلول ويقدم إرشادات لإدارة أرقام الهواتف والشهادات الخاصة بالعملاء.
استخدم نقطة النهاية 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 إلى نقطة النهاية 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", } ] }
الاسم | الوصف |
---|---|
| حالة مراجعة طلب اسم العرض الحالي. انقر على السهم في العمود الأيمن لعرض الخيارات المتوفرة. |
| يمثل حالة مراجعة طلب تغيير اسم العرض. يقوم هذا الحقل بإرجاع البيانات فقط إذا تم طلب تغيير اسم العرض. |
| يمكن إرجاع الشهادة الحالية لرقم الهاتف هذا. |
| يمثل شهادة اسم العرض الجديد بعد الموافقة على تغيير اسم العرض. ويقوم هذا الحقل بإرجاع البيانات فقط إذا تمت الموافقة على طلب تغيير اسم العرض ويكون متوفرًا حتى يتم تسجيل رقم الهاتف مع الشهادة الجديدة. |
لمعرفة ما إذا تم التحقق من رقم الهاتف عبر كلمة المرور لمرة واحدة (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
لديها. فيما يتعلق بالطلب، يمكنك استخدام المعلمات المُدرجة أدناه.
الاسم | الوصف |
---|---|
| يمكن أن يتضمن الحقل المُستخدم في الفلترة. وفي هذا المثال، يجب استخدام |
| يمكن أن يحتوي على الطريقة التي تريد بها فلترة الحسابات. وفي هذا المثال، يجب استخدام |
| تتضمن وضع الحساب الذي تبحث عنه. انقر على السهم في العمود الأيمن للتعرف على القيم المدعومة. |
في المثال التالي، استخدم المعرف المرتبط بحساب واتساب للأعمال الذي تم تعيينه.
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" } } }