Pular para o conteúdo

Como conectar um número pela API oficial do WhatsApp

Atualizado em October 15, 2026

O que você precisa

  • Acesso de administrador no NodeChat.
  • Uma conta na Meta (Facebook) com acesso de administrador ao negócio da sua empresa.
  • Um destes números:
    • um número novo, que não esteja em nenhum app do WhatsApp; ou
    • o número que você já usa no app WhatsApp Business, na versão 2.24.17 ou mais nova.
  • O navegador sem bloqueio de pop-up para o NodeChat. O cadastro abre numa janela da Meta.

Passo a passo

  1. No menu à esquerda, clique em Configurar e depois em Canais.
  2. Clique em Conectar canal.
  3. Escolha WhatsApp.
  4. Escolha API Oficial do WhatsApp.
  5. Na tela Configuração rápida com Meta, responda Qual número você vai conectar?:
    • Usar um número novo na API do WhatsApp: a Meta manda um código por SMS ou ligação para confirmar o número.
    • Usar o número que já está no app WhatsApp Business: na janela da Meta, escolha conectar a conta que já existe e leia o QR code no app do celular. O celular continua funcionando.
  6. Clique em Conecte-se com WhatsApp Business.
  7. Na janela da Meta, entre com a sua conta e siga as etapas até o fim.
  8. Volte ao NodeChat e espere a mensagem Configurando sua conta do WhatsApp Business.
  9. Na tela Integrantes, escolha quem atende por essa caixa e clique em Adicionar integrantes.
  10. Na tela Sua caixa está pronta!, clique em Leva-me lá.

Bom saber

  • As conversas antigas do app WhatsApp Business não vêm para o NodeChat. O histórico começa no dia da conexão.
  • A Meta cobra as conversas direto de você. Veja a estimativa em Canais > sua caixa > aba Custo da Meta.
  • Fora da janela de 24 horas, só sai mensagem com modelo aprovado. Veja Janela de 24 horas no WhatsApp oficial.

Se der errado

  • "O cadastro do WhatsApp foi cancelado": a janela da Meta fechou antes do fim. Comece de novo pelo passo 6.
  • "Esta conta chegou ao limite de caixas do plano.": a conta atingiu o número de caixas do plano. Fale com o suporte.
  • "A Meta informou: ...": a Meta recusou algum dado. Leia a mensagem, corrija na conta da Meta e tente de novo.

Já tenho o número na API por outro provedor

Abaixo do botão da Meta há o link fluxo de configuração manual. Ele pede dados técnicos do número na Meta (ID do número, ID da conta e chave). Recomendamos chamar o suporte para fazer essa conexão com você.