마이그레이션

기존에 데이터베이스로 WhatsApp Business API 클라이언트가 설정되어 있고 같은 전화번호를 사용하여 클라이언트와 데이터베이스를 새로운 설정으로 마이그레이션하고자 하는 경우, 이 문서에서 변경 사항과 필요한 작업을 확인할 수 있습니다.

시작하기 전에

  • 백업은 마이그레이션에서 가장 중요한 설정입니다.
  • 마이그레이션 후에는 전화번호를 다시 등록할 필요가 없습니다. 마이그레이션이 완료되는 즉시 메시지 전송을 시작할 수 있습니다.
  • 새 설정은 이전 설정과 샤드 개수가 동일해야 합니다. 마이그레이션 중에 확장이나 축소는 불가능합니다. 이전 설정이 Master X개와 Coreapp Y개로 구성되었다면 새로운 설정도 Master와 Coreapp 개수가 정확히 같아야 합니다. 마이그레이션 전후의 Master와 Coreapp 개수가 일치하지 않는다면 마이그레이션이 실패합니다.
  • 프로덕션 계정을 마이그레이션하기 전에 테스트 계정을 사용하여 마이그레이션해 봅니다.
  • 가동이 중단되는 시간이 있습니다. 중단 시간은 마이그레이션 옵션에 따라 달라지지만 모든 마이그레이션에는 가동 중단이 발생합니다.

마이그레이션 옵션

마이그레이션하고자 하는 데이터양에 따라 여러 가지 마이그레이션 옵션이 있습니다. 요구 사항에 가장 적합한 옵션을 선택하세요.

각 마이그레이션 옵션에서 보존되는 데이터

옵션 1옵션 2옵션 3

설정

앱 설정

등록

암호화 키

메시지

메시지

콜백

연락처

인증 토큰

API 사용자 데이터

API 인증 토큰

각 마이그레이션 옵션의 일반 사용 사례와 가동 중단 시간

이 표에서는 각 마이그레이션 옵션의 일반 사용 사례 및 관련 가동 중단 시간을 설명합니다. 이는 일반 사용 사례일 뿐이며, 필요에 따라 마이그레이션 옵션을 선택할 수 있습니다.

일반 사용 사례가동 중단 시간

옵션 1

엔드 클라이언트를 플랫폼으로 옮기고 싶어 하는 솔루션 제공업체이고 설정 데이터만 유지하고자 하는 경우

이 옵션은 기기 간 전송에 필요한 데이터양이 가장 적기 때문에 다른 옵션에 비해 가동 중단 시간이 가장 적습니다.

옵션 2

엔드 클라이언트를 플랫폼으로 옮기고 싶어 하는 솔루션 제공업체이고 설정 및 메시지 데이터를 유지하고자 하는 경우

이 옵션은 기기 간에 메시지와 설정 데이터를 모두 전송해야 하므로 옵션 1에 비해 가동 중단 시간이 더 깁니다. 이 데이터는 비즈니스에 따라 용량이 상당히 클 수도 있습니다.

옵션 3

WhatsApp Business API 클라이언트를 관리하는 WhatsApp의 직접 클라이언트이고 WhatsApp Business API 클라이언트와 데이터를 다른 기기로 이동하는 경우

이 옵션은 기기 간에 클라이언트 데이터를 모두 전송해야 하므로 다른 옵션에 비해 가동 중단 시간이 가장 깁니다. 이 데이터는 비즈니스에 따라 용량이 상당히 클 수도 있습니다.

옵션 1: 설정만

설정만 마이그레이션인 경우 설정 정보만 백업 및 복원됩니다. 메시지와 인증 토큰 정보는 마이그레이션되지 않습니다.

1단계: 새 설정 설치

설치 문서를 사용하여 새로운 WhatsApp Business API 클라이언트를 설정합니다.

2단계: 새 설정에 대한 새로운 인증 토큰 받기

기존의 인증 토큰은 새로운 환경에서 유효하지 않습니다. 새로운 설정에 로그인하여 새 인증 토큰을 받습니다.

3단계: 정리

  • [선택 사항] 2단계 인증을 비활성화합니다. 2단계 인증 코드를 잊어 다시 등록해야 하는 경우에 유용합니다. 원활한 마이그레이션을 위해 필수적으로 다시 등록해야 하는 것은 아니지만 알 수 없는 이유로 백업과 복원이 실패하면 강제로 다시 등록해야 할 수도 있습니다. 2단계 인증 코드 비활성화 지침을 따르세요.
    참고: 2단계 인증 코드를 확실히 알고 있을 경우 이 단계는 선택 사항입니다.
  • [선택 사항] Webhooks를 재설정합니다. Webhook가 인바운드 알림을 수신하도록 설정되어 있고 Webhook 서버도 마이그레이션 중에 변경될 경우 앱 설정에서 이전의 Webhook 서버를 비활성화하세요.
    참고: 마이그레이션 후에 Webhook 서버를 변경하지 않는다면 이 단계는 선택 사항입니다.

4단계: 기존 설정에서 설정 백업

기존 인증 토큰을 사용하여 현재 WhatsApp Business API 클라이언트에서 설정 데이터를 백업합니다.

5단계: 기존 설정 제거

이 경우 메시지 전송이 중단됩니다. 메시지 전송 중단을 최소화하려면 새로운 위치에서 WhatsApp Business API 클라이언트를 실행할 준비를 합니다. 자세한 내용은 각 설치 가이드의 제거 섹션을 참조하세요. Coreapp, Webapp 및 Master의 Docker 컨테이너가 포함된 WhatsApp Business API 클라이언트만 제거하고 데이터베이스는 삭제하지 마세요.

6단계: 새로운 설정에서 설정 복원

아직 새로운 인증 토큰을 사용하지 않고 있다면 로그인해서 새로운 설정을 복원합니다.
모든 필수 정보를 포함한 새로운 WhatsApp Business API 클라이언트가 실행되고 메시지를 전송할 준비를 마쳐야 합니다. 가장 중요한 점은 설정을 적절히 백업하고 복원했다면 WhatsApp 계정을 다시 등록할 필요가 없다는 것입니다.

7단계: 상태 점검 수행

상태 점검을 수행하여 WhatsApp Business API 클라이언트가 작동하는지 확인할 테스트 메시지를 보냅니다.

8단계: [선택 사항] 2단계 인증을 활성화합니다.

3단계에서 2단계 인증을 비활성화했다면 지금 2단계 인증을 다시 활성화합니다. 이를 통해 WhatsApp 계정에 추가적인 보안을 제공할 수 있습니다.

9단계: Webhooks 설정

Webhooks를 설정하여 인바운드 알림을 활성화합니다.

10단계: 이전 데이터베이스 삭제

이전 데이터베이스에는 이전의 설정, 이전 메시지, 이전 인증 토큰에 대한 데이터가 포함되어 있습니다. 향후 이 데이터를 복구하고 싶다면 이전 데이터베이스를 삭제하지 마세요. 데이터베이스를 삭제하기로 결정했다면 WhatsApp Business API 클라이언트를 14일 이상 실행하고 메시지가 잘 전송되는지 확인한 후에 삭제하세요.

옵션 2: 설정 및 메시지

설정과 메시지 마이그레이션인 경우 설정 정보와 메시지가 모두 백업 및 복원됩니다. 인증 토큰 정보는 마이그레이션되지 않습니다.

다른 기기로 전송해야 하는 데이터양에 유의하세요. 더 많은 데이터를 백업하고 복원해야 하므로 옵션 1보다 가동 중단 시간이 상대적으로 더 깁니다. 전송되는 데이터양과 네트워크 지연에 따라 총 가동 중단 시간이 달라집니다.

1단계: 정리

  • [선택 사항] 2단계 인증을 비활성화합니다. 2단계 인증 코드를 잊어 다시 등록해야 하는 경우에 유용합니다. 원활한 마이그레이션을 위해 필수적으로 다시 등록해야 하는 것은 아니지만 알 수 없는 이유로 백업과 복원이 실패하면 강제로 다시 등록해야 할 수도 있습니다. 2단계 인증 코드 비활성화 지침을 따르세요.
    참고: 2단계 인증 코드를 확실히 알고 있을 경우 이 단계는 선택 사항입니다.
  • [선택 사항] Webhooks를 재설정합니다. Webhook가 인바운드 알림을 수신하도록 설정되어 있고 Webhook 서버도 마이그레이션 중에 변경될 경우 앱 설정에서 이전의 Webhook 서버를 비활성화하세요. 이는 메시지 전송이 중단되기 시작하는 첫 번째 단계입니다.
    참고: 마이그레이션 후에 Webhook 서버를 변경하지 않는다면 이 단계는 선택 사항입니다.

2단계: 기존 설정 제거

이 경우 메시지 전송이 중단됩니다. 메시지 전송 중단을 최소화하려면 새로운 위치에서 WhatsApp Business API 클라이언트를 실행할 준비를 합니다. 자세한 내용은 각 설치 가이드의 제거 섹션을 참조하세요. WhatsApp Business API 클라이언트만 제거하고 데이터베이스는 삭제하지 마세요.

3단계: 데이터베이스 백업

기존 WhatsApp Business API 클라이언트에서 사용자/인증 데이터가 포함된 waweb을 제외한 모든 데이터베이스를 mysqldumppg_dump 등의 유틸리티를 사용하여 백업합니다.
참고: 비즈니스를 플랫폼으로 마이그레이션하거나 플랫폼에서 마이그레이션하는 솔루션 제공업체인 경우 waweb을 제외하는 것이 중요합니다. 현재 저장된 인증 토큰과 사용자 정보를 이월하거나 넘기고 싶지 않을 수 있습니다.

4단계: 데이터베이스 복원

mysqldumppg_dump와 같은 유틸리티를 사용하여 새로운 WhatsApp Business API 클라이언트로 데이터베이스를 복원합니다.

5단계: 새 설정 설치

설치 문서를 사용하여 새로운 WhatsApp Business API 클라이언트를 설정합니다. 4단계에서 복원한 위치로 데이터베이스의 위치를 지정하세요.

6단계: 새 설정에 대한 새로운 인증 토큰 받기

기존의 인증 토큰은 새로운 환경에서 유효하지 않습니다. 새로운 설정에 로그인하여 새 인증 토큰을 받습니다.
모든 필수 정보를 포함한 새로운 WhatsApp Business API 클라이언트가 실행되고 메시지를 전송할 준비를 마쳐야 합니다. 가장 중요한 점은 데이터베이스를 적절히 백업하고 복원했다면 WhatsApp 계정을 다시 등록할 필요가 없다는 것입니다.

7단계: 상태 점검 수행

상태 점검을 수행하여 WhatsApp Business API 클라이언트가 작동하는지 확인할 테스트 메시지를 보냅니다.

8단계: [선택 사항] 2단계 인증을 활성화합니다.

1단계에서 2단계 인증을 비활성화했다면 지금 2단계 인증을 다시 활성화합니다. 이를 통해 WhatsApp 계정에 추가적인 보안을 제공할 수 있습니다.

9단계: Webhooks 설정

Webhooks를 설정하여 인바운드 알림을 활성화합니다.

10단계: 이전 데이터베이스 삭제

이전 데이터베이스에는 이전의 설정, 이전 메시지, 이전 인증 토큰에 대한 데이터가 포함되어 있습니다. 향후 이 데이터를 복구하고 싶다면 이전 데이터베이스를 삭제하지 마세요. 데이터베이스를 삭제하기로 결정했다면 WhatsApp Business API 클라이언트를 14일 이상 실행하고 메시지가 잘 전송되는지 확인한 후에 삭제하세요.

옵션 3: 전체 마이그레이션

전체 마이그레이션인 경우 모든 설정, 메시지 및 인증 토큰을 백업하고 복원합니다.

이 옵션이 가장 좋은 것 같지만, 다른 기기로 전송해야 하는 데이터양에 유의하세요. 더 많은 데이터를 백업하고 복원해야 하므로 이 옵션은 옵션 1옵션 2보다 가동 중단 시간이 상대적으로 더 깁니다.

1단계: 정리

  • [선택 사항] 2단계 인증을 비활성화합니다. 2단계 인증 코드를 잊어 다시 등록해야 하는 경우에 유용합니다. 원활한 마이그레이션을 위해 필수적으로 다시 등록해야 하는 것은 아니지만 알 수 없는 이유로 백업과 복원이 실패하면 강제로 다시 등록해야 할 수도 있습니다. 2단계 인증 코드 비활성화 지침을 따르세요.
    참고: 2단계 인증 코드를 확실히 알고 있을 경우 이 단계는 선택 사항입니다.

2단계: 현재 인증 토큰 백업

토큰의 최대 유효 기간은 7일입니다. 토큰의 유효 기간이 마이그레이션하기에 충분한지 확인하세요.

3단계: 기존 설정 제거

이 경우 메시지 전송이 중단됩니다. 메시지 전송 중단을 최소화하려면 새로운 위치에서 WhatsApp Business API 클라이언트를 실행할 준비를 합니다. 자세한 내용은 각 설치 가이드의 제거 섹션을 참조하세요. WhatsApp Business API 클라이언트만 제거하고 데이터베이스는 삭제하지 마세요.

4단계: [선택 사항] 데이터베이스 백업

mysqldumppg_dump와 같은 유틸리티를 사용하여 데이터베이스를 백업하고 설정, 메시지 및 인증 토큰 데이터를 캡처합니다.
참고: 데이터베이스를 제외하고 WhatsApp Business API 클라이언트만 마이그레이션하는 경우 이 단계는 선택 사항입니다.

5단계: 데이터베이스 복원

mysqldumppg_dump와 같은 유틸리티를 사용하여 새로운 WhatsApp Business API 클라이언트로 데이터베이스를 복원합니다.

6단계: 새 설정 설치

설치 문서를 사용하여 새로운 WhatsApp Business API 클라이언트를 설정합니다. 5단계에서 복원한 위치로 데이터베이스의 위치를 지정하세요.
모든 필수 정보를 포함한 새로운 WhatsApp Business API 클라이언트가 실행되고 메시지를 전송할 준비를 마쳐야 합니다. 가장 중요한 점은 데이터를 적절히 백업하고 복원했다면 WhatsApp 계정을 다시 등록할 필요가 없다는 것입니다.

7단계: 상태 점검 수행

상태 점검을 수행하여 WhatsApp Business API 클라이언트가 작동하는지 확인할 테스트 메시지를 보냅니다.

8단계: [선택 사항] 2단계 인증을 활성화합니다.

1단계에서 2단계 인증을 비활성화했다면 지금 2단계 인증을 다시 활성화합니다. 이를 통해 WhatsApp 계정에 추가적인 보안을 제공할 수 있습니다.

9단계: Webhooks 설정

Webhooks를 설정하여 인바운드 알림을 활성화합니다.

10단계: 이전 데이터베이스 삭제

이전 데이터베이스에는 이전의 설정, 이전 메시지, 이전 인증 토큰에 대한 데이터가 포함되어 있습니다. 향후 이 데이터를 복구하고 싶다면 이전 데이터베이스를 삭제하지 마세요. 데이터베이스를 삭제하기로 결정했다면 WhatsApp Business API 클라이언트를 14일 이상 실행하고 메시지가 잘 전송되는지 확인한 후에 삭제하세요.