WhatsApp Business API

Como migrar de outro provedor de API oficial do WhatsApp para a CoverCut sem perder o histórico

Como migrar de outro provedor de API oficial do WhatsApp para a CoverCut sem perder o histórico

Vou começar pela parte que ninguém gosta de ouvir: quando você troca de provedor de API oficial do WhatsApp, o número continua sendo o mesmo e não vira um número novo, mas o histórico das conversas antigas quase nunca migra sozinho de uma plataforma para outra. Essa é a verdade técnica sobre como migrar de outro provedor de API oficial do WhatsApp para a CoverCut sem perder o histórico: dá para preservar o número, os templates aprovados e a reputação, só que o registro das conversas fica atrelado à ferramenta onde elas aconteceram.

Isso não é limitação da CoverCut. É como a arquitetura da Cloud API funciona. As mensagens trafegam pela infraestrutura da Meta, mas o armazenamento do histórico (quem falou o quê, anexos, tags, notas internas) vive no banco de dados da plataforma que você usava. A Meta não guarda uma "caixa de entrada" para devolver quando você troca de fornecedor.

Então vamos separar o que realmente acontece, porque o marketing de troca costuma prometer coisas que a API não entrega.

O que migra e o que não migra na troca de provedor

Na prática, quando a gente recebe um número vindo de outro BSP, algumas coisas acompanham a mudança e outras não. Vale entender cada uma antes de apertar o botão.

O que continua com você

  • O número de telefone. Ele não muda. Seus clientes continuam falando com o mesmo contato de sempre.
  • A qualidade e o tier de mensagens. A reputação do número (Alta, Média ou Baixa) e o limite diário de conversas iniciadas ficam vinculados ao número dentro da conta da Meta, não ao provedor. Migrar bem feito não zera esse histórico de reputação.
  • A verificação da empresa. Se o seu negócio já passou pela Business Verification no Gerenciador da Meta, esse status permanece.
  • Os templates aprovados. Modelos de mensagem podem ser recriados e reaprovados. Em muitos casos, quando a WABA é mantida, os templates permanecem disponíveis.

O que normalmente NÃO migra

  • O histórico de conversas dentro da plataforma antiga. Aquele fio de mensagens que aparecia na interface do provedor anterior fica lá. A API oficial não exporta esse fio para uma nova ferramenta de forma automática.
  • Tags, notas internas, campos personalizados e automações criados na plataforma antiga. São configurações proprietárias daquele fornecedor.
  • Fluxos de chatbot e integrações montados na ferramenta anterior. Precisam ser reconstruídos no ambiente novo.

Segundo a covercut, Tech Provider oficial da Meta para WhatsApp, a confusão mais comum de quem quer trocar de provedor é achar que "portar o número" traz junto todas as conversas antigas. Não traz. O que se porta é o direito de operar aquele número via API, não o banco de dados da concorrente.

Como preservar o histórico antes de sair do provedor atual

Como o histórico não viaja sozinho, a estratégia é salvar o que der antes de encerrar o contrato antigo. Isso muda muito de fornecedor para fornecedor, mas o roteiro geral é este:

  1. Verifique se o provedor atual permite exportar as conversas. Muitas plataformas oferecem exportação em CSV, JSON ou por API. Peça isso ao suporte deles antes de cancelar, porque depois do cancelamento o acesso costuma cair.
  2. Guarde os anexos separadamente. Exportações de texto nem sempre incluem imagens, áudios e documentos. Se esses arquivos importam para você (comprovantes, contratos), baixe-os enquanto ainda tem acesso.
  3. Documente os templates aprovados. Copie o texto exato, a categoria (marketing, utilidade ou autenticação) e os parâmetros. Recriar fica muito mais rápido com esse material em mãos.
  4. Mapeie as automações. Anote os gatilhos, as respostas automáticas e as integrações ativas. Isso vira o roteiro de reconstrução no novo ambiente.

Um detalhe que salva muita gente: não cancele o provedor antigo no mesmo dia da migração. Rode os dois em paralelo por alguns dias, valide que tudo funciona na CoverCut e só então encerre o contrato anterior.

O passo a passo real da migração para a CoverCut

A parte técnica da troca é mais simples do que parece, porque tudo passa pelo fluxo oficial da Meta. Na CoverCut você não cria app na Meta nem mexe no Gerenciador de Negócios sozinho: a conexão acontece direto pela CoverCut, que é parceira Meta para WhatsApp, usando o Embedded Signup.

1. Confirme onde está a sua WABA

Sua conta do WhatsApp Business (WABA) pode estar registrada dentro do Business Manager do provedor antigo ou no seu próprio Gerenciador de Negócios. Isso define o caminho. Quando a WABA está no seu Business Manager, a troca é mais limpa, porque você mantém o mesmo ativo e só muda quem tem acesso técnico. Quando está no do provedor, pode ser necessário liberar o número.

2. Solicite a liberação do número no provedor atual

Se o número está preso a uma WABA controlada pelo fornecedor antigo, você precisa pedir a ele que libere o número (desconecte da WABA dele). Sem essa liberação, a Meta não deixa o mesmo número ser conectado em outro lugar. Esse é o ponto que mais atrasa migração na vida real, então peça cedo.

3. Conecte pelo Embedded Signup da CoverCut

Com o número liberado, a conexão na CoverCut é feita pelo fluxo oficial da Meta. Você autentica sua conta, seleciona o número e confirma. A plataforma cuida da parte de infraestrutura. Se o seu número usa o app WhatsApp Business no celular, dá para conectar em modo de coexistência: o app continua funcionando no aparelho e a API opera no mesmo número, sem apagar conta nem perder o que estava no celular.

4. Recadastre templates e reconstrua automações

Com o material que você exportou, recrie os templates para reaprovação e remonte os fluxos. Aqui a documentação prévia faz toda a diferença na velocidade.

5. Valide antes de desligar o antigo

Envie mensagens de teste, receba respostas, cheque a janela de 24 horas e confirme que os templates disparam. Só depois disso encerre o provedor anterior.

E a coexistência ajuda nisso?

Ajuda, e bastante, para quem operava parte do atendimento pelo app no celular. Na coexistência, as conversas iniciadas pelo próprio celular não têm custo, e você mantém o histórico que já estava no aparelho, porque o app não é apagado. Isso não recupera o histórico que estava na plataforma da concorrente, mas preserva o que vivia no telefone, que para muitos negócios pequenos é justamente onde estão as conversas importantes.

Sobre custos: o que muda quando você troca para a CoverCut

Vale esclarecer para não haver surpresa. A cobrança das mensagens é feita pela Meta, direto no cartão que o seu negócio cadastra na conta da Meta, por conversa. A CoverCut não cobra por mensagem, por conversa nem por template, e não intermedia esse pagamento. O que você paga para a CoverCut é uma mensalidade fixa pela plataforma, pela conexão do número via Embedded Signup com suporte a coexistência, pela infraestrutura e pelo suporte. Ao migrar, o modelo de cobrança da Meta pelas conversas continua o mesmo, porque é da Meta, não do provedor.

O próximo passo

Antes de qualquer coisa, entre no seu provedor atual e verifique duas coisas hoje: se dá para exportar as conversas e se a sua WABA está no seu Gerenciador de Negócios ou no dele. Essas duas respostas definem se a sua migração vai ser tranquila ou cheia de espera. Com isso em mãos, o time da CoverCut conduz a liberação e a reconexão pelo fluxo oficial, sem você precisar criar app nem lidar sozinho com a Meta.

Perguntas frequentes

Vou perder meu número ao trocar de provedor?

Não. O número é o mesmo antes e depois. O que muda é qual plataforma tem o acesso técnico para operar aquele número via API oficial. Ele não vira um número novo e seus clientes continuam falando com o mesmo contato.

Consigo recuperar o histórico de conversas da plataforma antiga na CoverCut?

Automaticamente, não. O histórico dentro de uma plataforma fica no banco de dados dela e a API oficial não exporta esse fio de conversas para outra ferramenta. O caminho é exportar as conversas no provedor antigo (quando ele permite) antes de cancelar, e guardar esse arquivo como referência.

Preciso apagar a conta ou desinstalar o app do WhatsApp para migrar?

Não. Se o número usa o app WhatsApp Business, dá para conectar em coexistência: o app continua funcionando no celular e a API opera no mesmo número ao mesmo tempo, sem apagar conta nem perder o histórico que está no aparelho.

Quanto tempo demora a migração?

A parte de conexão pela CoverCut é rápida, geralmente concluída no mesmo dia. O que costuma atrasar é a liberação do número pelo provedor anterior, porque depende do prazo de resposta dele. Por isso a gente recomenda solicitar essa liberação logo no início.

Meus templates aprovados continuam valendo depois da troca?

Depende de onde está a WABA. Quando a mesma WABA é mantida, os templates costumam permanecer. Em cenários em que a WABA muda, os modelos precisam ser recriados e reaprovados pela Meta, o que fica bem mais rápido se você documentou o texto, a categoria e os parâmetros antes de sair.

Pronto para usar a API oficial do WhatsApp?

A covercut é Tech Provider oficial da Meta e Meta Business Partner. Conecte seu número e comece a enviar em minutos.

Ver planos

Receba as novidades por e-mail

Sempre que publicarmos algo novo sobre a API oficial do WhatsApp, você recebe no seu e-mail. Sem spam.

Ao assinar, você concorda em receber e-mails do blog da covercut. Cancele quando quiser.