🚀Primeiros Passos & Conexão
⏱️ 7 min de leitura📊 Fundamental

Como Conectar o WhatsApp ao Painel (QR Code, Pairing Code e WABA)

Guia detalhado para criar e parear instâncias WhatsApp via QR Code na tela, Código de Pareamento de 8 dígitos sem câmera, link compartilhável para terceiros e conexão oficial Meta Cloud API (WABA), com semáforo de saúde e aquecimento de chips.

⚡Pré-requisitos Obrigatórios & Checklist Inicial

  • ✓Acesso de Administrador ou permissão de gerenciamento de canais no Painel V2.
  • ✓Smartphone com WhatsApp ativo, conectado à internet e com bateria acima de 20%.
  • ✓Limite de instâncias disponível no seu plano contratado (verifique em Faturamento).
  • ✓Número de telefone dedicado para atendimento ou campanhas (evite usar número pessoal).

📋Instruções Passo a Passo no Painel

01

Acessar o Painel de Gerenciamento de Canais

👉 Onde Clicar:Menu Lateral Esquerdo > Canais > WhatsApp Channels

Na tela principal de canais, você visualizará todas as instâncias existentes, seus status operacionais (Conectado, Desconectado, Inicializando) e o medidor de consumo do seu plano contratado. Clique no botão laranja superior '+ Nova Instância' para abrir o modal de configuração.

Dicionário de Campos & Parâmetros:
Nome da InstânciaNome interno para identificação da equipe (ex: Atendimento Matriz, Vendas SDR 01, Lançamento Junho).
Provedor de ConexãoEscolha entre 'Green API' (conexão instantânea via QR Code/Pairing Code) ou 'Meta WABA Cloud API' (API oficial corporativa com templates aprovados).
Time ResponsávelVincule a instância a um departamento específico (ex: Comercial, Suporte N1) para isolamento de conversas.
02

Escolher o Método de Pareamento Adequado

👉 Onde Clicar:Modal de Conexão > Seleção de Método

O Painel V2 oferece 3 métodos flexíveis de conexão: 1) QR Code em tempo real na tela; 2) Código de Pareamento de 8 dígitos (Pairing Code) para digitar no celular caso a câmera esteja com defeito ou inacessível; 3) Link Compartilhável ('Share QR') para enviar a um cliente ou gerente de filial escanear remotamente com segurança sem que ele precise de senha de admin.

03

Executar o Pareamento no Celular

👉 Onde Clicar:Celular > WhatsApp > Configurações > Dispositivos Conectados

Toque em 'Conectar um Aparelho'. Se escolheu QR Code, aponte a câmera para o quadro na tela do computador. Se escolheu Pairing Code, toque em 'Conectar com número de telefone', digite o código alfanumérico de 8 dígitos exibido no painel e aguarde a confirmação de sincronização.

04

Verificação de Saúde e Semáforo WABA

👉 Onde Clicar:WhatsApp Channels > Card da Instância Conectada

Assim que a conexão for estabelecida, o card exibirá o status verde 'Conectado', o avatar do perfil e o número normalizado em padrão internacional (+55...). Em instâncias WABA oficiais, o componente WabaHealthIndicator exibe a qualidade da conta: Verde (Alta qualidade/Sem restrições), Amarelo (Atenção/Denúncias de spam) ou Vermelho (Bloqueado/Limite reduzido).

🚨Regras Críticas de Segurança & Proteção Anti-Bloqueio

  • 🛡️Protocolo de Aquecimento (Warmup): Para números recém-adquiridos, nunca dispare campanhas em massa no primeiro dia. Siga a cadência: Dia 1 a 3 (até 50 mensagens/dia de atendimento receptivo); Dia 4 a 7 (até 200 mensagens); Dia 8 em diante (escalar progressivamente).
  • 🛡️Conexão Contínua: Mantenha o smartphone conectado a uma rede Wi-Fi estável e na tomada para evitar interrupções de bateria que desconectem a sessão web.
  • 🛡️Semáforo Amarelo na Meta: Caso o indicador de saúde passe para Amarelo, pause imediatamente disparos outbound e atenda apenas mensagens receptivas durante 72 horas para restaurar a pontuação de qualidade.

❓Perguntas Frequentes & Resolução de Dúvidas

P:O que fazer se o QR Code expirar antes de escanear?

O QR Code do WhatsApp expira a cada 20 segundos por motivos de segurança. Clique no ícone de atualização circular (Refresh) no centro do código para gerar um novo token.

P:Posso conectar o mesmo número em duas instâncias diferentes?

Não. O protocolo do WhatsApp permite apenas uma conexão web ativa por número. Se você conectar o mesmo chip em outra instância, a sessão anterior será automaticamente deslogada.

P:O que acontece se a internet do celular cair?

As mensagens que chegarem ficarão retidas nos servidores do WhatsApp. Assim que a conexão for restabelecida, o sistema sincronizará o histórico automaticamente sem perda de dados.

MailerWeb Knowledge Base • Atualizado em 2026 • Documentação Oficial do Usuário