Sao lưu và khôi phục

/v1/settings/backup và /v1/settings/restore

Hãy sử dụng các điểm cuối /v1/settings/backup và /v1/settings/restore để chuyển sang môi trường/máy chủ khác và khôi phục về trạng thái hoạt động đã biết một cách dễ dàng hơn. Thỉnh thoảng, bạn nên sao lưu để trong trường hợp ứng dụng API WhatsApp Business hoặc máy chủ ngừng hoạt động, bạn có thể dễ dàng khôi phục.

Ứng dụng API WhatsApp Business hỗ trợ sao lưu và khôi phục mọi thông tin cần thiết, bao gồm cả dữ liệu đăng ký và cài đặt ứng dụng.

Cập nhật bảo mật

Trong v2.31.4, WhatsApp đã khắc phục các điểm cuối sao lưu và khôi phục để nhất quán với mô hình bảo mật của chức năng sao lưu và khôi phục trong các ứng dụng WhatsApp khác (ví dụ: ứng dụng điện thoại). Với thay đổi này, hệ thống sẽ tạo một mã bảo mật mới giữa tài khoản WhatsApp Business và những người liên hệ của tài khoản này sau khi khôi phục thành công.

Sau khi tài khoản WhatsApp Business khôi phục từ bản sao lưu, ứng dụng dành cho người tiêu dùng sẽ nhận được thông báo "Mã bảo mật của bạn dùng cho {Business Account} đã thay đổi. Hãy nhấn để tìm hiểu thêm." nếu đã bật cài đặt "thông báo bảo mật". Mọi hoạt động sao lưu/khôi phục khác vẫn giống như trước.

Trước khi bạn bắt đầu

Bạn phải sử dụng tài khoản admin để truy cập phần cài đặt sao lưu và khôi phục.

Sao lưu

Tính năng sao lưu/xuất chỉ hoạt động sau khi Ứng dụng API WhatsApp Business được đăng ký và đang chạy. Tính năng sao lưu sẽ không sao lưu tin nhắn hoặc lệnh gọi lại. Tính năng chụp và khôi phục ảnh chụp nhanh của máy ảo sẽ không hoạt động.

Ví dụ

Để sao lưu, hãy dùng điểm cuối /v1/settings/backup với trường password.

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

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

Thông số

Thông số yêu cầu:

Thông số phản hồi:

Khôi phục

Bạn có thể dùng tính năng khôi phục để thiết lập phiên bản mới của Ứng dụng API WhatsApp Business trên máy mới hoặc khôi phục ứng dụng về trạng thái hoạt động đã biết trên chính máy đó bằng thông tin mã hóa và các cài đặt giống như lần thiết lập trước đó.

Để thiết lập ứng dụng trên một máy mới, Coreapp phải đang chạy nhưng chưa được đăng ký. Sau khi nhập thành công, Coreapp sẽ tự động khởi chạy và bắt đầu phân phối yêu cầu. Nếu máy có sẵn một ứng dụng và bạn tiến hành khôi phục, ứng dụng đó sẽ bị dừng và bạn sẽ phải khởi động lại bằng lệnh docker restart.

Khi khôi phục thiết lập đa kết nối, bạn cần tiến hành khôi phục thêm cả loại thiết lập mà bạn đang khôi phục. Ví dụ: Nếu sao lưu một dữ liệu thiết lập với 2 đoạn đang chạy, bạn sẽ phải chạy 2 đoạn cho quy trình khôi phục.

Ví dụ

Để khôi phục các cài đặt, hãy sử dụng điểm cuối /v1/settings/restore với trường password và data.

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

Ứng dụng API WhatsApp Business sẽ tắt sau khi nhập. Trong một số quá trình triển khai (chẳng hạn như AWS), ứng dụng sẽ tự động khởi động lại. Nếu không, bạn sẽ phải khởi động lại dịch vụ bằng lệnh docker restart.

Nếu thành công, hệ thống sẽ trả về Mã trạng thái HTTP 200 OK và null hoặc {}. Nếu bạn gặp bất kỳ lỗi nào, hãy xem phần Thông báo lỗi và trạng thái.

Thông số