مساحة التخزين المحلية في API السحابة

تمنحك مساحة التخزين المحلية في API السحابة خيار التحكم في مكان تخزين بيانات الرسائل أثناء عدم النشاط. إذا كانت شركتك مرتبطة بصناعة خاضعة للتنظيم مثل التمويل أو الحكومة أو الرعاية الصحية، فسيكون من الأفضل تخزين بيانات الرسائل في بلد معين أثناء عدم النشاط بسبب السياسات التنظيمية أو سياسات الشركة.

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

• فترة صلاحية البيانات قيد الاستخدام (TTL): تم تطبيق تقييد جديد للاحتفاظ بالبيانات، ما يفرض المدة التي يمكن فيها الوصول إلى محتوى الرسائل بالنسبة إلى واجهة API السحابية في مراكز بيانات Meta الموجودة خارج نطاق الاختصاص القضائي المستهدف أثناء معالجته. عند استخدام مساحة التخزين المحلية، ستقوم واجهو API السحابية تلقائيًا بحذف محتوى الرسائل من مراكز بيانات Meta بعد فترة صلاحية تدوم لمدة 60 دقيقة. لن يكون هناك محتوى للرسائل على خوادم Meta الموجودة خارج نطاق الاختصاص القضائي المستهدف بعد انتهاء فترة الصلاحية عند استخدام مساحة التخزين المحلية.
• موقع البيانات أثناء عدم النشاط: تم تطبيق تقييد جديد على موضع البيانات، ما يفرض تحديد الموقع الفعلي الذي يُسمح لواجهة API السحابية باستخدامه كمساحة تخزين دائمة لمحتوى الرسائل. سيتم تخزين حمولة بيانات النص والوسائط لكل من الرسائل الواردة والصادرة في مساحات تخزين البيانات لدى واجهة API السحابية داخل الدولة (بخلاف الولايات المتحدة).

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

تكمّل ميزة مساحة التخزين المحلية عناصر التحكم في الخصوصية والأمان الأخرى في واجهة API السحابية، وتسمح للعملاء بضمان مستوى أعلى من الامتثال للوائح المحلية لحماية البيانات.

البيانات المطوعة محليًا

تنفذ API السحابة التطويع المحلي لمحتوى الرسائل. تغطي ميزة مساحة التخزين المحلية تدفقات الرسائل التالية:

• الرسائل الصادرة: الرسائل التي ترسلها إلى المستلمين عبر واجهة API السحابية
• الرسائل الواردة: الرسائل التي تتلقاها عبر واجهة API السحابية

تغطي ميزة مساحة التخزين المحلية أنواع الرسائل التالية:

• الرسائل النصية: يتم تطويع حمولة بيانات النص (نص الرسالة) محليًا
• رسائل الوسائط: يتم تطويع حمولة بيانات الوسائط (مقطع صوتي أو مستند أو صورة أو فيديو) محليًا
• رسائل القوالب: يتم تطويع المكونات التي تحتوي على حمولة بيانات نص/ وسائط محليًا

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

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

المناطق المتوفرة

تتواجد المناطق التي يسمح بها التخزين المحلي في واجهة API السحابية في شروط الاستضافة في Meta لواجهة API السحابية. يمكن العثور على المناطق المتوفرة حالية للتخزين المحلي ضمن المعلمة data_localization_region التي يتم تعيينها أثناء تسجيل رقم الهاتف.

المتطلبات

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

التقييدات

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

تمكين مساحة التخزين المحلية

اتبع الخطوات أدناه لتمكين مساحة التخزين المحلية لرقم هاتف النشاط التجاري غير مسجل باستخدام الإصدار 21.0 من API أو إصدار أحدث. إذا كنت تستخدم إصدار API أقدم، فراجع تمكين مساحة التخزين المحلية (الإصدار 20 والإصدارات الأقدم).

الخطوة الأولى: تمكين مساحة التخزين المحلية على الرقم

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings لتمكين مساحة التخزين المحلية على رقم هاتف النشاط التجاري غير المسجل:

بنية الطلب

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings

{
  "storage_configuration": {
    "status": "IN_COUNTRY_STORAGE_ENABLED", 
    "data_localization_region": "<COUNTRY_CODE>"
  }
}

قم بتعيين <COUNTRY_CODE> إلى كود البلد الخاص بالبلد الذي سيتم تخزين البيانات فيه.

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

{
  "success": <SUCCESS>
}

عند نجاح العملية، سيتم تعيين <SUCCESS> إلى true.

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

curl 'https://graph.facebook.com/v21.0/106540352242922/settings' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "storage_configuration": {
    "status": "IN_COUNTRY_STORAGE_ENABLED", 
    "data_localization_region": "BR"
  }
}'

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

{
  "success": true
}

الخطوة الثانية: تسجيل الرقم

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register لتسجيل رقم هاتف النشاط التجاري.

بنية الطلب

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register

{
  "messaging_product": "whatsapp",
  "pin": "<TWO_STEP_PIN>"
}

قم بتعيين <TWO_STEP_PIN> إلى رقم التعريف الشخصي للتحقق بخطوتين المطلوب لرقم هاتف النشاط التجاري.

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

{
  "success": <SUCCESS>
}

عند نجاح العملية، سيتم تعيين <SUCCESS> إلى true.

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

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

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

{
  "success": true
}

الحصول على إعدادات مساحة التخزين المحلية

استخدم نقطة النهاية GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings للحصول على إعدادات مساحة التخزين المحلية في رقم هاتف واتساب للأعمال. على سبيل المثال:

curl 'https://graph.facebook.com/v21.0/179776755229976/settings' \
-H 'Authorization: Bearer EAAJB...'

يُرجع هذا عقدة تمثل إعدادات مساحة التخزين المحلية في رقم هاتف النشاط التجاري. على سبيل المثال:

{
  "storage_configuration": {
    "status": "IN_COUNTRY_STORAGE_ENABLED",
    "data_localization_region": "BR"
  }
}

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

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings لتعطيل مساحة التخزين المحلية على رقم هاتف النشاط التجاري غير المسجل باستخدام الإصدار 21.0 من API أو إصدار أحدث. إذا كنت تستخدم إصدار API أقدم، فراجع تعطيل مساحة التخزين المحلية (الإصدار 20 والإصدارات الأقدم).

بنية الطلب

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID/>settings

{
  "storage_configuration": {
    "status": "IN_COUNTRY_STORAGE_DISABLED"
  }
}

قم بتعيين <COUNTRY_CODE> إلى كود البلد الخاص بالبلد الذي سيتم تخزين البيانات فيه.

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

{
  "success": <SUCCESS>
}

عند نجاح العملية، سيتم تعيين <SUCCESS> إلى true.

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

curl 'https://graph.facebook.com/v21.0/106540352242922/settings' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "storage_configuration": {
    "status": "IN_COUNTRY_STORAGE_DISABLED"
  }
}'

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

{
  "success": true
}

تمكين مساحة التخزين المحلية (الإصدار 20 والإصدارات الأقدم)

لتمكين مساحة التخزين المحلية لرقم هاتف نشاط تجاري غير مسجل باستخدام الإصدار 20.0 أو الإصدارات الأقدم):

الخطوة الأولى: مراجعة حالة التحقق

استخدم نقطة النهاية GET /<WHATSAPP_BUSINESS_PHONE_NUMBER> واطلب الحقل code_verification_status. إذا كانت حالة التحقق من الرمز هي VERIFIED، فيمكنك التخطي إلى الخطوة الرابعة. بخلاف ذلك، انتقل إلى الخطوة الثانية.

الخطوة الثانية: طلب رمز تحقق

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/request_code لطلب رمز التحقق. عند نجاح العملية، ستستجيب API بالقيمة true وسيتم إرسال رمز التحقق إلى رقم الهاتف عبر الطريقة المحددة في المعلمة code_method.

على سبيل المثال، يطلب هذا الاستعلام رمز التحقق الذي سيتم إرساله عبر رسالة SMS باللغة الإنجليزية (اللغة المحلية للولايات المتحدة).

curl -X POST 'https://graph.facebook.com/v21.0/110200345501442/request_code?code_method=SMS&language=en_US' \
-H 'Authorization: Bearer EAAJB...'

استخدم الرمز الموجود في الرسالة التي يتم استلامها في الخطوة التالية.

الخطوة الثالثة: تحقق من صحة رقم هاتف النشاط التجاري

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/verify_code للتحقق من رقم هاتف النشاط التجاري باستخدام رمز التحقق الموجود في الرسالة التي تم استلامها من الخطوة السابقة.

على سبيل المثال:

curl -X POST 'https://graph.facebook.com/v21.0/110200345501442/verify_code?code=123830' \
-H 'Authorization: Bearer EAAJB...'

الخطوة الرابعة: تسجيل رقم هاتف النشاط التجاري

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register لتسجيل رقم هاتف النشاط التجاري. يمكنك الإشارة إلى البلد الذي يجب تخزين البيانات فيه باستخدام معلمة data_localization_region.

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

curl 'https://graph.facebook.com/v21.0/110200345501442/register' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "123456",
  "data_localization_region": "IN"
}'

تعطيل مساحة التخزين المحلية (الإصدار 20 والإصدارات الأقدم)

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/deregister لتعطيل مساحة التخزين المحلية على رقم هاتف النشاط التجاري باستخدام الإصدار 20.0 من API أو إصدار أقدم.

على سبيل المثال:

curl -X POST 'https://graph.facebook.com/v21.0/110200345501442/deregister' \
-H 'Authorization: Bearer EAAJB...'

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

الأسئلة المتكررة

س. ما مسارات الترحيل المتعلقة بنقل رقم هاتف إلى إصدار API السحابة مع مساحة التخزين المحلية؟

ندعم جميع مسارات الترحيل إلى إصدار API السحابة مع مساحة التخزين المحلية، وهذا يشمل:

• ترحيل رقم API داخل المواقع الحالي إلى إصدار API السحابة مع مساحة التخزين المحلية
• ترحيل رقم API السحابة الحالي إلى إصدار API السحابة مع مساحة التخزين المحلية
• تمكين مساحة التخزين المحلية لرقم جديد في API السحابة

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

س. هل توجد أي مخاطر تتعلق بالترحيل؟ هل توجد أي حالات توقف مرتبطة بهذه العملية؟

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