Миграция

Если у вас уже есть настроенный клиентAPI WhatsApp Business и вы хотите выполнить миграцию в новую конфигурацию, оставив старый номер телефона, воспользуйтесь этим документом.

Перед началом работы

• Самое важное — создать резервные копии.
• После миграции не нужно заново регистрировать номер телефона. Можно сразу начинать отправлять сообщения.
• В новой конфигурации должно быть столько же сегментов, сколько и в старой. Изменять их количество во время миграции нельзя. Если в текущей конфигурации X основных узлов и Y узлов Coreapp, то и в новой должно быть столько же. Если количество основных узлов и узлов Coreapp до и после миграции не совпадает, она завершится ошибкой.
• Перед миграцией рабочего аккаунта попрактикуйтесь на тестовом.
• Будьте готовы к простою и не отправляйте сообщения во время миграции. Независимо от того, как вариант миграции выбран, простой неизбежен. Отправку сообщений можно возобновить только по завершении миграции.

Миграция настроек

Миграция настроек клиента WhatsApp Business позволяет сохранить настройки приложения, информацию о регистрации и ключи шифрования. Миграция сообщений и информации о маркере аутентификации не выполняется.

Поскольку количество данных, которые необходимо перенести между компьютерами, минимально, время простоя будет минимальным.

Шаг 1. Установка новой конфигурации

Настройте клиент API WhatsApp Business, как описано в документации.

Шаг 2. Получение маркера аутентификации для новой конфигурации

Текущий маркер для нее не сработает. Для получения маркера войдите в новую конфигурацию.

Шаг 3. Заключительные действия

• [Необязательно]Отключите двухшаговую аутентификацию. Это полезно, если вы забудете код двухшаговой аутентификации и вам придется регистрироваться повторно. Хотя при нормально протекающей миграции повторная регистрация не требуется, у вас может возникнуть необходимость зарегистрироваться еще раз, если по той или иной неизвестной причине резервное копирование и восстановление завершатся ошибкой. Чтобы отключить запрос кода двухшаговой аутентификации, следуйте инструкциям.
  Примечание. Если вы уверены, что точно помните код аутентификации, ее можно не отключать.
• [Необязательно]Сбросьте Webhooks. Если они получают входящие уведомления, а миграция предусматривает смену сервера Webhooks, отключите старый сервер в настройках приложения.
  Примечание. Если вы не меняете сервер, Webhooks можно не сбрасывать.

Шаг 4. Резервное копирование настроек текущей конфигурации

Используйте текущий маркер аутентификации, чтобы создать резервную копию настроек из действующего клиента API WhatsApp Business.

Шаг 5. Удаление текущей конфигурации

Это приведет к перебоям в отправке сообщений. Чтобы сократить время простоя, заранее подготовьте клиент API WhatsApp Business к работе в новом местоположении. За инструкциями обратитесь к разделу с информацией об удалении в соответствующем руководстве по установке. Убедитесь, что вы удаляете только клиент API WhatsApp Business, что включает в себя контейнеры Docker контейнеров Coreapp, Webapp и основного контейнера; не удаляйте базу данных.

Шаг 6. Перенос настроек в новую конфигурацию

Войдите в новую конфигурацию (если вы еще не используете новый маркер аутентификации) и выполните восстановление.
После этого новый клиент API WhatsApp Business будет готов к отправке сообщений. Помните: если резервное копирование и восстановление настроек прошло успешно, аккаунт WhatsApp не нужно регистрировать повторно.

Шаг 7. Проверка работоспособности

Проверьте работоспособность нового клиента API WhatsApp Business, отправив тестовое сообщение.

Шаг 8. [Необязательно] Активация двухшаговой проверки

Если вы отключали ее в шаге 3, снова активируйте двухшаговую проверку. Она поможет защитить ваш аккаунт WhatsApp.

Шаг 9. Настройка Webhooks

Включите входящие уведомления для Webhooks.

Шаг 10. Удаление старой базы данных

Она содержит прежние настройки, сообщения и маркеры аутентификации. Если они еще могут вам понадобиться, не удаляйте старую базу. Если вы решите удалить базу, подождите как минимум 14 дней после установки нового клиента API WhatsApp Business и убедитесь, что сообщения работают правильно.