‏API السحابة‏

منصة واتساب للأعمال > API السحابة > المرجع

التسجيل

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

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

قبل أن تتمكن من تسجيل رقم هاتف النشاط التجاري، يجب أولاً التحقق من الملكية.

استثناء الترحيل

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

تسجيل رقم هاتف النشاط التجاري

لتسجيل رقم هاتف النشاط التجاري الذي تم التحقق منه، يمكنك إرسال استدعاء POST إلى PHONE_NUMBER_ID/register. قم بتضمين المعلمات المدرجة أدناه.

نقطة النهايةالمصادقة

PHONE_NUMBER_ID/register

(راجع الحصول على معرف رقم الهاتف)

Solution Partners must authenticate themselves with an access token with the whatsapp_business_management permission.

التقييدات

تقتصر الطلبات إلى نقطة نهاية التسجيل على 10 طلبات لكل رقم نشاط تجاري خلال فترة متغيرة مدتها 72 ساعة.

عند إرسال طلب تسجيل، سنتحقق من عدد طلبات التسجيل التي قمت بها لتسجيل هذا الرقم خلال آخر 72 ساعة. إذا كنت قد أرسلت 10 طلبات بالفعل، فسترجع API رمز الخطأ 133016، وسيتم منع الرقم من التسجيل لمدة 72 ساعة قادمة.

المعلمات

الاسمالوصف

messaging_product

مطلوب.

خدمة المراسلة المستخدمة. يمكنك تعيين ذلك على "whatsapp".

pin

مطلوب.

إذا تم تمكين التحقق بخطوتين بالفعل لرقم هاتف النشاط التجاري الذي تم التحقق منه، فيمكنك تعيين هذه القيمة على رقم PIN للتحقق بخطوتين المكون من 6 أرقام الخاص برقمك. إذا تعذر عليك تذكر رقم PIN، فيمكنك تحديثه.


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

data_localization_region

اختياري.


إذا تم تضمينه، فسيتم تمكين مساحة التخزين المحلية في رقم هاتف النشاط التجاري. يجب أن تكون القيمة عبارة عن كود بلد مكوّن من حرفين بتنسيق ISO 3166 (مثل IN) ويشير إلى البلد الذي تريد تخزين البيانات فيه عند عدم استخدامها.


علمًا بأن القيم المدعومة هي:


آسيا والمحيط الهادئ

  • أستراليا: AU
  • إندونيسيا: ID
  • الهند: IN
  • اليابان: JP
  • سنغافورة: SG
  • كوريا الجنوبية: KR

أوروبا

  • الاتحاد الأوروبي (ألمانيا): DE
  • سويسرا: CH
  • المملكة المتحدة: GB

أمريكا اللاتينية

  • البرازيل: BR

الشرق الأوسط وأفريقيا

  • البحرين: BH
  • جنوب أفريقيا: ZA
  • الإمارات العربية المتحدة: AE

أمريكا الشمالية

  • كندا: CA

بمجرد التمكين، لا يمكن التعطيل أو التغيير مباشرةً. بدلاً من ذلك، يجب إلغاء تسجيل الرقم وإعادة تسجيله بدون هذه المعلمة (للتعطيل) أو تضمين المعلمة بكود البلد الجديد (للتغيير).


لتمكين مساحة التخزين المحلية على رقم تم تسجيله بالفعل، يجب إلغاء تسجيل الرقم ثم إعادة تسجيله وتضمين هذه المعلمة.

مثال على الطلب بدون مساحة التخزين المحلية

curl 'https://graph.facebook.com/v19.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "212834"
}

مثال على الطلب بمساحة التخزين المحلية

curl 'https://graph.facebook.com/v19.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "212834",
  "data_localization_region": "CH"
}

All API calls require authentication with access tokens.

Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.

Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.

إلغاء تسجيل رقم هاتف النشاط التجاري

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

لا يعمل إلغاء تسجيل رقم الهاتف على حذف رقم أو سجل الرسائل المرتبط به. لحذف الرقم والسجل، راجع حذف رقم الهاتف من حساب واتساب للأعمال.

لإلغاء تسجيل رقم هاتف النشاط التجاري، يمكنك إرسال استدعاء POST إلى PHONE_NUMBER_ID/deregister:

نقطة النهايةالمصادقة

PHONE_NUMBER_ID/deregister

(راجع الحصول على معرف رقم الهاتف)

Solution Partners must authenticate themselves with an access token with the whatsapp_business_management permission.

التقييدات

تقتصر طلبات نقطة نهاية إلغاء التسجيل على 10 طلبات لكل رقم نشاط تجاري خلال فترة متغيرة مدتها 72 ساعة.

عندما ترسل طلب إلغاء التسجيل، سنتحقق من عدد طلبات إلغاء التسجيل التي قدمتها لإلغاء تسجيل هذا الرقم خلال آخر 72 ساعة. إذا كنت قد قدمت 10 طلبات بالفعل، فسترجع API رمز الخطأ 133016، وسيتم منع إلغاء تسجيل الرقم لمدة 72 ساعة قادمة.

مثال

عينة من الطلب:

curl -X POST \  
 'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/deregister' \  
 -H 'Authorization: Bearer ACCESS_TOKEN'

تكون الاستجابة الناجحة على النحو التالي:

{
  "success": true
}

راجع أيضًا