Documentação / Comece Aqui / API Oficial / Cloud API
Comece Aqui · API Oficial

Cloud API

A Cloud API é a API oficial da Meta para o WhatsApp Business. Com ela, sua empresa envia e recebe mensagens de forma segura e escalável, usando a infraestrutura direta da Meta. Nessa modalidade de conexão, o número fica dedicado exclusivamente à API — ou seja, não é possível continuar usando o aplicativo WhatsApp Business com o mesmo número. Reunimos aqui todos os guias em uma página só: como conectar o canal, fazer portabilidade de número, ajustar o nome de exibição, editar o perfil comercial e remover o número do portfólio.

01 Conectar o canal

Conectar o canal WhatsApp Cloud API é o método tradicional para vincular sua conta de WhatsApp ao Chat C&M de forma segura. Esse processo garante a comunicação entre a API e o WhatsApp Business, permitindo o envio e o recebimento de mensagens dentro do sistema.

✅

Pré-requisitos: ter um número cadastrado no WhatsApp Business; o número não pode estar conectado ao aplicativo no celular (se estiver, desconecte antes de finalizar); ter um Portfólio Empresarial (Meta Business Suite) configurado; ser administrador no Chat C&M e no Facebook; e ter acesso ao número para receber o código de verificação por SMS ou ligação.

1
Inicie a integração

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

Em Ajustes → Conta → Canais de Atendimento, clique no (+) e selecione Cloud Meta.
Em Ajustes → Conta → Canais de Atendimento, clique no (+) e selecione Cloud Meta.
2
Configure o número

Selecione a opção Conectar novo número.

⚠️

Atenção: ao vincular o número na Cloud API, você não poderá mais utilizá-lo no aplicativo do WhatsApp.

Selecione
Selecione “Conectar novo número” e clique em Iniciar.
3
Entre com o Facebook

Na tela de parceria, clique em Entrar com Facebook para iniciar o onboarding oficial. Faça login na conta do Facebook que administra o seu Gerenciador de Negócios.

Clique em
Clique em “Entrar com Facebook” para iniciar o onboarding oficial.
4
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.

Selecione o Portfólio empresarial e confira os dados da empresa.
Selecione o Portfólio empresarial, confira os dados da empresa e clique em Avançar.
5
Informe o número e confirme o código

Selecione o código do país (BR +55), digite o número que deseja conectar e clique em Avançar. É para esse número que a Meta enviará o código de verificação de 6 dígitos, por SMS ou ligação. Insira o código recebido e clique em Avançar.

Informe o número que vai receber o código de verificação.
Informe o número que vai receber o código de verificação.
6
Confirme o nome da conta

Confirme o nome de exibição (Display name) e o fuso horário, depois clique em Avançar. Se for solicitado, adicione uma forma de pagamento e clique em Continuar.

Confirme o nome da conta e o fuso horário.
Confirme o nome da conta e o fuso horário.
7
Selecione o número integrado

Para finalizar a conexão, selecione o número que está integrando e clique em Continuar.

Selecione o número que está integrando e clique em Continuar.
Selecione o número que está integrando e clique em Continuar.
8
Finalize a integração

Clique em Finalizar para concluir o processo.

Número integrado com sucesso — clique em Finalizar.
Número integrado com sucesso — clique em Finalizar.
ℹ️

Importante saber: este é o método recomendado quando o número não é elegível para conexão via QR Code. O número precisa ser desconectado do WhatsApp Business App e não pode ser usado ao mesmo tempo no app e na API. Algumas funcionalidades não são suportadas na API Oficial, como Canais, Status, Grupos, enquetes, eventos e localização em tempo real. Enquanto conectado à API, também não é possível editar ou excluir mensagens, nem usar mensagens temporárias e visualização única.

02 Portabilidade de número

Se sua empresa já usa um número conectado à API oficial do WhatsApp com outro provedor e deseja migrar para o Chat C&M, é possível fazer a portabilidade sem perder o histórico de qualidade e mantendo a infraestrutura oficial da Meta. É um processo homologado pela Meta que permite manter o mesmo número, preservando o histórico de mensagens, a qualidade e a reputação da conta.

✅

Pré-requisitos: o número já deve estar conectado à API oficial da Meta com outro provedor e vinculado a um portfólio empresarial verificado; você precisa ter acesso de administrador ao Gerenciador de Negócios; a autenticação em dois fatores da WABA deve estar desativada; e o número deve estar ativo e apto a receber ligações e SMS, pois o código de verificação chegará por um desses meios.

⚠️

Atenção: antes de iniciar, verifique se o número exibe corretamente o nome de exibição (display name) — para isso, envie uma mensagem a partir de um número que nunca tenha interagido com ele.

1
Confira se o portfólio é verificado

Acesse o Gerenciador de Negócios da Meta, selecione a empresa e clique no ícone de engrenagem. Na lateral esquerda, clique em Informações da empresa e verifique o status de verificação. Se ainda não estiver verificado, faça a verificação do portfólio antes de continuar.

Verifique o status de verificação da empresa em
Verifique o status de verificação da empresa em “Informações da empresa”.
2
Desative a autenticação em dois fatores

No Gerenciador de Negócios, desative a autenticação em dois fatores da WABA — ela precisa estar desligada para a portabilidade funcionar.

Desative a confirmação em duas etapas da WABA.
Desative a confirmação em duas etapas da WABA.
3
Inicie a conexão por portabilidade

No Chat C&M, clique em Ajustes → Conta, abra a aba Canais de Atendimento e clique no botão (+). Na tela seguinte, selecione Migrar número e clique em Iniciar. Revise as instruções e clique em Continuar.

Selecione
Selecione “Migrar número” e clique em Iniciar.
4
Informe o número e faça login

Digite o número a ser migrado e clique em Continuar. Em seguida, clique em Entrar com Facebook, confirme a conta e aceite os termos de conexão para prosseguir.

Defina a WABA de destino e entre com o Facebook.
Defina a WABA de destino e entre com o Facebook.
5
Confira os dados e crie a WABA

Confira os dados da empresa e clique em Avançar. Crie uma nova WABA (conta do WhatsApp Business) para a qual o número será transferido e clique em Avançar. Aceite os termos e clique em Continuar. Um pop-up confirmará a conclusão — clique em Concluir.

Crie a nova conta do WhatsApp Business e defina o fuso horário.
Crie a nova conta do WhatsApp Business e defina o fuso horário.
6
Pagamento e verificação

De volta ao Chat C&M, confirme a configuração de pagamento (ou acesse o Gerenciador de Negócios para definir a forma de pagamento) e clique em Continuar. Confirme a desativação da autenticação em dois fatores e clique em Continuar. Escolha como receber o código de verificação, informe o código recebido e clique em Continuar.

Adicione um método de pagamento na WABA de destino e continue.
Adicione um método de pagamento na WABA de destino e continue.
7
Finalize a portabilidade

Clique em Finalizar para concluir a configuração.

Migração concluída com sucesso — clique em Finalizar.
Migração concluída com sucesso — clique em Finalizar.
ℹ️

O que é preservado: a reputação da conta (qualidade), os números verificados no Gerenciador de Negócios, os templates já aprovados e o histórico de relacionamento com a Meta. Vale lembrar que é possível migrar o número de WABA, mas não de Portfólio Empresarial — após a migração, o número continua associado ao mesmo Gerenciador de Negócios. Se o número usar URA (unidade de resposta audível), desative-a para conseguir receber o código de verificação.

03 Nome de exibição (Display name)

O nome de exibição (Display name) é a identificação pública do seu número na API oficial. Ele aparece para os seus clientes, então deve estar alinhado à identidade da empresa. A alteração é feita no Gerenciador de Negócios (Business Manager) da Meta.

✅

Pré-requisitos: ter acesso de administrador ao portfólio empresarial onde o número está cadastrado, ter acesso ao Gerenciador do WhatsApp Business e o número já conectado à API oficial. A alteração passa por uma nova análise da Meta, que pode levar até 48h úteis.

1
Acesse o Gerenciador de Negócios

No Gerenciador de Negócios da Meta, no painel do portfólio empresarial, clique em Configurações de Negócio.

No menu de portfólios, acesse as Configurações do negócio.
No menu de portfólios, acesse as Configurações do negócio.
2
Abra o Gerenciador do WhatsApp

No menu lateral esquerdo, clique em Contas do WhatsApp. Depois, role a lateral direita até o fim e clique em Gerenciador de WhatsApp.

Em Contas do WhatsApp, clique em
Em Contas do WhatsApp, clique em “Gerenciador do WhatsApp”.
3
Acesse as configurações do número

Na nova aba, clique em Número de telefone e depois no ícone de engrenagem ao lado do número.

Em Números de telefone, clique na engrenagem ao lado do número.
Em Números de telefone, clique na engrenagem ao lado do número.
4
Edite o nome de exibição

Selecione a opção Perfil e, em Nome de Exibição, clique em Editar. Digite o nome desejado, seguindo as diretrizes de nomenclatura do WhatsApp, e clique em Enviar. A alteração será analisada pela Meta.

Na aba Perfil, em Nome de Exibição, clique em Editar.
Na aba Perfil, em Nome de Exibição, clique em Editar.
ℹ️

O novo nome deve seguir as diretrizes da Meta (estar relacionado ao nome da empresa e não conter termos genéricos ou enganosos). Durante a análise, o número continua funcionando normalmente. Se o nome for reprovado, é preciso enviar uma nova solicitação com ajustes. Essa alteração não afeta o número, o histórico de mensagens ou as conexões da API.

04 Perfil do WhatsApp

Manter o perfil do WhatsApp atualizado garante uma comunicação profissional com os seus clientes. O perfil é a informação visível para quem interage com a sua empresa pelo aplicativo e inclui nome de exibição, descrição, categoria, endereço e site.

✅

Pré-requisito: ter acesso com controle total do portfólio empresarial.

1
Acesse o Gerenciador de Negócios

No Gerenciador de Negócios da Meta, usando a conta vinculada ao WhatsApp que deseja editar, clique em Configurações de Negócio.

2
Abra o Gerenciador do WhatsApp

No menu lateral esquerdo, clique em Contas do WhatsApp e, ao fim da lateral direita, em Gerenciador de WhatsApp. Depois, clique em Número de telefone e no ícone de engrenagem ao lado do número.

Em Contas do WhatsApp, clique em “Gerenciador do WhatsApp” no fim da lateral direita.
Em Contas do WhatsApp, clique em “Gerenciador do WhatsApp” no fim da lateral direita.
3
Edite o perfil

Na seção Perfil, atualize os campos necessários:

  • Foto de perfil — escolha a imagem desejada;
  • Nome de Exibição — o nome que aparece para os clientes;
  • Descrição — um resumo dos serviços ou produtos;
  • Categoria — a área de atuação da empresa;
  • Endereço e localização — o endereço comercial;
  • Site — a URL oficial da empresa.
Na aba Perfil, atualize a foto, o nome de exibição e os demais campos.
Na aba Perfil, atualize a foto, o nome de exibição e os demais campos.
4
Salve as alterações

Depois de editar, clique em Salvar.

Depois de editar os campos, clique em Salvar.
Depois de editar os campos, clique em Salvar.
ℹ️

A Meta pode levar até 24 horas para aprovar mudanças no nome de exibição. Mantenha as informações consistentes com os dados da empresa (CNPJ, endereço e site) e revise o perfil sempre que houver mudanças, para manter a comunicação alinhada com a sua marca.

05 Remover número

Em algumas situações, pode ser necessário remover um número da conta do WhatsApp Business (WABA) dentro do Business Manager da Meta — para substituição, reorganização ou uma nova conexão. A remoção libera o número para uma nova integração, mas deve ser feita com atenção para evitar perda de dados.

✅

Pré-requisitos: ter acesso de administrador ao portfólio onde o número está configurado; o número deve estar vinculado a uma WABA ativa; verifique se não há cobranças ou pendências financeiras atreladas ao número; e tenha ciência de que, ao remover, todas as mensagens, sessões e templates relacionados serão perdidos.

1
Acesse o Gerenciador de Negócios

No Gerenciador de Negócios da Meta, selecione a empresa e clique no ícone de engrenagem.

2
Abra o Gerenciador do WhatsApp

No menu lateral esquerdo, clique em Contas do WhatsApp e, ao fim da lateral direita, em Gerenciador de WhatsApp.

Em Contas do WhatsApp, clique em “Gerenciador do WhatsApp”.
Em Contas do WhatsApp, clique em “Gerenciador do WhatsApp”.
3
Remova o número

Na nova aba, clique no ícone de lixeira ao lado do número de telefone.

Em Números de telefone, clique no ícone de lixeira ao lado do número.
Em Números de telefone, clique no ícone de lixeira ao lado do número.
⚠️

Atenção: este processo é irreversível. Leia atentamente as instruções na tela antes de prosseguir.

4
Confirme a exclusão

Um pop-up pedirá a confirmação. Clique em Avançar para prosseguir com a remoção.

Leia o aviso do que será perdido e clique em Avançar para confirmar.
Leia o aviso do que será perdido e clique em Avançar para confirmar.
5
Exclua a WABA (opcional)

Para excluir a conta inteira, volte ao Gerenciador de Negócios, clique no ícone de engrenagem, acesse Contas do WhatsApp e selecione a WABA. Clique no ícone de três pontinhos no canto superior direito, escolha Remover do Portfólio Empresarial e confirme clicando em Excluir conta.

Na confirmação final, clique em Excluir conta para remover a WABA.
Na confirmação final, clique em Excluir conta para remover a WABA.
ℹ️

Após a remoção, o número pode ser reconectado por QR Code oficial ou outro método suportado. A remoção não cancela automaticamente as cobranças da API, então verifique a fatura ativa no Gerenciador de Pagamentos. 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