การสำรองและการกู้คืนข้อมูล

/v1/settings/backup และ /v1/settings/restore

ใช้ตำแหน่งข้อมูล /v1/settings/backup และ /v1/settings/restore เพื่อช่วยให้ง่ายยิ่งขึ้นในการย้ายไปยังสภาพแวดล้อมหรือเซิร์ฟเวอร์อื่นและการกู้คืนกลับสู่สภาวะการทำงานที่รู้จัก เราขอแนะนำให้คุณสำรองข้อมูลเป็นครั้งคราว เพื่อที่ว่าหากไคลเอ็นต์ WhatsApp Business API หรือเซิร์ฟเวอร์เกิดขัดข้อง คุณจะได้กู้คืนกลับมาใช้งานตามเดิมได้โดยง่าย

ไคลเอ็นต์ WhatsApp Business API รองรับการสำรองและกู้คืนข้อมูลที่จำเป็นทั้งหมด ซึ่งรวมถึงการตั้งค่าและการลงทะเบียนแอพ

การอัพเดตด้านการรักษาความปลอดภัย

WhatsApp ได้แก้ไขตำแหน่งข้อมูลสำหรับการสำรองข้อมูลและการกู้คืนใน v2.31.4 เพื่อให้สอดคล้องกับรูปแบบการรักษาความปลอดภัยของฟังก์ชั่นการทำงานในการสำรองและกู้คืนข้อมูลของไคลเอ็นต์ WhatsApp อื่นๆ (กล่าวคือ แอพบนโทรศัพท์) จากการเปลี่ยนแปลงดังกล่าวนี้ ระบบจะสร้างรหัสความปลอดภัยระหว่างบัญชี WhatsApp Business กับผู้ติดต่อของบัญชีขึ้นมาใหม่หลังจากที่ดำเนินการกู้คืนสำเร็จแล้ว

เมื่อบัญชี WhatsApp Business ทำการกู้คืนจากข้อมูลสำรองเรียบร้อยแล้ว ไคลเอ็นต์ผู้รับจะได้รับข้อความแจ้งว่า “เปลี่ยนรหัสความปลอดภัยของ {Business Account} แล้ว แตะเพื่อเรียนรู้เพิ่มเติม” หากผู้ใช้เปิดใช้งานการตั้งค่า “การแจ้งเตือนการรักษาความปลอดภัย” ไว้ ส่วนลักษณะการทำงานอื่นๆ ทั้งหมดในการสำรอง/กู้คืนข้อมูลจะยังคงเหมือนเดิม

ก่อนที่จะเริ่ม

คุณต้องใช้บัญชี admin เพื่อเข้าถึงการตั้งค่าการสำรองและการกู้คืนข้อมูล

การสำรองข้อมูล

ความสามารถในการสำรองข้อมูล/การส่งออกจะทำงานหลังจากที่ลงทะเบียนไคลเอ็นต์ WhatsApp Business API แล้ว และใช้งานอยู่เท่านั้น การสำรองข้อมูลจะไม่สำรองข้อความหรือการโทรกลับ และไม่สามารถถ่ายภาพหน้าจอด้วยเครื่องเสมือนและกู้คืนข้อมูลดังกล่าว

ตัวอย่าง

เมื่อจะสำรองข้อมูล ให้ใช้ตำแหน่งข้อมูล /v1/settings/backup ที่มีช่อง password

POST /v1/settings/backup
{
    "password": "PASSWORD"
}

{
    "settings": {
       "data": "ENCRYPTED_BACKUP_DATA"
    }
}

พารามิเตอร์

พารามิเตอร์คำขอ:

พารามิเตอร์การตอบกลับ

การกู้คืนข้อมูล

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

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

เมื่อกู้คืนการตั้งค่าการเชื่อมต่อหลายจุด คุณจำเป็นต้องดำเนินการกู้คืนซ้อนทับการตั้งค่าประเภทเดียวกันกับที่คุณจะกู้คืน ตัวอย่างเช่น หากคุณสำรองข้อมูลการตั้งค่าที่มีการแบ่งข้อมูลสองส่วนที่ทำงาน คุณต้องมีการแบ่งข้อมูลสองส่วนที่ทำงานสำหรับการกู้คืน

ตัวอย่าง

เมื่อจะกู้คืนการตั้งค่า ให้ใช้ตำแหน่งข้อมูล /v1/settings/restore ที่มีช่อง password และ data

POST /v1/settings/restore
{
    "password": "your-password",
    "data": "your-encrypted-backup-data"
}

หลังนำเข้าเสร็จแล้ว ไคลเอ็นต์ WhatsApp Business API จะปิดการทำงาน แต่ในการใช้งานบางกรณี (เช่น AWS) แอพพลิเคชั่นจะเริ่มใหม่โดยอัตโนมัติ มิฉะนั้น คุณจำเป็นต้องเริ่มบริการใหม่โดยใช้คำสั่ง docker restart

คำขอที่สำเร็จจะส่งคืนรหัสสถานะ HTTP 200 OK และ null หรือ {} หากคุณพบข้อผิดพลาด โปรดดูที่ข้อความแสดงข้อผิดพลาดและสถานะ

พารามิเตอร์