พื้นที่เก็บข้อมูลเฉพาะที่ของ Cloud API

พื้นที่เก็บข้อมูลเฉพาะที่ของ Cloud API ช่วยให้คุณมีตัวเลือกในการควบคุมว่าจะจัดเก็บข้อมูลข้อความของคุณไว้ที่ใดในระหว่างที่พักข้อมูล หากบริษัทของคุณอยู่ในอุตสาหกรรมที่มีการควบคุม เช่น การเงิน การปกครอง หรือการดูแลสุขภาพ คุณอาจต้องการเก็บข้อมูลข้อความของคุณไว้ในประเทศใดประเทศหนึ่งในระหว่างที่พักข้อมูลเนื่องจากนโยบายที่เป็นระเบียบข้อบังคับหรือนโยบายของบริษัท

พื้นที่เก็บข้อมูลเฉพาะที่ของ Cloud API จะช่วยเสริมการคุ้มครองข้อมูลให้รัดกุมขึ้นอีกชั้นโดยใช้การควบคุมการจัดการข้อมูลเพิ่มเติม ฟีเจอร์พื้นที่เก็บข้อมูลเฉพาะที่ประกอบด้วยข้อจำกัดเพิ่มเติม 2 ข้อในสภาพแวดล้อมรันไทม์ของ Cloud API ได้แก่

• TTL (Time-to-Live) สำหรับข้อมูลที่อยู่ระหว่างใช้งาน: มีการนำข้อจำกัดใหม่ในการเก็บรักษาข้อมูลมาใช้ โดยกำหนดระยะเวลาที่ Cloud API สามารถเข้าถึงเนื้อหาข้อความได้ในศูนย์ข้อมูลของ Meta ซึ่งอยู่นอกเขตอำนาจศาลเป้าหมายในระหว่างที่ประมวลผล ขณะใช้พื้นที่เก็บข้อมูลเฉพาะที่ Cloud API จะลบเนื้อหาข้อความออกจากศูนย์ข้อมูลของ Meta โดยอัตโนมัติหลังจากมี TTL ครบ 60 นาที เซิร์ฟเวอร์ของ Meta ที่อยู่นอกเขตอำนาจศาลเป้าหมายจะไม่มีเนื้อหาข้อความอยู่หลังจากพ้น TTL ดังกล่าวไปเมื่อใช้พื้นที่เก็บข้อมูลเฉพาะที่
• ตำแหน่งสำหรับข้อมูลที่อยู่ระหว่างพัก: มีการนำข้อจำกัดใหม่ในการจัดวางข้อมูลมาใช้ โดยกำหนดว่า Cloud API ของตำแหน่งทางกายภาพใดที่ได้รับอนุญาตให้ใช้เป็นพื้นที่เก็บข้อมูลถาวรสำหรับเนื้อหาข้อความ เพย์โหลดข้อความและสื่อของข้อความทั้งขาเข้าและขาออกจะถูกจัดเก็บไว้ในพื้นที่เก็บข้อมูล Cloud API ในประเทศ (นอกสหรัฐอเมริกา)

เมื่อเปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่สำหรับหมายเลขโทรศัพท์ธุรกิจ พื้นที่เก็บข้อมูลเฉพาะที่ของ Cloud API จะใช้พื้นที่เก็บข้อมูลเฉพาะที่ในประเทศที่ระบุเพื่อเก็บเนื้อหาข้อความถาวร แทนที่จะใช้พื้นที่เก็บข้อมูลเริ่มต้นในสหรัฐอเมริกา

ฟีเจอร์พื้นที่เก็บข้อมูลเฉพาะที่จะช่วยเสริมการควบคุมความเป็นส่วนตัวและการรักษาความปลอดภัยอื่นๆ ของ Cloud API และช่วยให้ลูกค้ามั่นใจได้ถึงการปฏิบัติตามระเบียบข้อบังคับด้านการคุ้มครองข้อมูลในพื้นที่นั้นๆ ในระดับที่สูงขึ้น

ข้อมูลที่เก็บเฉพาะที่

Cloud API จะทำการเก็บเฉพาะที่สำหรับเนื้อหาข้อความ ขั้นตอนข้อความต่อไปนี้จะครอบคลุมอยู่ในฟีเจอร์พื้นที่เก็บข้อมูลเฉพาะที่

• ข้อความขาออก: ข้อความที่คุณส่งถึงผู้รับผ่าน Cloud API
• ข้อความขาเข้า: ข้อความที่คุณได้รับกลับมาผ่าน Cloud API

ประเภทข้อความต่อไปนี้จะครอบคลุมอยู่ในฟีเจอร์พื้นที่เก็บข้อมูลเฉพาะที่:

• ข้อความ SMS: เพย์โหลดข้อความ (เนื้อหาข้อความ) จะถูกเก็บไว้เฉพาะที่
• ข้อความสื่อ: เพย์โหลดสื่อ (เสียง รูปภาพเอกสาร หรือวิดีโอ) จะถูกเก็บไว้เฉพาะที่
• ข้อความเทมเพลต: องค์ประกอบที่มีเพย์โหลดข้อความ/สื่อจะถูกเก็บไว้เฉพาะที่

นอกจากนี้ ชุดแอตทริบิวต์ของเมตาดาต้าที่จำกัดจะรวมอยู่ในชุดข้อมูลที่เก็บเฉพาะที่ เพื่อเชื่อมโยงเพย์โหลดข้อความที่เก็บเฉพาะที่และมีการเข้ารหัสกับข้อความที่ประมวลผลในตอนแรกได้อย่างถูกต้อง และเพื่อตรวจสอบข้อเท็จจริงของการเก็บเฉพาะที่ เมตาดาต้าที่จัดเก็บไว้จะได้รับการปกป้องด้วยการทำให้เป็นโทเค็นและการเข้ารหัส

ฟีเจอร์พื้นที่เก็บข้อมูลเฉพาะที่ของ Cloud API มีเป้าหมายเพื่อช่วยให้ธุรกิจของคุณสามารถควบคุมตำแหน่งที่จัดเก็บข้อมูลที่มีความละเอียดอ่อนในระหว่างที่พักข้อมูลได้โดยตรงผ่านการตั้งค่า Cloud API ขณะเดียวกันก็ให้ความยืดหยุ่นในการเลือกตำแหน่งการจัดวางข้อมูลได้ทั่วโลก

ภูมิภาคที่สามารถใช้ได้

ภูมิภาคซึ่งพื้นที่เก็บข้อมูลเฉพาะที่ของ Cloud API อนุญาตให้ใช้ได้จะแสดงอยู่ในข้อกำหนดในการโฮสต์ของ Meta สำหรับ Cloud API คุณสามารถดูภูมิภาคที่ใช้งานพื้นที่เก็บข้อมูลเฉพาะที่ได้แล้วในพารามิเตอร์ data_localization_regionที่ตั้งค่าไว้ในระหว่างการลงทะเบียนหมายเลขโทรศัพท์

ข้อกำหนด

คุณสามารถเปิดหรือปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่ได้บนหมายเลขโทรศัพท์ธุรกิจเมื่ออยู่ในสถานะที่ไม่ได้ลงทะเบียนเท่านั้น

ข้อจำกัด

ไฟล์สื่อที่อัพโหลดโดยหมายเลขโทรศัพท์ที่เปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่เอาไว้จะมีเพียงหมายเลขโทรศัพท์ดังกล่าวเท่านั้นที่เข้าถึงได้ และไม่สามารถแชร์ให้กับหมายเลขโทรศัพท์อื่นที่เชื่อมโยงกับธุรกิจนั้นๆ ได้

การเปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่

ทำตามขั้นตอนต่อไปนี้เพื่อเปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่สำหรับหมายเลขโทรศัพท์ธุรกิจที่ไม่ได้ลงทะเบียนโดยใช้ API เวอร์ชั่น 21.0 ขึ้นไป หากคุณใช้ API เวอร์ชั่นที่เก่ากว่า ให้ดูที่ การเปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่ (เวอร์ชั่น 20 และเวอร์ชั่นที่เก่ากว่า)

ขั้นตอนที่ 1: เปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่บนหมายเลขโทรศัพท์

ใช้ตำแหน่งข้อมูล 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
}

ขั้นตอนที่ 2: ลงทะเบียนหมายเลขโทรศัพท์

ใช้ตำแหน่งข้อมูล POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register เพื่อลงทะเบียนหมายเลขโทรศัพท์ธุรกิจ

รูปแบบคำสั่งของคำขอ

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register

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

ตั้งค่า <TWO_STEP_PIN> เป็น 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 เพื่อรับการตั้งค่าพื้นที่เก็บข้อมูลเฉพาะที่บนหมายเลขโทรศัพท์ของ WhatsApp Business ตัวอย่างเช่น

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 เพื่อปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่บนหมายเลขโทรศัพท์ธุรกิจที่ไม่ได้ลงทะเบียนโดยใช้ API เวอร์ชั่น 21.0 ขึ้นไป หากคุณใช้ 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 และเก่ากว่า)

สำหรับการเปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่สำหรับหมายเลขโทรศัพท์ธุรกิจที่ไม่ได้ลงทะเบียนโดยใช้ API เวอร์ชั่น 20.0 หรือเก่ากว่า):

ขั้นตอน 1: ตรวจสอบสถานะการตรวจสอบยืนยัน

ใช้ตำแหน่งข้อมูล GET /<WHATSAPP_BUSINESS_PHONE_NUMBER> และส่งคำขอช่อง code_verification_status หากสถานะการตรวจสอบยืนยันรหัสเป็น VERIFIED ให้ข้ามไปที่ขั้นตอนที่ 4 หากไม่ใช่ ให้ทำตามขั้นตอนที่ 2

ขั้นตอนที่ 2: ขอรหัสยืนยัน

ใช้ตำแหน่งข้อมูล 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...'

ใช้รหัสในข้อความที่ส่งในขั้นตอนถัดไป

ขั้นตอนที่ 3: ตรวจสอบยืนยันหมายเลขโทรศัพท์ธุรกิจ

ใช้ตำแหน่งข้อมูล 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...'

ขั้นตอนที่ 4: ลงทะเบียนหมายเลขโทรศัพท์ธุรกิจอีกครั้ง

ใช้ตำแหน่งข้อมูล 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 เพื่อปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่บนหมายเลขโทรศัพท์ธุรกิจโดยใช้ API เวอร์ชั่น 20.0 หรือเก่ากว่า

ตัวอย่างเช่น

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

โปรดทราบว่าการดำเนินการนี้จะเป็นการยกเลิกการลงทะเบียนหมายเลขโทรศัพท์ธุรกิจ ดังนั้นจึงไม่สามารถใช้ร่วมกับ Cloud API ของ WhatsApp ได้ หากคุณต้องการใช้ร่วมกับ Cloud API ต่อไป แต่ไม่ได้เปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่ คุณจะต้องลงทะเบียนใหม่โดยไม่ระบุพารามิเตอร์ data_localization_region

คำถามที่พบบ่อย

คำถาม จะใช้เส้นทางการย้ายใดสำหรับการย้ายหมายเลขโทรศัพท์ไปยัง Cloud API เวอร์ชั่นที่มีพื้นที่เก็บข้อมูลเฉพาะที่

เรารองรับทุกเส้นทางการย้ายไปยัง Cloud API เวอร์ชั่นที่มีพื้นที่เก็บข้อมูลเฉพาะที่ ซึ่งรวมถึง:

• หมายเลข On-Premise API ที่มีอยู่ซึ่งย้ายไปยัง Cloud API เวอร์ชั่นที่มีพื้นที่เก็บข้อมูลเฉพาะที่
• หมายเลข Cloud API ที่มีอยู่ซึ่งย้ายไปยัง Cloud API เวอร์ชั่นที่มีพื้นที่เก็บข้อมูลเฉพาะที่
• หมายเลข Cloud API ใหม่ที่เปิดใช้งานพื้นที่เก็บข้อมูลเฉพาะที่

ในสถานการณ์ทั้งหมดนี้ คุณจะต้องส่งคำขอ POST ไปยังตำแหน่งข้อมูล /register สำหรับหมายเลขโทรศัพท์ที่เลือก โดยระบุประเทศเป้าหมายที่จะเก็บข้อมูลเฉพาะที่ในพารามิเตอร์ใหม่ data_localization_region

คำถาม มีความเสี่ยงในการย้ายหรือไม่ มีเวลาหยุดทำงานที่เกี่ยวข้องกับการย้ายหรือไม่

ไม่มีความเสี่ยงในการย้าย ขั้นตอนนี้คล้ายคลึงกับการย้ายจาก On-Premise API ไปยัง Cloud API โปรดดูเอกสารประกอบสำหรับผู้พัฒนาที่นี่ โดยปกติแล้ว เวลาหยุดทำงานมักจะไม่เกิน 5 นาที และไม่จำเป็นต้องตรวจสอบยืนยันหมายเลขโทรศัพท์ธุรกิจอีกครั้ง