Principal Integração com WhatsApp Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento

Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento

Última atualização em May 08, 2026

Quando usar

  • Você está trocando de plataforma de atendimento (Zendesk, Intercom, Zenvia, Twilio, Take Blip, etc.) e precisa trazer o número junto.

Pré-requisitos

Antes de iniciar a migração, confirme todos os itens abaixo. Pular qualquer um pode resultar em perda do número ou bloqueio pela Meta.

  • Acesso ao número para receber SMS ou ligação de verificação

  • Acesso de administrador ao Portfólio Empresarial na Meta

  • Status do Portfólio Empresarial: "Verificada"

  • Status da WABA: "Aprovada"

  • Status do número: "Conectado"

  • Verificação de dois fatores desativada do número na WABA (etapa mais crítica — veja abaixo)

  • Cartão de crédito habilitado para pagamento em dólar — obrigatório em migração de plataforma de atendimento ou para disparos proativos

Passo a passo da migração

Etapa 1 — Confirmar status do Portfólio Empresarial

Validando o Status do Portfólio Empresarial

O Portfólio Empresarial (Business Portfolio) precisa estar com o status "Verificada" na Meta. Isso significa que a Meta reconheceu e validou a identidade da sua empresa.

Por que isso importa? Sem a verificação, você está sujeito a limites muito baixos de envio (até 250 mensagens/dia), não pode migrar números de outros provedores e pode ter restrições em funcionalidades da API. A verificação é o primeiro requisito para uma operação saudável na plataforma da Meta.

Como verificar:

  1. Acesse business.facebook.com/settings/info

  2. Verifique o campo Status da verificação

  3. Deve estar como "Verificada" ✅

Se estiver como "Não verificada" ou "Pendente", clique em Iniciar verificação e siga o processo com documentos e domínio da empresa antes de continuar.

Etapa 2 — Confirmar propriedade da WABA e validar os pré-requisitos

O que é a WABA?

WABA significa WhatsApp Business Account — é a entidade criada pela Meta que representa a conta oficial do WhatsApp da sua empresa. É através da WABA que um número de telefone é conectado à API oficial e vinculado a um provedor de atendimento (como o Cloud Chat).

A WABA fica sempre dentro de um Portfólio Empresarial (Business Portfolio) na Meta. Quem detém esse portfólio é, na prática, o dono da WABA.

⚠️ Em muitos casos, o provedor anterior criou e mantém a WABA no portfólio deles — e não no seu. Isso significa que você não tem controle administrativo sobre o seu próprio número. Antes de migrar, é fundamental confirmar onde a sua WABA está.

Como confirmar que você é o dono da WABA:

  1. Acesse o Business Manager da Meta

  2. No menu lateral, vá em Configurações → WhatsApp Accounts

  1. Você pode localizar a WABA correspondente ao seu número na listagem ou utilizando a barra de busca.

Se ela aparecer no seu portfólio → você tem controle. Siga para a validação dos pré-requisitos abaixo.

Se ela não aparecer (ou estiver no portfólio do provedor anterior) → acione nosso time de suporte antes de continuar. Será necessário solicitar a transferência da WABA para o seu portfólio antes de migrar.

Validando o Status da WABA: "Aprovada"

Com a WABA localizada no seu portfólio, confirme que o status dela está como "Aprovada":

  1. Ainda no WhatsApp Manager, localize sua WABA

O status deve aparecer como "Aprovada" ✅. Além disso, deve existir uma forma de pagamento válida cadastrada em "Payment Settings".

Se estiver como "Restrita" ou "Sinalizada", a WABA tem pendências junto à Meta que precisam ser resolvidas antes da migração.

Validando o Status do número: "Conectado"

O número que será migrado precisa estar com status "Conectado" na WABA:

  1. Dentro da WABA, vá em WhatsApp Manager. Uma nova aba será aberta no seu navegador com a listagem dos números vinculados na WABA selecionada.

O número deve aparecer com o status "Conectado" ✅

Se estiver como "Desconectado" ou "Offline", é necessário resolver essa situação antes de iniciar a migração.

Etapa 3 — Desativar a Verificação de Dois Fatores da WABA

Esta é a etapa mais crítica e a que mais causa problemas em migrações.

A verificação de dois fatores (Two-Step Verification) é um PIN de segurança configurado no número dentro da WABA. Enquanto estiver ativa, a Meta não permite que o número seja migrado para outro provedor.

Como desativar:

  1. Acesse o WhatsApp Manager

  2. Selecione o número que será migrado

  3. Clique em Configurações → Verificação em dois passos

  1. Clique em Desativar

⚠️ Se o seu provedor atual controla o Two-Step Verification (situação comum quando a WABA foi criada pelo provedor), você precisará solicitar a eles que desativem. Sem isso, a migração não é tecnicamente possível.

Etapa 4 — Iniciar a integração com o Cloud Chat

Com todos os pré-requisitos validados, você já pode iniciar a integração. Para isso, tenha em mãos:

  • Acesso de administrador ao Portfólio Empresarial na Meta (necessário para autorizar a conexão no fluxo de Embedded Signup)

  • Acesso ao número para receber o código de verificação por SMS ou ligação

  • Cartão de crédito válido para pagamento em dólar — durante o processo, o Cloud Chat criará uma nova WABA vinculada ao seu portfólio com a Cloud Humans como parceira (Tech Provider) na Meta. Essa WABA precisará de uma forma de pagamento cadastrada

📌 Como funciona a WABA criada pelo Cloud Chat?
Ao integrar, o Cloud Chat cria uma WABA dentro do seu portfólio na Meta, com a Cloud Humans registrada como parceira (Tech Provider). Isso significa que você permanece dono da sua WABA — a Cloud Humans apenas opera como o canal técnico de conexão com a API. Você pode desvincular a qualquer momento sem perder o número.

Escolha o modelo de integração e siga o passo a passo correspondente:

Se ainda não sabe qual modelo de integração escolher (com ou sem coexistência), leia primeiro o Guia Mestre.

Etapa 5 — Validar com o time da Cloud

Antes de iniciar a conexão, envie para nosso time a confirmação de que todos os pré-requisitos foram validados. Isso garante suporte imediato em caso de qualquer intercorrência durante o processo.

Observações

  • A migração pode levar de alguns minutos dependendo do provedor anterior e da resposta da Meta.

  • Após a migração, o histórico de mensagens do provedor anterior não é importado automaticamente — mensagens antigas ficam no sistema do provedor anterior.

  • Se precisar importar tickets antigos para o Cloud Chat, isso é possível via API. Consulte: Import de histórico de tickets.

  • Nunca faça ajustes se estiver em dúvida — um erro nesse processo pode gerar bloqueio do número. Acione o suporte antes de prosseguir.

  • Documentação oficial da Meta sobre migração entre provedores: Meta Developers — Migrating phone numbers.