Principal Conexões com canais externos (caixas de entrada) Validações importantes antes de realizar conexão de números WhatsApp no Cloud Chat ⚠️

Validações importantes antes de realizar conexão de números WhatsApp no Cloud Chat ⚠️

Última atualização em Nov 03, 2025

Objetivo

Garantir que a conexão de números de WhatsApp no CloudChat seja realizada de forma correta, segura e padronizada. Este artigo define os pré-requisitos, cuidados e os fluxos recomendados para garantir a celeridade da conexão.

Glossário de termos importantes da Meta

  • WhatsApp Business App -> Aplicativo do Whatsapp Business no celular

  • Número WhatsApp -> Número de telefone representado na Meta. Não necessariamente é um número físico real, mas também pode ser

  • Business Portfolio / Portfólio Meta -> Um Business Portfolio é um espaço da Meta que reúne todos os ativos de uma empresa — como números WhatsApp, páginas do Facebook, contas do Instagram, contas de anúncios, catálogos de produtos e outros recursos — para que tudo possa ser gerenciado em um só lugar

  • WABA (WhatsApp Business Account) -> É a entidade de conexão entre um número WhatsApp e um Business Portfolio

  • Busines Manager -> É a "aba de configurações" dentro do seu Business Portfolio

  • WhatsApp Manager -> Fica dentro do Business Manager, ao lado de Instagram Manager, etc.

  • Solution Provider -> A Cloud Humans é um Solution Provider, capaz de conectar o seu número ao seu portfólio Meta e de se integrar ao seu número via API para garantir o gerenciamento completo no Cloud Chat

Riscos

O processo de conexão ou migração de números é sensível. Caso os passos não sejam seguidos corretamente, podem ocorrer problemas sérios, como:

  • Perda do número do WhatsApp

  • Bloqueio do número por tempo indeterminado

  • Dificuldade de liberar o número caso o antigo provedor ainda tenha controle

No modelo de integração do CloudChat, o cliente é o proprietário da sua WABA.

O CloudChat atua apenas como Solution Provider conectado após autorização via processo de Embedded Signup.

Nossa filosofia é que o cliente deve ser dono dos seus ativos de atendimento — assim como ocorre com email, domínio, Instagram e outros canais. Não mantemos a propriedade da WABA dos clientes e não desejamos criar dependência técnica dessa forma.

Cuidados Essenciais

Ter acesso ao chip ou aparelho telefônico para receber SMS ou ligações não significa ter controle administrativo da conta na Meta! Para conectar ou migrar um número corretamente, é obrigatório que o número esteja sob o portfólio do cliente na Meta, com acesso administrativo. Mais detalhes logo a seguir.

Conexão com Coexistência

Se a conexão do número será feita com coexistência (em paralelo com o WhatsApp Business no celular físico), consulte a documentação específica:

  • Guia de configuração com coexistência aqui.

  • Não sabe o que é coexistência? Leia esse artigo.

Pré-requisitos para iniciar a integração

1. Número novo ✅

1.1 - Um número é considerado novo quando nunca foi utilizado anteriormente em:

  • Nenhum WhatsApp Business App anterior

  • Qualquer conexão via provedor, Solution Partner ou BSP

  • Cadastro de WABA na Meta

1.2 - Antes de iniciar a conexão, você deve possuir em mãos:

  • Um Business Portfolio configurado na Meta.

  • Acesso de administrador ao Business Portfolio.

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

  • O Business Portfolio deve estar com status “Verified”

  • Forma de pagamento válida:

    • Obrigatória apenas caso o número seja utilizado para disparos proativos.

    • Para uso apenas em atendimento reativo, não é obrigatório.

É imprecindível confirmar que todos os itens acima estão atendidos antes de iniciar o processo.

2. Número existente (já conectado em outro provider) ⚠️

Se o número já foi conectado anteriormente a outro Solution Provider ou ao Whatsapp Business App, é necessário validar que a propriedade da sua WABA.

Documentação oficial da Meta com os pré-requisitos para migração aqui. Resumo abaixo:

2.1 - Requisitos exigidos pela Meta para migração

Para confirmar os itens abaixo acesse seu Business Manager:

Siga para as configurações de WABA:

Em seguida busque a WABA correspondende ao seu número na listagem ou através da barra de busca:

Ao encontrar a WABA desejada, clique em Whatsapp Manager:

Após isso, uma nova aba será aberta no seu navegador com a listagem dos números da WABA selecionada.

Com ambas as abas em mãos, os seguintes pontos devem ser validados:

  • O número conectado deve estar com o status “Connected”.

  • O Business Manager deve estar com o status “Verified”.

  • A WABA deve estar com status “Approved”. Além disso, deve existir uma forma de pagamento válida cadastrada em “Payment Settings”.

  • A verificação em duas etapas (Two-Step Verification) do número deve ser desativada antes da migração. Essa etapa parece um detalhe, mas é muito crítica!

    • Você seja dono da WABA, basta desativar através do WhatsApp Manager:

    • Caso contrário, será necessário solicitar ao seu provedor atual que desative o Two Step Verification.

2.2 - Após a confirmação acima, basta possuir em mãos:

  • Acesso de administrador do seu portfólio Meta.

  • Ter acesso ao número para receber SMS ou ligação telefônica.

  • Ter uma forma de pagamento válida (migração sempre exige, diferente de número novo para uso apenas reativo).

  • O recurso de Message History também deve estar desativado antes da migração (pode ser reativado após a conclusão).

3. Validação pelo time CloudChat

Antes de iniciar a conexão ou migração, favor enviar para nosso time a confirmação desses passos acima.

Caso haja dúvida ou dificuldade em qualquer etapa mencionada acima, não hesite em acionar nosso time de suporte para orientação. Evite fazer ajustes se estiver na dúvida!