Principal Integração com WhatsApp Como conectar um número do WhatsApp sem coexistência (exclusivamente via API)

Como conectar um número do WhatsApp sem coexistência (exclusivamente via API)

Última atualização em May 08, 2026

Quando usar

  • Você quer conectar um número ao Cloud Chat que funcionará exclusivamente via API, sem celular

  • Você está criando uma operação 100% digital, com atendimento via helpdesk ou automação

  • Você não precisa usar o número no WhatsApp Business App do celular

  • Você quer maior estabilidade, sem conflito entre dispositivos

Pré-requisitos

Iniciar a integração sem validar os pontos abaixo pode resultar em perda do número, bloqueio pela Meta, erros no processo de verificação ou necessidade de refazer toda a configuração.

Migração de número existente? Leia o guia de migração primeiro — leitura obrigatória.

Se o número que você quer conectar já está ativo em outra plataforma de atendimento ou em outro provedor (BSP), NÃO inicie o fluxo de integração no Cloud Chat antes de ler:

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

Pular essa etapa pode resultar em:

  • Falhas no processo de verificação e migração travada

  • Impossibilidade de liberar o número do provedor anterior

  • Necessidade de refazer toda a configuração do zero

O guia de migração mostra todos os pré-requisitos da Meta (propriedade da WABA, Verificação em Duas Etapas, status do Business Manager, método de pagamento, histórico de mensagens) que precisam ser validados antes de realizar a integração no Cloud Chat.

Número já cadastrado no WhatsApp Business App do celular?

A integração sem coexistência (este artigo) NÃO permite que o número continue funcionando no WhatsApp Business App. Para seguir por aqui, você terá que:

  1. Excluir a conta do número no WhatsApp Business App (apagar o app ou remover a conta dentro dele) antes de iniciar o Cadastro Incorporado

  2. Aceitar que o número deixará de funcionar no celular após a integração — todas as mensagens passarão a chegar exclusivamente no Cloud Chat

Se você quer manter o número funcionando no WhatsApp Business App em paralelo ao Cloud Chat, NÃO siga este artigo. Use o método de coexistência:

Como conectar um número do WhatsApp com coexistência (celular + API)

Número novo? É preciso aquecer antes de tentar integrar.

A Meta avalia o histórico de uso do número antes de liberar a conexão via API. Números recém-criados, sem histórico no WhatsApp Business App, podem ser barrados logo no Cadastro Incorporado — a Meta retorna o erro:

Seu número de telefone não está qualificado para se conectar à plataforma do WhatsApp Business. Mais atividades no app WhatsApp Business são necessárias para ajudar a determinar a qualificação. (#3441045)

Como aquecer antes de integrar:

  • Use o número no WhatsApp Business App (celular) por alguns dias / semanas, recebendo conversas reais

  • Divulgue o número nos seus canais (site, redes sociais, e-mail) para gerar entrada orgânica

  • Responda dentro da janela de 24h, sem spam, sem mensagens repetidas, sem links suspeitos

Depois do aquecimento, o número entra na API com tier e Quality Rating melhores e o Cadastro Incorporado passa sem o erro acima.

Documentação oficial da Meta: Messaging Limits · Quality Rating.

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.

Passo a passo da integração sem coexistência

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

  • Ser administrador da conta no Cloud Chat

  • 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 habilitado para pagamento em dólar — obrigatório em migração de plataforma de atendimento ou para disparos proativos

Etapa 1 — Acessar as Configurações do Cloud Chat

  1. No Cloud Chat, acesse Configurações

  1. Vá até a seção Caixas de Entrada

Etapa 2 — Iniciar a criação da caixa de entrada de WhatsApp

  1. Clique em Adicionar Caixa de Entrada

  1. Selecione WhatsApp

  1. Na tela do Canal do WhatsApp, escolha o provedor Cadastro Incorporado (Embedded Signup) e preencha o nome desejado para a caixa de entrada. Depois, clique em Entrar via WhatsApp para iniciar o fluxo integrado

Etapa 3 — Autenticar na Meta

No pop-up da Meta que será aberto, faça login com a conta pessoal do Facebook da pessoa que tem acesso de administrador ao Portfólio Empresarial (Business Portfolio) da empresa na Meta.

O login não é feito com um e-mail corporativo genérico nem com uma "conta da empresa" — é com o Facebook pessoal de quem é admin do portfólio empresarial da Meta. Sem essa permissão administrativa, o fluxo de Cadastro Incorporado não consegue autorizar a conexão e a integração trava nesta etapa.

  1. Após o login, clique em Continuar

Etapa 4 — Selecionar Business Portfolio e iniciar conta WhatsApp

  1. Escolha o Business Portfolio na Meta e clique em Avançar

  1. Selecione Começar com um novo número de telefone WhatsApp e clique em Avançar

Se quiser conectar um número que já está no WhatsApp Business App (modo coexistência), interrompa este fluxo e siga o passo a passo de integração com coexistência.

  1. Selecione Criar uma Conta Comercial do WhatsApp e clique em Avançar

Etapa 5 — Configurar a Conta Comercial e o número

  1. Insira o nome da Conta Comercial do WhatsApp, o nome de exibição e escolha uma categoria válida

  1. Selecione Adicionar um novo número, insira o número de telefone e verifique-o

Se o número for um telefone fixo ou número digital, a verificação deverá ser feita por chamada telefônica, não SMS.

Etapa 6 — Concluir e configurar pagamento (se aplicável)

Quando o cadastro do método de pagamento é OBRIGATÓRIO:

  • Migração de número existente — sempre obrigatório, sem exceção. Sem método de pagamento válido, a Meta não conclui a migração da WABA.

  • Disparo proativo (template / campanha / mensagem unitária via API) — obrigatório, porque a Meta cobra por template enviado fora da janela de 24h.

  • Reabertura da janela de 24h da Meta — obrigatório. Para iniciar uma nova conversa com um cliente fora da janela ativa, é preciso disparar um template, e isso tem custo direto cobrado pela Meta no cartão cadastrado.

  • Pesquisa de satisfação (CSAT) — a mensagem de CSAT também é um template da Meta. Se ela for disparada fora da janela de 24h (caso comum quando o cliente não responde logo após o atendimento), sem método de pagamento cadastrado a CSAT não é enviada — o cliente não recebe a pergunta de avaliação e a métrica fica vazia.

Sem cartão válido cadastrado na WABA, nenhuma mensagem proativa sai, nenhuma janela é reaberta e nenhum CSAT é entregue fora da janela — o número fica restrito a responder dentro das 24h após a última mensagem do cliente.

  1. Clique em Adicionar método de pagamento para ir adicionar o método de pagamento na WABA. Para atendimento puramente reativo (responder mensagens dentro da janela de 24h, sem disparos proativos e sem migração), clique em "Finish".

Etapa 7 — Adicionar agentes à caixa de entrada

  1. Configure os agentes que terão acesso à nova caixa de entrada

  1. Clique em Adicionar agentes

A caixa de entrada está pronta para enviar e receber mensagens no WhatsApp. ✅

Observações

  • Migração: se este é um número já em uso em outra plataforma, NÃO siga este artigo isolado — comece pelo Guia de Migração para validar os pré-requisitos da Meta antes do embedded signup

  • WhatsApp Business App: a integração via API não convive com o número ativo no WhatsApp Business App do celular — exclua a conta do app antes de seguir, ou use coexistência se quiser manter o celular ligado

  • Templates da Meta: para qualquer envio proativo ou reabertura da janela de 24h, é preciso ter cartão válido + template aprovado — veja Regras de templates do WhatsApp (Meta) e Como criar, editar e excluir templates de WhatsApp no Cloud Chat

  • Método de pagamento é obrigatório para migração, envios proativos e reabertura de janela de 24h — para atendimento reativo dentro da janela ativa, não é necessário no momento da integração

  • Para manter o número funcionando no celular em paralelo, use a integração com coexistência

  • Em caso de dúvida ou erro, acione o suporte antes de prosseguir — ajustes feitos incorretamente podem gerar bloqueio do número

  • Documentação oficial da Meta: Meta Developers — Embedded Signup