Como conectar o WhatsApp: QR Code ou API oficial?

As duas formas de vincular o número do projeto, as diferenças entre elas e o passo a passo da conexão por QR Code.

Atualizado em 12/10/2026

O WhatsApp do projeto é o número que recebe os leads. Conectado, ele faz o TrackingFlow registrar cada contato novo, identificar a origem e permitir as automações (Follow-up, Campanhas e Pós-Venda). Há duas formas de conectar:

Qual escolher?

  • QR Code: conecta em segundos, como um WhatsApp Web, e não tem custo por mensagem. Funciona com WhatsApp comum ou Business. A sessão pode cair (ex.: celular muito tempo sem internet), e aí basta ler o QR de novo.
  • API oficial da Meta: conexão oficial e mais estável, sem depender do celular ligado. Os envios automáticos feitos pelo TrackingFlow passam a ser cobrados pela Meta. Receber mensagens e responder pelo celular não são cobrados.

Passo a passo: conexão por QR Code

  1. No painel, vá em Integrações → Canais.
  2. No card WhatsApp do Projeto, clique em Conectar. O QR Code aparece em alguns segundos.
  3. No celular, abra o WhatsApp e toque em Menu (⋮) ou Configurações.
  4. Selecione Aparelhos conectados e toque em Conectar aparelho.
  5. Aponte a câmera para o QR Code. O código se renova sozinho a cada 30 segundos.
  6. Quando o card mostrar Conectado, está pronto.

O cliente não está com você?

Clique em Gerar link para o cliente. Ele abre o link no próprio aparelho e escaneia o QR sem precisar de acesso ao painel. O link é temporário e pode ser revogado a qualquer momento.

Para trocar de número

Use sempre o botão Trocar número no card. Ele encerra a sessão antiga com segurança antes de gerar um QR novo.

Escaneei, mas não conecta ou aparece um pedido de chave de acesso.

Algumas contas do WhatsApp passaram a exigir uma confirmação extra (chave de acesso/passkey) que a conexão por QR não consegue concluir. Nesse caso, conecte pela API oficial.

Preciso deixar o celular ligado?

Na conexão por QR, o ideal é que o celular fique com internet. Se ele ficar desligado por muitos dias, o WhatsApp encerra a sessão e é preciso ler o QR de novo.

Este artigo ajudou?