--- title: "Como migrar de provedores de API do WhatsApp sem perder seu número ou modelos" description: "Saiba como migrar um número da API do WhatsApp e modelos qualificados entre provedores, incluindo verificações WABA, 2FA, backup, Webhooks, testes e cancelamento." canonical: "https://www.ycloud.com/pt/blog/migrate-whatsapp-api-provider-number-templates" language: "pt" datePublished: "2026-07-22T07:00:00.000Z" dateModified: "2026-08-22T07:02:15.386Z" author: "Team YCloud" categories: - "Guia📘" --- # Como migrar de provedores de API do WhatsApp sem perder seu número ou modelos ![How to Migrate WhatsApp API Providers Without Losing Your Number or Templates — YCloud Blog cover](https://static-blog.ycloud.com/migrate_whatsapp_api_provider_number_templates_cover_1800x1200_fcd630f796.png) Normalmente, você pode mover um número de telefone elegível da Plataforma WhatsApp Business de um provedor para outro, mantendo o número e os atributos importantes da conta, mas você não deve presumir que todos os modelos, mensagens ou fluxos de trabalho serão transferidos. Uma migração segura verifica a propriedade do Meta Business, a prontidão do WABA de destino, a aprovação do nome de exibição, os requisitos de pagamento e região de dados, o acesso ao número, a verificação em duas etapas, os modelos qualificados, os Webhooks, as credenciais do aplicativo, o backup do histórico e a validação pós-corte antes que o serviço antigo seja cancelado. ## Entenda o que está realmente sendo movido Uma migração de provedor do WhatsApp normalmente altera o provedor ou a plataforma através da qual um número de telefone é conectado e operado. Não é uma transferência de toda a sua aplicação de atendimento ao cliente ou marketing. Separe o projeto em três camadas: 1. **Camada de conta Meta:** Portfólio de Negócios Meta, Conta de Negócios WhatsApp (WABA), número de telefone, nome de exibição, classificação de qualidade, limite de mensagens, status de Conta de Negócios Oficial, quando aplicável, e modelos de mensagem. 2. **Camada de conexão do provedor:** relacionamento de onboarding, credenciais, endpoints de mensagem, configuração de Webhook, faturamento, logs e objetos específicos do provedor. 3. **Camada de aplicação de negócios:** Histórico de caixa de entrada, atribuições, notas, campos de contato, registros de consentimento, segmentos, campanhas, automações, conhecimento de IA, integrações, relatórios e IDs de mensagens internas. A documentação dos provedores YCloud, Twilio, 360dialog e respond.io indica que atributos importantes do número e modelos qualificados podem ser retidos ou duplicados em migrações suportadas. Também mostra por que garantias gerais são inseguras: modelos de baixa qualidade, rejeitados, pendentes ou de outra forma inelegíveis podem não ser movidos; a qualidade do modelo pode ser redefinida ou revisada; conversas históricas e objetos de fluxo de trabalho específicos do provedor podem seguir regras diferentes. ## O que Pode Comumente Ser Retido A documentação atual do provedor identifica amplamente o seguinte como retido em uma migração elegível de provedor para provedor: - o número de telefone; - nome de exibição aprovado; - classificação de qualidade do número de telefone; - nível de limite de mensagens; - status de Conta de Negócios Oficial, quando a conta o possui; e - modelos aprovados qualificados. As regras exatas variam. O Twilio diz que o Meta duplica modelos de alta qualidade no WABA de destino e os revisa novamente; alguns podem ser rejeitados, e a qualidade dos modelos duplicados começa como desconhecida. O YCloud diz que modelos aprovados de média/alta qualidade são sincronizados, enquanto modelos de baixa qualidade ou inutilizáveis não são e a qualidade do modelo recomeça. O respond.io exclui similarmente modelos de baixa qualidade, rejeitados ou pendentes. Trate essas fontes como orientações específicas para o destino, não como uma promessa universal. Peça ao seu provedor selecionado para confirmar as regras atuais para o seu WABA de origem, WABA de destino, portfólio de negócios e caminho de migração por escrito. ## O que Comumente Não Se Move Automaticamente Não assuma que o seguinte será transferido com o número: - conteúdo de conversas históricas armazenado pelo provedor antigo; - Atribuições de caixa de entrada, comentários internos, tags ou status de caso; - registros de contato do provedor e atributos personalizados; - definições de campanhas e análises de campanhas passadas; - configuração de fluxo de trabalho, bot, Jornada ou agente de IA; - mapeamentos de CRM e integrações de comércio eletrônico; - credenciais de API, URLs de endpoint ou segredos de Webhook; - IDs de mensagens do provedor e histórico de logs; ou - plano, saldo, créditos e arranjos de suporte. O guia de migração de números do YCloud diz explicitamente que os registros de chat históricos não são migrados e aconselha fazer backup deles com o provedor original. O respond.io descreve a proteção para seus próprios fluxos de trabalho e transmissões existentes ao mover um canal já conectado para a oferta de provedor do respond.io; isso não deve ser generalizado para fluxos de trabalho arbitrários armazenados no sistema de um fornecedor diferente. Crie um inventário artefato por artefato e designe um proprietário para exportar, reconstruir, validar ou deliberadamente aposentar cada item. ## Passo 1: Congele o Escopo e Selecione uma Janela de Mudança Documente as contas de origem e destino e os IDs do WABA, Meta Business Portfolio, número de telefone, nome de exibição, região de dados, modelos ativos, aplicativos de envio e Webhook, dependências operacionais e pessoas responsáveis. Escolha uma janela de menor risco, pause envios de campanhas não essenciais e defina um ponto de decisão claro para prosseguir ou escalar. Não prometa "tempo de inatividade zero". Alguns provedores descrevem a migração como sem tempo de inatividade, enquanto outras transições documentadas podem ter uma interrupção breve. Planeje mensagens atrasadas ou falhas até que sua própria validação prove o contrário. ## Etapa 2: Confirmar a Preparação do Negócio e do WABA Guias de migração de provedores geralmente exigem uma configuração saudável e devidamente propriedade. Verifique se o Business Portfolio e o WABA de origem estão ativos e acessíveis, o WABA de destino está pronto, pagamentos ou faturas atendem aos requisitos aplicáveis, o nome de exibição está aprovado sem mudanças pendentes, regiões de dados são compatíveis quando relevantes, administradores podem acessar o WhatsApp Manager, e o destino tem espaço para o número. O guia de migração atual da Twilio diz que o WABA de origem e o novo WABA de destino devem usar a mesma região de localização de dados durante o registro. YCloud descreve a movimentação entre WABAs na mesma conta do Business Manager. Como os designs de integração diferem, siga as instruções atuais do provedor de destino em vez de copiar etapas de outro fornecedor. ## Etapa 3: Garantir Acesso ao Número de Telefone O fluxo de migração geralmente requer verificação do número usando uma senha única por SMS ou voz. Confirme que sua equipe pode recebê-la antes da janela de mudança, incluindo para números virtuais ou números por trás de um IVR. Registre quem controla o número, quem pode receber o código, se SMS ou chamadas internacionais funcionam, qualquer roteamento IVR e o método de fallback. Não tente repetidamente sem entender uma falha. ## Etapa 4: Desativar a Verificação em Duas Etapas no Momento Correto Instruções de migração da YCloud, Twilio, 360dialog e respond.io identificam a desativação da verificação em duas etapas do WhatsApp para o número como uma etapa de preparação. Se sua equipe não puder alterá-la diretamente, o provedor existente ou o administrador da conta Meta podem precisar ajudar. Trate isso como uma mudança de segurança controlada: identifique o proprietário, desative-a próximo à migração, limite o acesso durante a janela, complete a verificação e restaure os controles de segurança recomendados após a validação. Não a desative dias antes sem um motivo. ## Etapa 5: Fazer Backup dos Modelos e Classificar Seu Risco Exporte ou registre cada modelo que suas aplicações usam, incluindo: - nome do modelo e idioma; - categoria; - componentes, variáveis, mídia e botões; - estado atual de aprovação e qualidade; - proprietário do negócio e caso de uso; - código da aplicação ou fluxo de trabalho que o chama; e - volume de envio recente e criticidade. Classifique os modelos como críticos, substituíveis ou obsoletos. Destaque modelos pendentes, rejeitados, pausados, desativados, de baixa qualidade ou recentemente editados porque podem não se qualificar para migração. Após a transição, compare a lista de modelos de destino com o inventário. Twilio alerta que modelos duplicados são revisados e alguns podem ser rejeitados. Identificadores de modelos específicos do provedor também podem mudar, então atualize os mapeamentos da aplicação em vez de presumir que o identificador antigo funcionará. ## Etapa 6: Exportar a Camada de Aplicação do Negócio Preserve os registros necessários para operações e conformidade: contatos e consentimento, listas de supressão, casos abertos, atributos do cliente, histórico permitido, registros de campanhas, lógica de automação, configuração de IA, integrações e baselines de relatórios. Verifique formato, completude, timestamps, identificadores, criptografia e retenção. Um CSV de contatos não é um backup completo se os fluxos de trabalho dependem do contexto de mensagens ou casos. ## Etapa 7: Preparar o Destino Antes da Transição Antes de tocar no número de produção, prepare usuários, funções, esquema de contatos, roteamento da Caixa de Entrada, automação aprovada, mapeamentos de sistema, receptor de Webhook autenticado, monitoramento, credenciais armazenadas com segurança e um plano de teste para cada caminho de mensagem crítico. Se o destino for YCloud, isso pode incluir configurar sua Caixa de Entrada, Contato, Campanha, Jornada, Chatbot, Agente de IA e conexões de API/Webhook de acordo com as partes que sua equipe usará. Se o destino for voltado para API, prepare seus próprios sistemas operacionais e camada de integração. ## Etapa 8: Executar a Migração Orientada pelo Provedor Siga o fluxo de inscrição ou migração embutido atual do provedor de destino. Geralmente, o processo pede que você selecione o Meta Business Portfolio existente, use ou crie o WABA de destino apropriado, insira o número de telefone existente e o verifique com a senha única. Evite improvisar com etapas de um post de blog antigo. Os requisitos de migração mudam, e o provedor de destino é responsável por seu fluxo de integração atual. ## Etapa 9: Reconectar APIs, Webhooks e Mapeamentos de Mensagens Uma mudança de número bem-sucedida não reconecta sua aplicação automaticamente. Atualize URLs ou SDKs, credenciais e escopos, identificadores de remetente/WABA/modelo, verificação de Webhook, análise de eventos, lógica de repetição e idempotência, destinos a jusante e limites de monitoramento. Mantenha a integração antiga de enviar após a transição, mas preserve o acesso somente leitura aos logs históricos até que as regras de retenção e contrato permitam o fechamento. ## Etapa 10: Executar uma Validação em Camadas Valide o número e o nome de exibição primeiro, depois modelos qualificados, aceitação e eventos de status de saída, entrega de Webhook e Caixa de Entrada de entrada, resposta do agente, uma automação aprovada, controles de consentimento/supressão e reconciliação de CRM/relatórios. Utilize destinatários controlados e um caso negativo. Mantenha o volume da campanha baixo até que a entrega, respostas e roteamento permaneçam estáveis. ## Etapa 11: Estabilize e Depois Cancele o Serviço Antigo Não cancele a assinatura de origem antes que o destino seja validado, a menos que o processo dos provedores exija explicitamente uma sequência diferente. O 360dialog, por exemplo, orienta clientes que estão migrando a liquidar faturas, desativar a autenticação de dois fatores, concluir a migração com o novo provedor e, em seguida, cancelar a assinatura do número antigo para evitar cobranças adicionais. Após a estabilização, confirme que nenhum tráfego crítico atinja o endpoint antigo, exporte logs e faturas permitidos, cancele serviços antigos, remova acessos obsoletos, restaure configurações de segurança necessárias, atualize a documentação operacional e registre o que foi e o que não foi migrado. ## Escolha um Destino que Corresponda ao Modelo Operacional A migração é um bom momento para decidir se você precisa apenas de uma conexão por API ou de uma camada operacional completa do WhatsApp. Equipes lideradas por desenvolvedores com sistemas existentes podem preferir Twilio ou um provedor de API focado em WhatsApp, como o 360dialog. Equipes que desejam suporte, marketing, automação, dados do cliente, IA e integrações juntos devem incluir o YCloud na avaliação. Equipes de conversação multicanal também podem avaliar o respond.io ou plataformas similares. Use a [Lista curta de provedores da API do WhatsApp](https://www.ycloud.com/blog/whatsapp-api-provider-recommendation) e o [Guia de seleção de BSP](https://www.ycloud.com/blog/whatsapp-bsp-selection) antes de escolher o destino. A migração mais segura começa com a adequação ao comprador, propriedade clara e um caminho de saída testado—não com uma transferência de número de última hora. ## Perguntas Frequentes ### Posso manter meu número de telefone do WhatsApp ao mudar de provedor? Um número elegível da Plataforma de Negócios do WhatsApp geralmente pode ser migrado, sujeito aos requisitos da Meta e do provedor. Confirme a propriedade do negócio, prontidão do WABA, status do nome de exibição, acesso ao número, condições de pagamento ou fatura, verificação em duas etapas e elegibilidade do destino. ### Todos os meus modelos do WhatsApp serão transferidos para o novo provedor? Não assuma isso. A documentação atual do provedor diz que modelos aprovados e qualificados podem ser duplicados ou sincronizados, enquanto modelos de baixa qualidade, rejeitados, pendentes ou não elegíveis podem não ser transferidos. Revisões ou novos identificadores também podem exigir alterações no aplicativo. ### O histórico de conversas do WhatsApp migra com o número? A migração de número entre provedores não deve ser tratada como uma transferência de histórico de conversas. O YCloud afirma explicitamente que registros históricos de chat não migram em seu fluxo de migração de números. Exporte o histórico permitido e verifique as opções de importação do destino separadamente. ### A migração de provedor do WhatsApp garante que não haverá tempo de inatividade? Nenhuma promessa universal de tempo zero de inatividade é segura. Planeje uma janela controlada, pause envios não essenciais, teste o destino em camadas e prepare a escalada. A interrupção real depende do caminho de migração e dos sistemas circundantes. ### Quando devo cancelar meu provedor antigo? Geralmente após o número de destino, modelos, APIs, Webhooks, Inbox e fluxos de trabalho críticos terem passado pela validação, a menos que as instruções do provedor exijam o contrário. Também liquide faturas, exporte os dados necessários e confirme o cancelamento para evitar cobranças contínuas. ## Frequently Asked Questions ### Posso manter meu número do WhatsApp ao trocar de operadora? Um número elegível da Plataforma WhatsApp Business geralmente pode ser migrado, sujeito aos requisitos da Meta e do provedor. Confirme a propriedade da empresa, a prontidão do WABA, o status do nome de exibição, o acesso ao número, as condições de pagamento ou fatura, a verificação em duas etapas e a elegibilidade do destino. ### Todos os meus modelos do WhatsApp serão transferidos para o novo provedor? Não assuma isso. A documentação atual do provedor afirma que modelos qualificados e aprovados podem ser duplicados ou sincronizados, enquanto modelos de baixa qualidade, rejeitados, pendentes ou inelegíveis podem não ser transferidos. Reavaliações ou novos identificadores também podem exigir alterações no aplicativo. ### O histórico de conversas do WhatsApp migra com o número? A migração de números entre provedores não deve ser tratada como uma transferência de histórico de chat. A YCloud afirma explicitamente que os registros de chat históricos não são migrados em seu fluxo de migração de números. Exporte o histórico permitido e verifique separadamente as opções de importação do destino. ### A migração de provedor do WhatsApp é garantida sem tempo de inatividade? Nenhuma promessa universal de zero tempo de inatividade é segura. Planeje uma janela controlada, pause os envios não essenciais, teste o destino em camadas e prepare a escalada. A interrupção real depende do caminho da migração e dos sistemas circundantes. ### Quando devo cancelar meu antigo provedor? Geralmente, após o número de destino, modelos, APIs, Webhooks, Caixa de Entrada e fluxos de trabalho críticos terem passado pela validação, a menos que as instruções do provedor exijam o contrário. Além disso, liquide faturas, exporte os dados necessários e confirme o cancelamento para evitar cobranças contínuas. --- Canonical HTML: https://www.ycloud.com/pt/blog/migrate-whatsapp-api-provider-number-templates