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

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

Última atualização em Feb 11, 2026

🚨 Antes de iniciar: leitura obrigatória

Antes de começar a integração, é obrigatório ler o guia principal:

👉 Guia Mestre — Como conectar seu número de WhatsApp ao Cloud Chat

Nesse guia você aprenderá a:

  • Identificar se o número é novo ou já existente e, com base nisso, garantir que todos os pré-requisitos da Meta estejam validados antes de iniciar a integração;

  • Escolher corretamente o modelo de integração (com ou sem coexistência).

⚠️ Iniciar a integração sem validar esses pontos pode resultar em:

  • Perda do número;

  • Bloqueio pela Meta;

  • Erros no processo de verificação;

  • Necessidade de refazer toda a configuração.


Sobre este tutorial

Neste artigo, você aprenderá a criar uma nova caixa de entrada no Cloud Chat utilizando um número conectado diretamente via API oficial da Meta (WABA).

📌 Na integração sem coexistência, o número:

  • Funciona exclusivamente via API (Cloud Chat);

  • Deixa de funcionar no aplicativo WhatsApp Business App do celular;

💡 Deseja manter o uso no celular também?
Então utilize a integração com coexistência:
👉 Integração COM coexistência (Celular + API simultaneamente)


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

Passo 1: Acesse as configurações.

Passo 2: Vá até a seção de Caixas de Entrada.

Passo 3: Clique em Adicionar Caixa de Entrada.

Passo 4: Em seguida, clique em WhatsApp.

Passo 5: Na tela do Canal do WhatsApp, escolha o provedor Cadastro Incorporado e insira o nome desejado para a sua caixa de entrada. Depois, clique em Entrar via WhatsApp para iniciar o fluxo integrado.

Passo 6: No pop-up do Facebook que será aberto, use sua conta de desenvolvedor/gerente Meta para fazer login.

Passo 7: Após o login bem-sucedido, clique em Continuar.

Passo 8: Escolha o portfólio comercial da Meta e clique em Avançar.

Caso pretenda adicionar um número de Whatsapp Business App via Coexistência, escolha "Conectar Whatsapp Business App existente" e leia nosso passo a passo de integração com coexistência. Caso contrário, escolha "Começar com um novo número de telefone WhatsApp". Finalmente, clique em Avançar.

Passo 9: Selecione Criar uma Conta Comercial do WhatsApp e clique em Avançar.

Passo 10: Nesta seção, insira o nome da sua Conta Comercial do WhatsApp, o nome de exibição e escolha uma categoria válida.

Passo 11: Nesta etapa, selecione Adicionar um novo número, insira o número de telefone e verifique-o. Note que se o número for um telefone fixo ou um número digital, a verificação deverá ser feita por chamada telefônica.

Passo 12: Após a verificação do número, clique em Concluir para prosseguir com a configuração da sua caixa de entrada.

Nota: Se você ainda não adicionou um método de pagamento ao seu portfólio comercial, clique no botão Adicionar método de pagamento para ser redirecionado à configuração de faturamento. É necessário um método de pagamento válido para enviar mensagens proativas no WhatsApp.

Passo 13: Adicione agentes à sua nova caixa de entrada.

Passo 14: Depois de configurar os agentes da caixa de entrada, clique em Adicionar agentes. Sua caixa de entrada está pronta para enviar e receber mensagens no WhatsApp!