Conectar WA

O que essa tela faz

Conecta o número de WhatsApp do Marcos ao sistema (via Evolution API) escaneando um QR code — a mesma forma de conectar o WhatsApp Web. Uma vez conectado, as conversas dos visitantes passam a aparecer em /admin/mensagens (e /admin/inbox), com resposta direto pelo painel. Esta tela fica atrás de uma segunda confirmação de identidade (FaceGate, revalidação via Apple) antes de mostrar o conteúdo.

Campo a campo

• Estado "Verificando conexão…" — enquanto consulta o status atual.
• Estado "WhatsApp conectado" — mostra o nome/telefone do número já conectado.
• Estado "Instância não criada" — quando ainda não existe nenhuma instância criada no

provedor (Evolution API).

• Estado "connecting" (QR code) — mostra o QR code pra escanear, com o passo a passo: abrir o

WhatsApp no celular → "Dispositivos conectados" → "Conectar dispositivo" → apontar a câmera. Atualiza sozinho a cada 5 segundos até detectar a conexão.

• Estado de erro — mostra a mensagem de erro (ou "Aguardando QR code…" como padrão).

Ações disponíveis

• "Criar instância" (só quando ainda não existe instância) — cria a instância no provedor e

já verifica o status em seguida (deve gerar o QR code logo depois).

• "Atualizar" — reconsulta o status manualmente a qualquer momento.
• "Tentar novamente" (no estado de erro) — reconsulta o status.
• Escanear o QR code (fora do painel, no celular) — é a ação que efetivamente conecta o

número.

Dúvidas frequentes

P: Escaneei o QR code mas a tela não atualizou. R: Ela verifica sozinha a cada 5 segundos enquanto está no estado de conexão; espere um pouco ou clique em "Atualizar".

P: O QR code expirou antes de eu escanear. R: Clique em "Atualizar" (ou "Tentar novamente") pra pedir um QR code novo.

P: Desconectei o WhatsApp sem querer no celular. O painel para de funcionar? R: A tela volta a mostrar "Instância não criada" ou pedir novo QR code — reconecte pelo mesmo fluxo.

Erros comuns

Esta tela não tem actions.ts (usa rotas de API: /api/whatsapp/qrcode e /api/whatsapp/criar-instancia) — qualquer erro do provedor aparece como texto livre no lugar do QR code (campo erro da resposta), sem um catálogo fixo de mensagens.