Chuyển

Nếu đã thiết lập ứng dụng API WhatsApp Business với một cơ sở dữ liệu và muốn chuyển cả ứng dụng và cơ sở dữ liệu sang bản thiết lập mới sử dụng cùng một số điện thoại, bạn có thể tham khảo tài liệu sau để xác định các thay đổi cần thực hiện và những gì cần làm.

Trước khi bắt đầu

• Bước quan trọng nhất trong quá trình chuyển là sao lưu.
• Sau khi chuyển, bạn không phải đăng ký lại số điện thoại. Bạn có thể bắt đầu nhắn tin ngay khi quá trình chuyển hoàn tất.
• Bản thiết lập mới phải có số đoạn giống với bản thiết lập cũ. Bạn không thể tăng/giảm số đoạn trong khi chuyển. Nếu bản thiết lập cũ được cấu hình với số Master là X và số Coreapp là Y, bản thiết lập mới phải có đúng số Master và số Coreapp như vậy. Nếu số Master và Coreapp trước và sau khi chuyển không giống nhau, quá trình chuyển sẽ không thành công.
• Hãy thử chuyển tài khoản thử nghiệm trước khi chuyển tài khoản chính thức.
• Thời gian ngừng hoạt động sẽ xảy ra. Khoảng thời gian này phụ thuộc vào tùy chọn chuyển, nhưng mọi quá trình chuyển đều gặp vấn đề này.

Tùy chọn chuyển

Bạn có thể sử dụng một số tùy chọn chuyển, tùy theo lượng dữ liệu bạn muốn chuyển. Vui lòng chọn lựa chọn phù hợp nhất với nhu cầu của bạn.

• Tùy chọn 1: Chỉ chuyển phần Cài đặt
• Tùy chọn 2: Các cài đặt và tin nhắn
• Tùy chọn 3: Chuyển toàn bộ

Dữ liệu được lưu giữ cho từng tùy chọn chuyển

Trường hợp sử dụng điển hình và thời gian ngừng hoạt động của mỗi tùy chọn chuyển

Bảng này mô tả các trường hợp sử dụng điển hình của mỗi lựa chọn chuyển và thời gian ngừng hoạt động liên quan. Đây chỉ là các trường hợp sử dụng điển hình, bạn có thể chọn loại chuyển theo nhu cầu của mình.

Tùy chọn 1: Chỉ tùy chọn cài đặt

Đối với tùy chọn chuyển Chỉ phần Cài đặt, chỉ thông tin cài đặt được sao lưu và khôi phục. Tin nhắn và thông tin mã xác thực không được chuyển.

Bước 1: Cài đặt bản thiết lập mới

Thiết lập ứng dụng API WhatsApp Business mới bằng cách sử dụng Tài liệu hướng dẫn cài đặt.

Bước 2: Lấy mã xác thực cho bản thiết lập mới

Mã xác thực hiện tại sẽ không hợp lệ trong môi trường mới. Đăng nhập vào bản thiết lập mới để lấy mã xác thực mới.

Bước 3: Xóa

• [Không bắt buộc] Tắt tính năng xác thực 2 yếu tố. Tùy chọn này hữu ích khi bạn quên mã xác thực 2 yếu tố và cần đăng ký lại. Mặc dù không nhất thiết phải đăng ký lại thì quá trình chuyển mới diễn ra suôn sẻ, nhưng bạn có thể buộc phải đăng ký lại nếu quá trình sao lưu và khôi phục không thành công vì một lý do không xác định nào đó. Hãy làm theo hướng dẫn để tắt mã xác thực 2 yếu tố.
  Lưu ý: Nếu tin rằng mã xác thực 2 yếu tố là chính xác, bạn không cần thực hiện bước này.
• [Không bắt buộc] Đặt lại Webhooks bất kỳ. Nếu bạn thiết lập Webhooks để nhận thông báo đến và hiện cũng thay đổi máy chủ Webhook trong quá trình chuyển, hãy tắt máy chủ Webhook cũ trong phần Cài đặt ứng dụng.
  Lưu ý: Bước này không bắt buộc nếu hiện bạn không thay đổi máy chủ Webhook sau khi chuyển.

Bước 4: Sao lưu các cài đặt từ bản thiết lập hiện tại

Sử dụng mã xác thực hiện tại để sao lưu dữ liệu cài đặt từ ứng dụng API WhatsApp Business.

Bước 5: Gỡ cài đặt bản thiết lập hiện tại

Thao tác này sẽ khiến tính năng nhắn tin ngừng hoạt động. Để giảm thiểu tình trạng này, hãy đảm bảo ứng dụng API WhatsApp Business sẵn sàng chạy ở vị trí mới. Hãy tham khảo phần Gỡ cài đặt trong Hướng dẫn cài đặt tương ứng để biết hướng dẫn. Đảm bảo hiện bạn chỉ gỡ cài đặt ứng dụng API WhatsApp Business, bao gồm vùng chứa Docker của Coreapp, Webapp và Master; không xóa cơ sở dữ liệu.

Bước 6: Khôi phục các cài đặt trong bản thiết lập mới

Đăng nhập nếu bạn chưa sử dụng mã xác thực mới, sau đó thực hiện khôi phục trên bản thiết lập mới.
Ứng dụng API WhatsApp Business mới phải đang chạy với tất cả thông tin bắt buộc và sẵn sàng nhắn tin. Điều quan trọng nhất bạn cần nhớ là nếu các cài đặt được sao lưu và khôi phục đúng cách, bạn không phải đăng ký lại tài khoản WhatsApp.

Bước 7: Kiểm tra sự cố

Tiến hành kiểm tra sự cố rồi gửi tin nhắn thử nghiệm để xác minh ứng dụng API WhatsApp Business đang hoạt động.

Bước 8: [Không bắt buộc] Bật tính năng xác minh 2 yếu tố

Nếu bạn đã tắt tính năng xác minh 2 yếu tố ở Bước 3 thì bây giờ hãy bật lại. Tính năng này giúp tăng cường bảo mật cho tài khoản WhatsApp của bạn.

Bước 9: Thiết lập Webhooks

Thiết lập Webhooks để bật thông báo đến.

Bước 10: Xóa cơ sở dữ liệu cũ

Cơ sở dữ liệu cũ của bạn chứa dữ liệu cài đặt, tin nhắn và mã xác thực cũ. Nếu trong tương lai bạn muốn khôi phục bất kỳ dữ liệu nào trong số này, không xóa cơ sở dữ liệu cũ. Khi quyết định xóa cơ sở dữ liệu cũ, hãy đảm bảo ứng dụng API WhatsApp Business đã chạy được tối thiểu 14 ngày và tính năng nhắn tin hoạt động bình thường trước khi xóa.

Lựa chọn 2: Tùy chọn cài đặt và tin nhắn

Đối với tùy chọn chuyển phần Cài đặt và Tin nhắn, cả thông tin cài đặt và tin nhắn được sao lưu và khôi phục. Thông tin mã xác thực không được chuyển.

Hãy thận trọng với lượng dữ liệu cần được chuyển sang máy khác. Vì có nhiều dữ liệu hơn cần được sao lưu và khôi phục nên thời gian ngừng hoạt động tương đối lâu hơn so với Lựa chọn 1. Tổng thời gian ngừng hoạt động sẽ khác nhau tùy theo lượng dữ liệu được chuyển và thời gian trễ của mạng.

Bước 1: Xóa

• [Không bắt buộc] Tắt tính năng xác thực 2 yếu tố. Tùy chọn này hữu ích khi bạn quên mã xác thực 2 yếu tố và cần đăng ký lại. Mặc dù không nhất thiết phải đăng ký lại thì quá trình chuyển mới diễn ra suôn sẻ, nhưng bạn có thể buộc phải đăng ký lại nếu quá trình sao lưu và khôi phục không thành công vì một lý do không xác định nào đó. Hãy làm theo hướng dẫn để tắt mã xác thực 2 yếu tố.
  Lưu ý: Nếu tin rằng mã xác thực 2 yếu tố là chính xác, bạn không cần thực hiện bước này.
• [Không bắt buộc] Đặt lại Webhooks bất kỳ. Nếu bạn thiết lập Webhooks để nhận thông báo đến và hiện cũng thay đổi máy chủ Webhook trong quá trình chuyển, hãy tắt máy chủ Webhook cũ trong phần Cài đặt ứng dụng. Đây là bước đầu tiên cần thực hiện trong trường hợp tính năng nhắn tin bắt đầu ngừng hoạt động.
  Lưu ý: Bước này không bắt buộc nếu hiện bạn không thay đổi máy chủ Webhook sau khi chuyển.

Bước 2: Gỡ cài đặt bản thiết lập hiện tại

Thao tác này sẽ khiến tính năng nhắn tin ngừng hoạt động. Để giảm thiểu tình trạng này, hãy đảm bảo ứng dụng API WhatsApp Business sẵn sàng chạy ở vị trí mới. Hãy tham khảo phần Gỡ cài đặt trong Hướng dẫn cài đặt tương ứng để biết hướng dẫn. Đảm bảo hiện bạn chỉ gỡ cài đặt ứng dụng API WhatsApp Business; không xóa cơ sở dữ liệu.

Bước 3: Sao lưu cơ sở dữ liệu

Sử dụng tiện ích, chẳng hạn như mysqldump hoặc pg_dump, để sao lưu tất cả cơ sở dữ liệu, ngoại trừ waweb (chứa dữ liệu người dùng/dữ liệu xác thực) từ ứng dụng API WhatsApp Business hiện tại.
Lưu ý: Nếu là nhà cung cấp giải pháp và thực hiện chuyển doanh nghiệp sang hoặc từ nền tảng của bạn, bạn phải loại trừ waweb. Bạn không nên chuyển hoặc giao thông tin người dùng và mã xác thực hiện được lưu trữ.

Bước 4: Khôi phục cơ sở dữ liệu

Sử dụng tiện ích, chẳng hạn như mysqldump hoặc pg_dump, để khôi phục cơ sở dữ liệu sang ứng dụng API WhatsApp Business mới.

Bước 5: Cài đặt bản thiết lập mới

Thiết lập ứng dụng API WhatsApp Business mới bằng cách sử dụng Tài liệu hướng dẫn cài đặt. Đảm bảo trỏ cơ sở dữ liệu của bạn đến vị trí khôi phục ở Bước 4.

Bước 6: Lấy mã xác thực cho bản thiết lập mới

Mã xác thực hiện tại sẽ không hợp lệ trong môi trường mới. Đăng nhập vào bản thiết lập mới để lấy mã xác thực mới.
Ứng dụng API WhatsApp Business mới phải đang chạy với tất cả thông tin bắt buộc và sẵn sàng nhắn tin. Điều quan trọng nhất bạn cần nhớ là nếu cơ sở dữ liệu được sao lưu và khôi phục đúng cách, bạn không phải đăng ký lại tài khoản WhatsApp.

Bước 7: Kiểm tra sự cố

Tiến hành kiểm tra sự cố rồi gửi tin nhắn thử nghiệm để xác minh ứng dụng API WhatsApp Business đang hoạt động.

Bước 8: [Không bắt buộc] Bật tính năng xác minh 2 yếu tố

Nếu bạn đã tắt tính năng xác minh 2 yếu tố ở Bước 1 thì bây giờ hãy bật lại. Tính năng này giúp tăng cường bảo mật cho tài khoản WhatsApp của bạn.

Bước 9: Thiết lập Webhooks

Thiết lập Webhooks để bật thông báo đến.

Bước 10: Xóa cơ sở dữ liệu cũ

Cơ sở dữ liệu cũ của bạn chứa dữ liệu cài đặt, tin nhắn và mã xác thực cũ. Nếu trong tương lai bạn muốn khôi phục bất kỳ dữ liệu nào trong số dữ liệu này, không xóa cơ sở dữ liệu cũ. Khi quyết định xóa cơ sở dữ liệu cũ, hãy đảm bảo Ứng dụng API WhatsApp Business đã chạy được tối thiểu 14 ngày và tính năng nhắn tin hoạt động bình thường trước khi xóa.

Lựa chọn 3: Chuyển toàn bộ

Ở tùy chọn Chuyển toàn bộ, tất cả dữ liệu cài đặt, tin nhắn và mã xác thực đều được sao lưu và khôi phục.

Lựa chọn này có vẻ hiệu quả nhất nhưng hãy thận trọng với lượng dữ liệu cần được chuyển sang máy khác. Vì có nhiều dữ liệu hơn cần được sao lưu và khôi phục nên lựa chọn này có thời gian ngừng hoạt động tương đối lâu hơn so với cả Lựa chọn 1 và Lựa chọn 2.

Bước 1: Xóa

• [Không bắt buộc] Tắt tính năng xác thực 2 yếu tố. Tùy chọn này hữu ích khi bạn quên mã xác thực 2 yếu tố và cần đăng ký lại. Mặc dù không nhất thiết phải đăng ký lại thì quá trình chuyển mới diễn ra suôn sẻ, nhưng bạn có thể buộc phải đăng ký lại nếu quá trình sao lưu và khôi phục không thành công vì một lý do không xác định nào đó. Hãy làm theo hướng dẫn để tắt mã xác thực 2 yếu tố.
  Lưu ý: Nếu tin rằng mã xác thực 2 yếu tố là chính xác, bạn không cần thực hiện bước này.

Bước 2: Sao lưu mã xác thực hiện tại của bạn

Mã có hiệu lực trong tối đa 7 ngày. Vui lòng đảm bảo rằng thời gian hiệu lực của mã đủ để bạn thực hiện chuyển.

Bước 3: Gỡ cài đặt bản thiết lập hiện tại

Thao tác này sẽ khiến tính năng nhắn tin ngừng hoạt động. Để giảm thiểu tình trạng này, hãy đảm bảo ứng dụng API WhatsApp Business sẵn sàng chạy ở vị trí mới. Hãy tham khảo phần Gỡ cài đặt trong Hướng dẫn cài đặt tương ứng để biết hướng dẫn. Đảm bảo hiện bạn chỉ gỡ cài đặt ứng dụng API WhatsApp Business; không xóa cơ sở dữ liệu.

Bước 4: [Không bắt buộc] Sao lưu cơ sở dữ liệu

Sao lưu cơ sở dữ liệu bằng một tiện ích như mysqldump hoặc pg_dump để thu thập dữ liệu cài đặt, tin nhắn và mã xác thực.
Lưu ý: Bước này không bắt buộc nếu hiện bạn chỉ chuyển ứng dụng API WhatsApp Business chứ không chuyển cơ sở dữ liệu.

Bước 5: Khôi phục cơ sở dữ liệu

Sử dụng tiện ích, chẳng hạn như mysqldump hoặc pg_dump, để khôi phục cơ sở dữ liệu sang ứng dụng API WhatsApp Business mới.

Bước 6: Cài đặt bản thiết lập mới

Thiết lập ứng dụng API WhatsApp Business mới bằng cách sử dụng Tài liệu hướng dẫn cài đặt. Đảm bảo trỏ cơ sở dữ liệu của bạn đến vị trí khôi phục ở Bước 5.
Ứng dụng API WhatsApp Business mới phải đang chạy với tất cả thông tin bắt buộc và sẵn sàng nhắn tin. Điều quan trọng nhất bạn cần nhớ là nếu dữ liệu được sao lưu và khôi phục đúng cách, bạn không phải đăng ký lại tài khoản WhatsApp.

Bước 7: Kiểm tra sự cố

Tiến hành kiểm tra sự cố rồi gửi tin nhắn thử nghiệm để xác minh ứng dụng API WhatsApp Business đang hoạt động.

Bước 8: [Không bắt buộc] Bật tính năng xác minh 2 yếu tố

Nếu bạn đã tắt tính năng xác minh 2 yếu tố ở Bước 1 thì bây giờ hãy bật lại. Tính năng này giúp tăng cường bảo mật cho tài khoản WhatsApp của bạn.

Bước 9: Thiết lập Webhooks

Thiết lập Webhooks để bật thông báo đến.

Bước 10: Xóa cơ sở dữ liệu cũ

Cơ sở dữ liệu cũ của bạn chứa dữ liệu cài đặt, tin nhắn và mã xác thực cũ. Nếu trong tương lai bạn muốn khôi phục bất kỳ dữ liệu nào trong số dữ liệu này, không xóa cơ sở dữ liệu cũ. Khi quyết định xóa cơ sở dữ liệu cũ, hãy đảm bảo Ứng dụng API WhatsApp Business đã chạy được tối thiểu 14 ngày và tính năng nhắn tin hoạt động bình thường trước khi xóa.