Como Migrar para a WhatsApp Business API

Este guia orienta você no processo de migração do seu número WhatsApp existente para a WhatsApp Business API oficial usando o WhatsTeam. A migração permite que você use recursos avançados da API mantendo seu número atual e histórico de conversas.

Benefícios da Migração

Migrar para a WhatsApp Business API oferece várias vantagens importantes:

Sem Risco de Banimento

A integração oficial com a API do WhatsApp elimina o risco de banimentos e desconexões que podem ocorrer com métodos não oficiais.

Manter Histórico de Conversas

Continue tendo acesso a todas as suas conversas e contatos tanto no aplicativo móvel quanto no WhatsTeam. Seu histórico de conversas é preservado durante a migração.

Manter o Número Atual

Continue usando seu aplicativo WhatsApp Business no celular enquanto também aproveita a API oficial. Não é necessário registrar um novo número.

Configuração Fácil

Complete a migração em minutos com nosso processo guiado simples. Não é necessário conhecimento técnico.

Requisitos

Antes de iniciar a migração, certifique-se de que você atende aos seguintes requisitos:

1. WhatsApp Business App

Você deve estar usando o WhatsApp Business App (não o WhatsApp pessoal) no seu celular. Se você está usando o aplicativo WhatsApp pessoal, precisará migrar para o WhatsApp Business primeiro (veja a seção Pré-Migração abaixo).

2. Conta do Facebook

Você precisa de uma conta ativa do Facebook vinculada ao seu negócio. Isso é necessário para o processo de autenticação do Meta.

3. Acesso ao Celular

Você precisará do seu celular durante a migração para vincular seu número atual do WhatsApp Business.

Dica: O processo de configuração do número é fácil e pode ser concluído em minutos seguindo os passos de integração.

Pré-Migração: Do App Pessoal para o Business

Pule esta seção se você já está usando o WhatsApp Business App.

Se você está usando o aplicativo WhatsApp pessoal, primeiro deve migrar para o WhatsApp Business App antes de prosseguir com a migração da API.

Siga estes passos para migrar do WhatsApp pessoal para o WhatsApp Business:

Passo 1: Faça backup do seu histórico de conversas

Abra o WhatsApp no seu celular e crie um backup do seu histórico de conversas:

1. Vá em Configurações > Conversas > Backup de Conversas
2. Toque em Fazer Backup Agora
3. Aguarde o backup ser concluído

Passo 2: Baixe o WhatsApp Business

Baixe o aplicativo WhatsApp Business na loja de aplicativos do seu dispositivo:

• Baixar para Android (Google Play)
• Baixar para iOS (App Store)

Passo 3: Verifique seu número

Abra o WhatsApp Business e verifique seu número de telefone:

1. Abra o aplicativo WhatsApp Business
2. Aceite os Termos de Serviço
3. Digite seu número de telefone
4. Verifique com o código SMS

Como verificar seu número no WhatsApp Business (FAQ do WhatsApp)

Passo 4: Restaure seu backup de conversas

Quando solicitado, restaure seu histórico de conversas a partir do backup que você criou:

1. O WhatsApp Business detectará seu backup
2. Toque em Restaurar para recuperar suas conversas
3. Aguarde a restauração ser concluída

Mais Informações:

• Como migrar do WhatsApp para o WhatsApp Business (FAQ do WhatsApp)
• Como fazer backup do seu histórico de conversas (FAQ do WhatsApp)

Limitações a Reconhecer

Antes de prosseguir com a migração, é importante entender as limitações operacionais. Os seguintes recursos NÃO estarão disponíveis no WhatsTeam após a migração, mas CONTINUARÃO funcionando no aplicativo móvel WhatsApp Business e no WhatsApp Web/Desktop.

1. Mensagens de Grupos

O gerenciamento e as mensagens de grupos estarão disponíveis apenas pelo aplicativo móvel. Você não pode enviar ou receber mensagens de grupo pela API.

2. Mensagens de Canais

As mensagens dos Canais do WhatsApp estarão disponíveis apenas pelo aplicativo móvel.

3. Status do Usuário (Stories)

Visualizar e publicar atualizações de status estará disponível apenas pelo aplicativo móvel.

4. Preços de Mensagens de Template

O Meta cobra por mensagens de template pré-aprovadas enviadas pela API. Certas restrições e custos adicionais se aplicam a mensagens enviadas em alguns cenários.

5. Desconexão de Dispositivos Vinculados

Os dispositivos vinculados existentes (WhatsApp Web/Desktop) serão desconectados durante a migração. Você pode reconectá-los após a conclusão da migração.

6. Processo Irreversível

Importante: A migração para a WhatsApp Business API é um processo irreversível. Uma vez migrado, o número permanecerá na conexão oficial WABA no WhatsTeam.

Mais Informações:

• Saiba mais sobre limitações ao usar o WABA Cloud API (Meta Developers)

Passos da Migração

Depois de confirmar os requisitos e reconhecer as limitações, você está pronto para iniciar a migração.

Passo 1: Iniciar a Migração

Navegue até a página de migração WABA no aplicativo e clique em "Vamos começar" para iniciar o processo.

Passo 2: Revisar Requisitos

Confirme que você atende a todos os requisitos e clique em "Continuar".

Passo 3: Reconhecer Limitações

Leia e reconheça cada limitação clicando em cada item. Todas as limitações devem ser reconhecidas para prosseguir.

Passo 4: Confirmar e Iniciar

Revise as notas importantes e clique em "Iniciar Migração" para começar o processo de conexão com o Meta.

Notas importantes antes de iniciar:

• Todos os dispositivos vinculados serão desconectados
• Você pode reconectá-los após a conclusão da migração
• Simplesmente siga os passos na janela popup até finalizar
• Não feche a janela durante o processo

Passo 5: Concluir Autenticação do Meta

Uma janela de conexão do Meta aparecerá. Siga os passos de autenticação:

1. Faça login com sua conta do Facebook
2. Selecione ou crie sua Conta WhatsApp Business
3. Escolha o número de telefone para conectar
4. Conclua o processo de verificação

Passo 6: Inserir Informações do Negócio

Quando solicitado, insira os detalhes do seu negócio:

• Nome da empresa: Deve corresponder ao nome nos seus documentos de registro (importante para futura verificação do negócio)
• Website: Insira o website do seu negócio, ou selecione "Minha empresa não tem um website" se aplicável

Passo 7: Inserir seu Número de Telefone

Quando solicitado, insira seu número de telefone do WhatsApp Business. Selecione o código do país e digite seu número no campo fornecido. Este passo é necessário para vincular seu número à WhatsApp Business API.

Você também verá uma mensagem sobre a conexão do seu aplicativo WhatsApp Business existente. Isso significa que as informações da sua conta (como número de telefone, contatos, conversas e histórico de conversas) podem ser compartilhadas para habilitar a migração. Seus dados serão gerenciados com segurança pelo Meta.

Clique em Seguinte para continuar.

Passo 8: Migração Concluída

Quando o processo estiver completo, você verá uma confirmação de sucesso. Seu número agora está conectado à WhatsApp Business API!

Feche a janela do Facebook e volte para a janela do aplicativo. Você verá uma mensagem de sucesso como esta:

O Que Acontece Após a Migração

Após migrar seu número com sucesso:

Seu aplicativo móvel continua funcionando normalmente

Você ainda pode usar o WhatsApp Business App no seu celular para mensagens individuais, grupos, canais e atualizações de status.

Mensagens são sincronizadas

As mensagens são sincronizadas entre a plataforma e seu celular. Mensagens enviadas pela API aparecem no seu WhatsApp Business App, e mensagens recebidas no seu celular aparecem no aplicativo.

Recursos avançados agora estão disponíveis

Agora você pode usar:

• Campanhas de mensagens em massa
• Chatbots e fluxos automatizados
• Caixa de entrada colaborativa para equipes
• Integrações via API
• Templates de mensagens
• Análises e relatórios

Reconectar dispositivos vinculados

Se você tinha o WhatsApp Web ou Desktop conectado, precisará reconectá-los:

1. Abra o WhatsApp Business no seu celular
2. Vá em Configurações > Dispositivos Vinculados
3. Toque em Vincular um Dispositivo
4. Escaneie o código QR no WhatsApp Web/Desktop

Solução de Problemas

Desconectar de um Provedor WABA Anterior

Se seu número já está conectado a outro Provedor de Soluções de Negócios (BSP), você deve desconectá-lo antes de migrar para o WhatsTeam. O WhatsApp não permite o uso do mesmo número de telefone em múltiplas integrações simultaneamente.

Para números usando Coexistência (WhatsApp Business App + Cloud API)

Você precisa desconectar tanto do Meta Business Suite quanto do WhatsApp Business App:

Passo 1: Remover acesso no Meta Business Suite

1. Faça login no Meta Business Suite usando suas credenciais empresariais
2. Clique em Configurações (geralmente localizado no canto inferior esquerdo)
3. Na seção Contas, clique em Contas do WhatsApp
4. Selecione o WhatsApp Business App em questão e abra a aba Parceiros
5. Clique em Gerenciar ao lado do seu BSP atual
6. Na janela pop-up, clique em Remover acesso

Passo 2: Desconectar do WhatsApp Business App

1. Abra o WhatsApp Business App no seu celular
2. Vá em Configurações > Conta > Plataforma de negócios
3. Toque no parceiro/provedor que deseja desconectar
4. Selecione Desconectar

Para números registrados exclusivamente para Cloud API (sem coexistência)

Se seu número foi registrado apenas para Cloud API sem o WhatsApp Business App:

1. Faça login no Meta Business Suite usando suas credenciais empresariais
2. Clique em Configurações (geralmente localizado no canto inferior esquerdo)
3. Na seção Contas, clique em Contas do WhatsApp
4. Selecione o WABA associado ao número que deseja excluir
5. Clique em WhatsApp Manager
6. Localize o número que deseja remover e clique no ícone de lixeira para excluí-lo

Nota: Após desconectar, pode levar algumas horas para os dados serem totalmente atualizados. Quando as alterações estiverem em vigor, você poderá conectar seu número ao WhatsTeam.

Migração falhou ou expirou

Se a migração falhar ou expirar:

1. Certifique-se de ter uma conexão de internet estável
2. Verifique se sua conta do Facebook está em boas condições
3. Confirme que seu WhatsApp Business App está atualizado
4. Tente novamente desde o início

Mensagens não sincronizando

Se as mensagens não estão aparecendo em ambos os lugares:

• Certifique-se de que a sincronização foi concluída
• Verifique se você compartilhou o histórico de conversas durante a configuração
• Lembre-se de que mídias com mais de 14 dias não podem ser sincronizadas
• Novas mensagens devem sincronizar automaticamente

Não encontra a opção de migração

A opção de migração está disponível para números que atualmente usam o WhatsApp Business App e ainda não foram conectados à API oficial. Navegue para:

1. Vá para as configurações do seu dispositivo no WhatsTeam
2. Procure a opção "Migrar para WABA"

Perguntas Frequentes

Posso reverter a migração após completá-la?

Não. A migração para a WhatsApp Business API é irreversível. Uma vez que seu número está conectado através da WABA oficial, não é possível reverter para usar apenas o WhatsApp Business App no WhatsTeam.

Vou perder meus contatos?

Não. Seus contatos permanecem no seu celular e no WhatsApp Business App. Os contatos que foram sincronizados com o WhatsTeam também serão preservados.

Quanto tempo leva a migração?

O processo de migração geralmente leva de 5 a 10 minutos. A sincronização de mensagens pode levar mais tempo dependendo do tamanho do seu histórico de conversas.

Isso está disponível em todos os países?

O recurso de Coexistência não está disponível para empresas na Nigéria e na África do Sul (identificadas pelo número de telefone do Business App).

E quanto à taxa de envio de mensagens?

Números usando Coexistência têm uma taxa fixa de 5 mensagens por segundo para manter a compatibilidade com o WhatsApp Business App.