Migração

Se você já possui uma configuração do cliente da WhatsApp Business API e quer migrar para uma nova usando o mesmo número de telefone, leia este documento para saber como identificar e realizar as mudanças necessárias.

Antes de começar

• Fazer o backup é a etapa mais importante da migração.
• Não é preciso registrar seu número de telefone novamente após a migração. Você poderá enviar mensagens assim que a migração for concluída.
• A nova configuração precisa ter o mesmo número de fragmentos da anterior. Não é permitido fazer aumentos nem diminuições durante a migração. Se a antiga configuração estiver definida com um número X de mestres e um número Y de Coreapps, a nova configuração precisará ter a mesma quantidade de mestres e Coreapps. Caso haja incompatibilidade entre o número de mestres e Coreapps antes e depois da migração, a mudança não será concluída.
• Tente migrar uma conta de teste antes de fazer isso com a conta de produção.
• Prepare-se para lidar com um tempo de inatividade e não envie mensagens durante a migração. Haverá um tempo de inatividade independentemente da opção de migração. Só retome o envio de mensagens após a conclusão da migração.

Migração de configurações

Fazer a migração das configurações do cliente do WhatsApp Business garante a preservação das configurações do app, das informações de registro e das chaves de criptografia. As mensagens e as informações do token de autenticação não são migradas.

Como a quantidade de dados que precisa ser transferida entre as máquinas é mínima, haverá apenas um período curto de inatividade.

Etapa 1: instalar uma nova configuração

Configure seu novo cliente da WhatsApp Business API usando a documentação de instalação.

Etapa 2: obter outro token de autenticação para a nova configuração

O token de autenticação atual não será válido no novo ambiente. Entre na nova configuração para obter outro token de autenticação.

Etapa 3: fazer uma limpeza

• Desabilite a autenticação de dois fatores (opcional). Isso é útil quando você esquece o código de autenticação de dois fatores e precisa se registrar novamente. Mesmo que um novo registro não seja requisito para concluir a migração, talvez você precise se registrar novamente caso o backup e a restauração falhem por algum motivo desconhecido. Siga as instruções para desabilitar o código de autenticação de dois fatores.
  Observação: se você tiver certeza de que seu código de autenticação está correto, essa etapa será opcional.
• Redefina os webhooks (opcional). Se os webhooks estiverem configurados para receber notificações de entrada e o servidor responsável também estiver sendo alterado durante a migração, desabilite o antigo servidor nas configurações do app.
  Observação: essa etapa será opcional caso você não altere o servidor de webhooks após a migração.

Etapa 4: fazer backup das configurações atuais

Use o token de autenticação atual para fazer backup dos dados de configuração do cliente da WhatsApp Business API.

Etapa 5: desinstalar a configuração atual

Isso gera um tempo de inatividade para a troca de mensagens. Para minimizar o problema, verifique se o cliente da WhatsApp Business API está pronto para ser executado no novo local. Consulte a seção sobre desinstalação no respectivo guia de instalação para ver as instruções. Desinstale apenas o cliente da WhatsApp Business API, que inclui os contêineres do Docker do Coreapp, do Webapp e do Master. Não exclua o banco de dados.

Etapa 6: restaurar as definições na nova configuração

Se você ainda não estiver usando um novo token de autenticação, entre na nova configuração e faça a restauração.
O novo cliente da WhatsApp Business API será executado com todas as informações necessárias e ficará pronto para a troca de mensagens. Lembre-se de que fazer o registro da conta do WhatsApp novamente não será uma etapa obrigatória se os processos de backup e restauração das configurações tiverem sido bem-sucedidos.

Etapa 7: fazer uma verificação de integridade

Faça uma verificação de integridade e envie uma mensagem de teste para verificar se o cliente da WhatsApp Business API está funcionando.

Etapa 8: habilitar a confirmação em duas etapas (opcional)

Se você tiver desabilitado a confirmação na Etapa 3, reabilite o recurso agora. Isso aumenta o nível de segurança na sua conta do WhatsApp.

Etapa 9: configurar webhooks

Configure seus webhooks para habilitar as notificações de entrada.

Etapa 10: descartar os dados antigos

Seu antigo banco de dados contém as informações de configurações, mensagens e tokens de autenticação anteriores. Se você quiser recuperar alguns desses dados no futuro, não descarte o antigo banco de dados. Caso decida descartar o banco de dados, verifique se o cliente da WhatsApp Business API está em execução há pelo menos 14 dias e se a troca de mensagens funciona corretamente antes de concluir a exclusão.