Documentação / Comece Aqui / API Oficial / Cloud API QR Code (Coexistência)
Comece Aqui · API Oficial

Cloud API QR Code (Coexistência)

Nesta modalidade, o número é vinculado ao Chat C&M pela leitura de um QR Code no celular, sem perder o aplicativo. É o que chamamos de coexistência: o mesmo número continua funcionando no WhatsApp Business do aparelho e, ao mesmo tempo, opera pela API oficial dentro da plataforma. Reunimos aqui os três guias da modalidade: conectar o canal, desativar as contas de anúncio criadas automaticamente pela Meta e desconectar o número quando for necessário.

01 Conectar o canal

A conexão por QR Code liga o seu número à API oficial da Meta mantendo o aplicativo ativo no celular. O número precisa já estar no seu portfólio empresarial; o restante é feito no Chat C&M, terminando com a leitura do código pelo aparelho.

✅

Pré-requisitos: número cadastrado no WhatsApp Business; Portfólio Empresarial configurado; perfil de administrador no Chat C&M; página do Facebook vinculada à conta do WhatsApp Business; e o celular em mãos, porque o código da Meta e a leitura do QR Code acontecem dentro do aplicativo.

1
Inicie a integração

No menu superior do Chat C&M, clique em Ajustes → Conta. Abra a aba Canais de Atendimento, clique no botão de adição (+), navegue até WhatsApp QRCode e selecione Cloud Meta (QRCode).

Em Ajustes → Conta → Canais de Atendimento, clique no (+) e selecione Cloud Meta (QRCode).
Em Ajustes → Conta → Canais de Atendimento, clique no (+) e selecione Cloud Meta (QRCode).
2
Entre com o Facebook

Clique em Entrar com Facebook e faça login na conta que administra o seu Gerenciador de Negócios.

3
Selecione o portfólio

Escolha o Portfólio empresarial correspondente, confira os dados da empresa (nome, site e país) e clique em Avançar.

4
Escolha a configuração de coexistência

Marque a opção Conecte seu app WhatsApp Business existente e clique em Avançar. É essa escolha que mantém o número funcionando no aplicativo.

Marque “Conecte seu app WhatsApp Business existente” e clique em Avançar.
Marque “Conecte seu app WhatsApp Business existente” e clique em Avançar.
5
Informe o número

Selecione o código do país (BR +55) e digite o número que deseja conectar.

6
Confirme o código recebido no aplicativo

Diferente da Cloud API tradicional, aqui a Meta envia o código dentro do próprio aplicativo do WhatsApp. Abra o app, copie o código, insira na tela e clique em Avançar.

Insira o código de verificação recebido no aplicativo do WhatsApp.
Insira o código de verificação recebido no aplicativo do WhatsApp.
7
Confirme o nome de exibição e o fuso

Revise o nome de exibição (Display name) e o fuso horário, depois clique em Avançar.

8
Autorize a conexão

Será exibida a tela de autorização do parceiro de integração com a Meta. Clique em Continuar para prosseguir.

9
Leia o QR Code pelo celular

Uma mensagem chegará no app do WhatsApp Business pedindo a leitura do código. Toque nela e escaneie o QR Code exibido na tela do computador.

No aplicativo, toque na mensagem recebida e leia o QR Code.
No aplicativo, toque na mensagem recebida e leia o QR Code.
10
Adicione a forma de pagamento

Clique em adicionar forma de pagamento e depois em Continuar. O cadastro é feito no Gerenciador de Negócios da Meta.

11
Finalize a conexão

Selecione o número que está sendo integrado, clique em Continuar e depois em Finalizar. O canal já aparece disponível em Canais de Atendimento.

Selecione o número que está integrando e clique em Continuar.
Selecione o número que está integrando e clique em Continuar.
⚠️

Atenção: nem todo número é elegível. A Meta avalia o histórico de uso antes de liberar a vinculação e, se o número for recusado, um aviso aparece durante o processo — nesse caso, use a conexão padrão da Cloud API. A conexão também é desativada automaticamente após 14 dias sem atividade.

ℹ️

Importante saber: o WhatsApp Desktop para Windows deixa de funcionar após a migração, e a sincronização de contatos e conversas anteriores ainda não está disponível. Canais, Status, enquetes, eventos e localização em tempo real não são suportados pela API oficial, mas seguem funcionando pelo aplicativo. O número pode ser vinculado e desvinculado quando quiser.

O que muda no aplicativo WhatsApp Business

  • Não é mais possível criar listas de transmissão — as existentes passam a ser apenas leitura;
  • Outros dispositivos, como o WhatsApp Web, são desconectados no momento do vínculo, mas podem ser reconectados depois;
  • Editar e excluir mensagens deixa de funcionar;
  • Mensagens temporárias e visualização única não podem mais ser usadas;
  • Se você reiniciar uma conversa pelo aplicativo, é preciso aguardar a resposta do contato para seguir pela plataforma.

02 Desativar contas de anúncio

Toda vez que um número é conectado por QR Code, a Meta cria automaticamente uma conta de anúncios dentro do Gerenciador de Negócios. Ela não é usada pela API e pode ser desativada sem prejuízo. Vale fazer essa limpeza de tempos em tempos: existe um limite de contas por gerenciador e, quando ele é atingido, novas conexões passam a ser bloqueadas.

✅

Pré-requisitos: acesso ao Gerenciador de Negócios com permissão de administrador e acesso à seção de Configurações de Negócio da Meta.

1
Acesse o Gerenciador de Negócios

Entre com o usuário administrador, selecione o gerenciador em que a conta de anúncio foi criada e clique em Configurações, na lateral esquerda. Na página que abrir, role até o fim e selecione Configurações da conta de anúncio.

Na lateral esquerda das Configurações, role até o fim e clique em Configurações da conta de anúncio.
Na lateral esquerda das Configurações, role até o fim e clique em Configurações da conta de anúncio.
2
Localize a opção de desativação

Na nova aba, logo abaixo da seção Pagamentos da empresa, encontre e clique em Desativar conta de anúncios.

Abaixo de Pagamentos da empresa, clique em Desativar conta de anúncios.
Abaixo de Pagamentos da empresa, clique em Desativar conta de anúncios.
3
Escolha o motivo e confirme

Um pop-up será exibido. Selecione o motivo mais adequado e clique novamente em Desativar conta de anúncios. A tela atualiza e a conta sai da lista.

ℹ️

A criação automática dessa conta faz parte do processo padrão da Meta e não interfere no funcionamento do número conectado. Desativá-la é uma questão de organização e de manter espaço livre para as próximas conexões.

03 Desconectar

Quando for preciso trocar o número, reorganizar a estrutura ou refazer a conexão do zero, a desvinculação é feita pelo próprio aplicativo WhatsApp Business no celular — e não pelo Gerenciador de Negócios. Depois de desconectado, o número fica livre para uma nova integração.

✅

Pré-requisitos: acesso de administrador ao portfólio empresarial onde o número está configurado e o aparelho em que o número está conectado.

⚠️

Atenção: ao remover o número, todas as mensagens, sessões e modelos relacionados a ele são perdidos. Faça backup do que for importante antes de prosseguir.

1
Abra as configurações do aplicativo

No WhatsApp Business do celular, toque nos três pontinhos no canto superior direito, depois em Configurações e em Conta.

2
Entre em Plataforma Comercial

Toque em Plataforma Comercial para ver a conexão ativa.

Em Conta, toque em Plataforma comercial.
Em Conta, toque em Plataforma comercial.
3
Toque para desconectar

O parceiro de integração responsável pela conexão aparecerá na tela. Toque em Toque para desconectar e, na tela seguinte, em Avançar.

O parceiro de integração aparece na tela — toque em “Toque para desconectar”.
O parceiro de integração aparece na tela — toque em “Toque para desconectar”.
4
Confirme a desconexão

Na tela de confirmação, toque em Desconectar. Em seguida, a tela de nova conexão aparece — sinal de que o vínculo anterior foi encerrado e outro dispositivo já pode ser conectado.

Na tela de confirmação, toque em Desconectar.
Na tela de confirmação, toque em Desconectar.
ℹ️

Depois da remoção, o número pode ser reconectado por QR Code oficial ou por outro método suportado, respeitando as diretrizes da Meta. Essa ação também encerra o acesso por QR Code de outras ferramentas, como o WhatsApp Web. Se a intenção for migrar o número para outra conta ou provedor, confirme que ele está totalmente desvinculado e respeite o tempo de retenção da Meta, que pode chegar a 30 dias.

Suporte