기존에 데이터베이스로 WhatsApp Business API 클라이언트가 설정되어 있고 같은 전화번호를 사용하여 클라이언트와 데이터베이스를 새로운 설정으로 마이그레이션하고자 하는 경우, 이 문서에서 변경 사항과 필요한 작업을 확인할 수 있습니다.
마이그레이션하고자 하는 데이터양에 따라 여러 가지 마이그레이션 옵션이 있습니다. 요구 사항에 가장 적합한 옵션을 선택하세요.
옵션 1 | 옵션 2 | 옵션 3 | |
---|---|---|---|
설정 | |||
앱 설정 | ✔ | ✔ | ✔ |
등록 | ✔ | ✔ | ✔ |
암호화 키 | ✔ | ✔ | ✔ |
메시지 | |||
메시지 | ✔ | ✔ | |
콜백 | ✔ | ✔ | |
연락처 | ✔ | ✔ | |
인증 토큰 | |||
API 사용자 데이터 | ✔ | ||
API 인증 토큰 | ✔ |
이 표에서는 각 마이그레이션 옵션의 일반 사용 사례 및 관련 가동 중단 시간을 설명합니다. 이는 일반 사용 사례일 뿐이며, 필요에 따라 마이그레이션 옵션을 선택할 수 있습니다.
일반 사용 사례 | 가동 중단 시간 | |
---|---|---|
옵션 1 | 엔드 클라이언트를 플랫폼으로 옮기고 싶어 하는 솔루션 제공업체이고 설정 데이터만 유지하고자 하는 경우 | 이 옵션은 기기 간 전송에 필요한 데이터양이 가장 적기 때문에 다른 옵션에 비해 가동 중단 시간이 가장 적습니다. |
옵션 2 | 엔드 클라이언트를 플랫폼으로 옮기고 싶어 하는 솔루션 제공업체이고 설정 및 메시지 데이터를 유지하고자 하는 경우 | 이 옵션은 기기 간에 메시지와 설정 데이터를 모두 전송해야 하므로 옵션 1에 비해 가동 중단 시간이 더 깁니다. 이 데이터는 비즈니스에 따라 용량이 상당히 클 수도 있습니다. |
옵션 3 | WhatsApp Business API 클라이언트를 관리하는 WhatsApp의 직접 클라이언트이고 WhatsApp Business API 클라이언트와 데이터를 다른 기기로 이동하는 경우 | 이 옵션은 기기 간에 클라이언트 데이터를 모두 전송해야 하므로 다른 옵션에 비해 가동 중단 시간이 가장 깁니다. 이 데이터는 비즈니스에 따라 용량이 상당히 클 수도 있습니다. |
설정만 마이그레이션인 경우 설정 정보만 백업 및 복원됩니다. 메시지와 인증 토큰 정보는 마이그레이션되지 않습니다.
설치 문서를 사용하여 새로운 WhatsApp Business API 클라이언트를 설정합니다.
기존의 인증 토큰은 새로운 환경에서 유효하지 않습니다. 새로운 설정에 로그인하여 새 인증 토큰을 받습니다.
기존 인증 토큰을 사용하여 현재 WhatsApp Business API 클라이언트에서 설정 데이터를 백업합니다.
이 경우 메시지 전송이 중단됩니다. 메시지 전송 중단을 최소화하려면 새로운 위치에서 WhatsApp Business API 클라이언트를 실행할 준비를 합니다. 자세한 내용은 각 설치 가이드의 제거 섹션을 참조하세요. Coreapp, Webapp 및 Master의 Docker 컨테이너가 포함된 WhatsApp Business API 클라이언트만 제거하고 데이터베이스는 삭제하지 마세요.
아직 새로운 인증 토큰을 사용하지 않고 있다면 로그인해서 새로운 설정을 복원합니다.
모든 필수 정보를 포함한 새로운 WhatsApp Business API 클라이언트가 실행되고 메시지를 전송할 준비를 마쳐야 합니다. 가장 중요한 점은 설정을 적절히 백업하고 복원했다면 WhatsApp 계정을 다시 등록할 필요가 없다는 것입니다.
상태 점검을 수행하여 WhatsApp Business API 클라이언트가 작동하는지 확인할 테스트 메시지를 보냅니다.
3단계에서 2단계 인증을 비활성화했다면 지금 2단계 인증을 다시 활성화합니다. 이를 통해 WhatsApp 계정에 추가적인 보안을 제공할 수 있습니다.
Webhooks를 설정하여 인바운드 알림을 활성화합니다.
이전 데이터베이스에는 이전의 설정, 이전 메시지, 이전 인증 토큰에 대한 데이터가 포함되어 있습니다. 향후 이 데이터를 복구하고 싶다면 이전 데이터베이스를 삭제하지 마세요. 데이터베이스를 삭제하기로 결정했다면 WhatsApp Business API 클라이언트를 14일 이상 실행하고 메시지가 잘 전송되는지 확인한 후에 삭제하세요.
설정과 메시지 마이그레이션인 경우 설정 정보와 메시지가 모두 백업 및 복원됩니다. 인증 토큰 정보는 마이그레이션되지 않습니다.
다른 기기로 전송해야 하는 데이터양에 유의하세요. 더 많은 데이터를 백업하고 복원해야 하므로 옵션 1보다 가동 중단 시간이 상대적으로 더 깁니다. 전송되는 데이터양과 네트워크 지연에 따라 총 가동 중단 시간이 달라집니다.
이 경우 메시지 전송이 중단됩니다. 메시지 전송 중단을 최소화하려면 새로운 위치에서 WhatsApp Business API 클라이언트를 실행할 준비를 합니다. 자세한 내용은 각 설치 가이드의 제거 섹션을 참조하세요. WhatsApp Business API 클라이언트만 제거하고 데이터베이스는 삭제하지 마세요.
기존 WhatsApp Business API 클라이언트에서 사용자/인증 데이터가 포함된 waweb
을 제외한 모든 데이터베이스를 mysqldump
나 pg_dump
등의 유틸리티를 사용하여 백업합니다.
참고: 비즈니스를 플랫폼으로 마이그레이션하거나 플랫폼에서 마이그레이션하는 솔루션 제공업체인 경우 waweb
을 제외하는 것이 중요합니다. 현재 저장된 인증 토큰과 사용자 정보를 이월하거나 넘기고 싶지 않을 수 있습니다.
mysqldump
나 pg_dump
와 같은 유틸리티를 사용하여 새로운 WhatsApp Business API 클라이언트로 데이터베이스를 복원합니다.
설치 문서를 사용하여 새로운 WhatsApp Business API 클라이언트를 설정합니다. 4단계에서 복원한 위치로 데이터베이스의 위치를 지정하세요.
기존의 인증 토큰은 새로운 환경에서 유효하지 않습니다. 새로운 설정에 로그인하여 새 인증 토큰을 받습니다.
모든 필수 정보를 포함한 새로운 WhatsApp Business API 클라이언트가 실행되고 메시지를 전송할 준비를 마쳐야 합니다. 가장 중요한 점은 데이터베이스를 적절히 백업하고 복원했다면 WhatsApp 계정을 다시 등록할 필요가 없다는 것입니다.
상태 점검을 수행하여 WhatsApp Business API 클라이언트가 작동하는지 확인할 테스트 메시지를 보냅니다.
1단계에서 2단계 인증을 비활성화했다면 지금 2단계 인증을 다시 활성화합니다. 이를 통해 WhatsApp 계정에 추가적인 보안을 제공할 수 있습니다.
Webhooks를 설정하여 인바운드 알림을 활성화합니다.
이전 데이터베이스에는 이전의 설정, 이전 메시지, 이전 인증 토큰에 대한 데이터가 포함되어 있습니다. 향후 이 데이터를 복구하고 싶다면 이전 데이터베이스를 삭제하지 마세요. 데이터베이스를 삭제하기로 결정했다면 WhatsApp Business API 클라이언트를 14일 이상 실행하고 메시지가 잘 전송되는지 확인한 후에 삭제하세요.
전체 마이그레이션인 경우 모든 설정, 메시지 및 인증 토큰을 백업하고 복원합니다.
이 옵션이 가장 좋은 것 같지만, 다른 기기로 전송해야 하는 데이터양에 유의하세요. 더 많은 데이터를 백업하고 복원해야 하므로 이 옵션은 옵션 1과 옵션 2보다 가동 중단 시간이 상대적으로 더 깁니다.
토큰의 최대 유효 기간은 7일입니다. 토큰의 유효 기간이 마이그레이션하기에 충분한지 확인하세요.
이 경우 메시지 전송이 중단됩니다. 메시지 전송 중단을 최소화하려면 새로운 위치에서 WhatsApp Business API 클라이언트를 실행할 준비를 합니다. 자세한 내용은 각 설치 가이드의 제거 섹션을 참조하세요. WhatsApp Business API 클라이언트만 제거하고 데이터베이스는 삭제하지 마세요.
mysqldump
나 pg_dump
와 같은 유틸리티를 사용하여 데이터베이스를 백업하고 설정, 메시지 및 인증 토큰 데이터를 캡처합니다.
참고: 데이터베이스를 제외하고 WhatsApp Business API 클라이언트만 마이그레이션하는 경우 이 단계는 선택 사항입니다.
mysqldump
나 pg_dump
와 같은 유틸리티를 사용하여 새로운 WhatsApp Business API 클라이언트로 데이터베이스를 복원합니다.
설치 문서를 사용하여 새로운 WhatsApp Business API 클라이언트를 설정합니다. 5단계에서 복원한 위치로 데이터베이스의 위치를 지정하세요.
모든 필수 정보를 포함한 새로운 WhatsApp Business API 클라이언트가 실행되고 메시지를 전송할 준비를 마쳐야 합니다. 가장 중요한 점은 데이터를 적절히 백업하고 복원했다면 WhatsApp 계정을 다시 등록할 필요가 없다는 것입니다.
상태 점검을 수행하여 WhatsApp Business API 클라이언트가 작동하는지 확인할 테스트 메시지를 보냅니다.
1단계에서 2단계 인증을 비활성화했다면 지금 2단계 인증을 다시 활성화합니다. 이를 통해 WhatsApp 계정에 추가적인 보안을 제공할 수 있습니다.
Webhooks를 설정하여 인바운드 알림을 활성화합니다.
이전 데이터베이스에는 이전의 설정, 이전 메시지, 이전 인증 토큰에 대한 데이터가 포함되어 있습니다. 향후 이 데이터를 복구하고 싶다면 이전 데이터베이스를 삭제하지 마세요. 데이터베이스를 삭제하기로 결정했다면 WhatsApp Business API 클라이언트를 14일 이상 실행하고 메시지가 잘 전송되는지 확인한 후에 삭제하세요.