O que é trocar plataforma whatsapp business api?

É um tema relacionado à organização e melhoria do atendimento ao cliente, que deve ser aplicado conforme o contexto, os objetivos e os recursos de cada equipe.

Como começar a aplicar trocar plataforma whatsapp business api?

Comece avaliando o processo atual, defina um resultado mensurável e teste uma mudança pequena antes de ampliar a prática para toda a operação.

Como medir os resultados de trocar plataforma whatsapp business api?

Acompanhe indicadores de eficiência, qualidade e percepção do cliente, comparando uma linha de base com os resultados observados após cada mudança.

Troque de plataforma no WhatsApp sem perder número

Por que empresas migram de plataforma no WhatsApp

Empresas que já operam com a API oficial do WhatsApp enfrentam, em algum momento, a necessidade de avaliar se a plataforma atual ainda atende aos requisitos técnicos, comerciais e de experiência do cliente. Limitações de integração, falta de suporte especializado, custos crescentes, ausência de recursos críticos ou problemas de estabilidade são os motivos mais frequentes para considerar uma mudança.

A migração de plataforma no WhatsApp não significa trocar de número ou perder o acesso ao canal. O que muda é o provedor de tecnologia que gerencia a conexão entre a empresa e a API da Meta. Quando realizada com planejamento técnico, a troca preserva o número, mantém o histórico acessível e permite que a operação continue sem interrupção visível para o cliente final.

No entanto, migrações executadas sem método podem resultar em bloqueio temporário do número, perda de configurações críticas, retrabalho extenso na recriação de fluxos e templates, e até mesmo indisponibilidade do canal durante dias. Este tutorial detalha o processo técnico para migrar de plataforma no WhatsApp Business API com segurança, preservando a continuidade do atendimento.

O que é necessário para trocar de plataforma no WhatsApp

A migração de plataforma no WhatsApp Business API exige três componentes principais: acesso ao Gerenciador de Negócios da Meta (Business Manager), onde a conta oficial do WhatsApp (WABA) está registrada; documentação atualizada da empresa titular do número; e uma nova plataforma homologada pela Meta como Business Solution Provider.

O elemento técnico central da migração é o token de migração WABA (WABA Migration Token). Este código de segurança, gerado no painel do Gerenciador de Negócios, autoriza a transferência da gestão do número oficial de um provedor para outro. Sem o token, nenhuma plataforma pode assumir o controle da conta WhatsApp, garantindo que apenas gestores autorizados executem a mudança.

Além do token, é necessário mapear todos os recursos ativos na plataforma atual: templates de mensagem aprovados, fluxos de automação, integrações com CRM ou ERP, lista de usuários com permissões de acesso, webhooks configurados e relatórios de uso. Esse inventário evita que funcionalidades críticas sejam esquecidas durante a reconfiguração.

Outro ponto de atenção é o histórico de conversas. As mensagens trocadas com clientes não são transferidas automaticamente entre plataformas. O histórico permanece armazenado no banco de dados da plataforma antiga ou pode ser exportado antes da migração. A nova plataforma registrará apenas as conversas iniciadas após a conclusão da troca. Empresas que precisam manter o contexto completo do cliente devem integrar o histórico exportado a um sistema de CRM ou garantir que os agentes tenham acesso ao arquivo de backup durante um período de transição.

Passo 1: Mapear a operação atual e preparar a documentação

Antes de iniciar qualquer processo técnico, a equipe de TI ou o gestor de atendimento deve documentar a configuração completa da operação no WhatsApp. Isso inclui:

Lista de todos os templates de mensagem (HSM) aprovados, com nome, categoria (marketing, transacional, autenticação), variáveis e idioma.
Descrição detalhada dos fluxos de automação ativos: triagem, respostas automáticas, distribuição de filas, escalações e handoff para humano.
Mapeamento de integrações com sistemas externos (CRM, ERP, plataformas de e-commerce, ferramentas de BI).
Relação de usuários ativos, funções, permissões e acessos configurados na plataforma.
Configuração de webhooks para envio e recebimento de eventos (mensagens recebidas, status de entrega, atualizações de template).
Relatórios de uso dos últimos três meses: volume de conversas ativas, conversas iniciadas pela empresa, custo médio por conversa e distribuição por categoria de template.

Esse mapeamento serve como referência para validar se todos os recursos foram recriados corretamente na nova plataforma antes do go-live. Também ajuda a identificar configurações desnecessárias que podem ser eliminadas, simplificando a operação futura.

Paralelamente, é necessário reunir a documentação da empresa titular do número: CNPJ, contrato social ou estatuto atualizado, comprovante de endereço da sede e documento de identidade do responsável legal. A Meta pode solicitar essa documentação durante o processo de migração, especialmente se houver alteração de dados cadastrais.

Passo 2: Escolher a nova plataforma e validar compatibilidade

A escolha da nova plataforma deve considerar não apenas os recursos técnicos, mas também a capacidade de migração assistida, suporte técnico especializado e histórico de estabilidade. Uma plataforma omnichannel que centraliza WhatsApp e outros canais em uma única caixa de entrada reduz a necessidade de múltiplas ferramentas e simplifica a gestão da operação.

Os critérios principais de avaliação incluem:

Homologação oficial da Meta: Apenas Business Solution Providers certificados têm acesso à API Cloud da Meta e podem gerenciar contas WABA.
Suporte técnico para migração: A nova plataforma deve oferecer assistência na geração do token, reconfiguração de webhooks e validação de templates.
Compatibilidade com integrações existentes: Verificar se a nova plataforma oferece API REST, webhooks e conectores nativos para CRM, ERP e ferramentas de automação.
Escalabilidade e limites de uso: Confirmar que a nova plataforma suporta o volume atual de conversas e permite crescimento sem necessidade de upgrade forçado.
Modelo de precificação transparente: Entender se a plataforma cobra por usuário, por canal conectado ou por volume de mensagens, e se há custos adicionais na migração.

Após escolher a plataforma, o próximo passo é agendar uma reunião técnica com o time de suporte para revisar o inventário da operação atual e definir um cronograma de migração. Essa reunião deve produzir um plano de migração detalhado, com responsáveis por cada etapa, prazos realistas e pontos de validação.

Passo 3: Gerar e transferir o token de migração WABA

O token de migração WABA é o elemento técnico que autoriza a transferência da conta oficial do WhatsApp de um provedor para outro. Ele é gerado no painel do Gerenciador de Negócios da Meta e tem validade limitada (geralmente 90 dias), então deve ser usado logo após a criação.

Para gerar o token, o gestor com permissão de administrador no Business Manager deve:

Acessar o Gerenciador de Negócios da Meta e localizar a conta do WhatsApp Business (WABA) que será migrada.
No menu de configurações da conta WABA, selecionar a opção de migração de provedor.
Confirmar a identidade da conta e gerar o token de migração.
Copiar o token completo e compartilhá-lo de forma segura com a nova plataforma.

A nova plataforma utilizará o token para solicitar à Meta a transferência da gestão da conta WABA. Durante esse processo, a plataforma antiga perde o acesso administrativo ao número, e a nova assume o controle. Por isso, é fundamental que a equipe esteja preparada para reconfigurar fluxos e templates imediatamente após a transferência.

O processo de transferência técnica pode levar de algumas horas a dois dias úteis, dependendo da validação interna da Meta. Durante esse período, o número permanece ativo e as mensagens recebidas continuam sendo entregues, mas novos envios podem ser bloqueados até que a nova plataforma conclua a configuração dos webhooks.

Passo 4: Recriar templates de mensagem e fluxos de automação

Após a transferência da conta WABA para a nova plataforma, é necessário recriar manualmente todos os templates de mensagem (HSM) que foram aprovados pela Meta na configuração anterior. Os templates não são transferidos automaticamente porque cada plataforma gerencia sua própria lista de modelos aprovados.

Para recriar os templates, a equipe deve:

Acessar a lista de templates mapeados no Passo 1.
Criar cada template na nova plataforma, respeitando exatamente o nome, categoria, corpo da mensagem, variáveis e idioma originais.
Submeter cada template para aprovação da Meta, que pode levar de algumas horas a 48 horas.
Aguardar a aprovação antes de ativar fluxos que dependem desses templates.

Enquanto os templates estão em análise, a equipe pode começar a reconfigurar os fluxos de automação. A maioria das plataformas oferece editores visuais drag-and-drop para construir fluxos de triagem, distribuição de filas, respostas automáticas e escalações. É importante revisar cada fluxo para garantir que:

As condições de disparo estão corretas (palavra-chave, horário, fila de origem).
As ações de resposta utilizam templates já aprovados.
O handoff para atendente humano está configurado com a fila correta.
As notificações internas (e-mail, webhook) estão ativas.

Se a operação utiliza integrações com CRM ou ERP, este é o momento de reconfigurar os webhooks e APIs. A nova plataforma fornecerá novos endpoints para receber eventos (mensagens recebidas, atualizações de status) e para enviar comandos (criar contato, atualizar oportunidade, registrar ticket). Testar cada integração individualmente antes do go-live evita falhas em produção.

Passo 5: Realizar testes de validação antes do go-live

A fase de testes é a mais crítica do processo de migração. Mesmo que todos os templates tenham sido recriados e os fluxos reconfigurados, erros de configuração só aparecem em cenários reais de uso. Um teste bem estruturado deve cobrir:

Envio e recebimento de mensagens: Enviar mensagens de texto, imagem, áudio e documento do número oficial e receber respostas de números de teste.
Disparo de templates: Testar o envio de cada template aprovado, preenchendo todas as variáveis obrigatórias e validando a entrega.
Fluxos de automação: Simular conversas reais para testar triagem, distribuição de filas, respostas automáticas e handoff para humano.
Integrações com sistemas externos: Criar um contato no CRM, atualizar uma oportunidade e verificar se os dados são sincronizados corretamente.
Webhooks e notificações: Confirmar que eventos de entrega, leitura e erro de mensagem estão sendo recebidos pelos sistemas integrados.
Acesso de usuários: Validar que cada agente consegue acessar a nova plataforma, visualizar conversas atribuídas e enviar mensagens.

Durante os testes, é recomendável manter a plataforma antiga ativa em paralelo, sem enviar mensagens, mas disponível para consulta de histórico e configurações. Isso permite que a equipe compare o comportamento esperado com o resultado real na nova plataforma.

Se algum erro crítico for identificado durante os testes, a migração deve ser adiada até que o problema seja corrigido. Erros comuns incluem: templates com variáveis incorretas, fluxos que não disparam handoff, integrações que não atualizam o CRM e webhooks que não recebem eventos de status.

Como evitar bloqueio de número durante a migração

Um dos riscos mais graves de uma migração mal planejada é o bloqueio temporário ou permanente do número pela Meta. Esse bloqueio pode ocorrer por violação das políticas de uso da API, envio de mensagens de marketing sem opt-in, uso de templates não aprovados ou tentativa de migração sem token válido.

Para evitar bloqueios, a equipe deve:

Nunca enviar mensagens de templates não aprovados: Aguardar a aprovação da Meta antes de ativar qualquer fluxo que dependa de templates.
Respeitar as janelas de atendimento: Mensagens proativas (templates) só podem ser enviadas fora da janela de 24 horas. Dentro da janela, qualquer mensagem de texto livre é permitida.
Manter opt-in documentado: A Meta pode solicitar comprovação de que os clientes autorizaram o recebimento de mensagens de marketing.
Evitar múltiplas tentativas de migração sem sucesso: Falhas repetidas na geração de token ou na reconfiguração podem acionar revisão manual da conta pela Meta.

Se o número for bloqueado, a empresa deve abrir um chamado de suporte diretamente com a Meta, explicando o contexto da migração e solicitando revisão. O tempo de resposta pode variar de alguns dias a semanas, dependendo da gravidade da violação. Por isso, seguir rigorosamente as políticas da API e validar cada etapa da migração é essencial.

Prazos realistas para uma migração completa

O tempo total de uma migração de plataforma no WhatsApp varia conforme a complexidade da operação, mas um cronograma realista para empresas com operação de médio porte (até 10 atendentes e 20 templates ativos) inclui:

Semana 1: Mapeamento da operação atual, documentação de templates e fluxos, reunião técnica com a nova plataforma.
Semana 2: Geração do token de migração, transferência da conta WABA, recriação de templates e submissão para aprovação da Meta.
Semana 3: Reconfiguração de fluxos de automação, integração com CRM/ERP, configuração de webhooks.
Semana 4: Testes de validação em ambiente controlado, ajustes de configuração, treinamento da equipe.
Semana 5: Go-live monitorado, desativação da plataforma antiga, documentação final.

Operações mais complexas, com dezenas de templates, múltiplas integrações e alta dependência de automação, podem exigir de seis a oito semanas de planejamento e execução. Tentar acelerar o processo sem validação adequada aumenta o risco de falhas e retrabalho.

Como preservar o histórico de conversas durante a migração

O histórico de conversas com clientes não é transferido automaticamente entre plataformas porque cada provedor gerencia seu próprio banco de dados. No entanto, empresas que precisam manter o contexto completo do cliente podem adotar três estratégias:

Exportar o histórico da plataforma antiga: A maioria das plataformas oferece exportação de conversas em formato CSV, JSON ou banco de dados. Esse arquivo pode ser armazenado localmente ou importado para um sistema de CRM.
Integrar o histórico ao CRM: Se a empresa utiliza um CRM que centraliza todas as interações com o cliente, as conversas exportadas podem ser associadas ao cadastro de cada contato, mantendo a continuidade.
Manter acesso temporário à plataforma antiga: Durante um período de transição (30 a 60 dias), a equipe pode consultar o histórico na plataforma anterior sempre que necessário, sem enviar novas mensagens.

É importante destacar que, após a migração, a nova plataforma registrará apenas as conversas iniciadas a partir do go-live. Por isso, se um cliente retornar com uma dúvida sobre um atendimento anterior, o agente precisará acessar o histórico exportado ou o CRM para recuperar o contexto completo.

Checklist de validação com o novo fornecedor

Antes de assinar contrato com a nova plataforma e iniciar a migração, o gestor deve validar os seguintes pontos técnicos e comerciais:

Validar esses pontos antes da migração reduz o risco de surpresas técnicas ou comerciais e garante que a nova plataforma oferece os recursos necessários para a continuidade da operação.

Onde a Klyro se encaixa na migração de plataforma

Empresas que operam múltiplos canais digitais e precisam de uma caixa de entrada unificada para WhatsApp, Instagram e outros canais encontram na Klyro uma solução que centraliza a operação e oferece suporte técnico para migração assistida. A plataforma usa a API oficial da Meta (API Cloud) e permite que vários atendentes utilizem o mesmo número de WhatsApp Business, com histórico completo e contexto do cliente.

A Klyro disponibiliza API REST aberta e webhooks para integrar sistemas externos, facilitando a reconfiguração de fluxos de automação e a conexão com CRMs e ERPs. Durante a migração, o time técnico da Klyro acompanha cada etapa do processo, desde a geração do token WABA até a validação final dos fluxos em produção.

Perguntas frequentes

Eu perco o meu número do WhatsApp ao trocar de plataforma?
Não. A migração via API oficial do WhatsApp preserva o número de telefone corporativo. O que muda é apenas o provedor de tecnologia que gerencia a conexão entre a empresa e a API da Meta.

Quanto tempo demora para trocar de plataforma no WhatsApp?
Com a documentação e acessos ao Gerenciador de Negócios da Meta prontos, o processo técnico de migração pode ser concluído em duas a quatro semanas, incluindo recriação de templates, reconfiguração de fluxos e testes de validação.

O meu atendimento vai ficar fora do ar durante a migração?
Se o planejamento for executado corretamente, o tempo de inatividade é mínimo ou nulo. A transferência da conta WABA ocorre em segundo plano, e as mensagens recebidas continuam sendo entregues durante o processo.

O que é o token de migração do WhatsApp (WABA Migration Token)?
É um código de segurança gerado no Gerenciador de Negócios da Meta que autoriza a transferência da gestão do número oficial do WhatsApp de uma plataforma para outra. Sem o token, nenhuma plataforma pode assumir o controle da conta.

O histórico de mensagens da plataforma antiga é transferido automaticamente?
Não. As mensagens anteriores permanecem armazenadas na plataforma de origem ou podem ser exportadas antes da migração. A nova plataforma registrará apenas as conversas iniciadas após a conclusão da troca.

Preciso recriar todos os templates de mensagem na nova plataforma?
Sim. Os templates aprovados pela Meta não são transferidos automaticamente. É necessário recriar cada template na nova plataforma e aguardar nova aprovação antes de utilizá-los em fluxos de automação.

Posso testar a nova plataforma antes de fazer a migração definitiva?
Sim. A maioria das plataformas oferece ambiente de testes (sandbox) ou período de avaliação para validar recursos, configurar fluxos e treinar a equipe antes do go-live.

O que acontece se a migração falhar?
Se a migração falhar por problemas técnicos ou configuração incorreta, a empresa pode reverter o processo e manter a plataforma atual ativa. No entanto, múltiplas tentativas sem sucesso podem acionar revisão manual da conta pela Meta.