> Conectar uma sessão de WhatsApp por QR code para grupos e uso interno — quando usar, como parear e os riscos. # WhatsApp não-oficial (Baileys) Uma conexão de WhatsApp feita **escaneando um QR code**, do mesmo jeito que você abre o WhatsApp Web. Cobre o que a API oficial não atende — em especial **grupos**. É um canal de **uso interno**, não um canal de IA para o cliente final. ## Onde fica Menu **Configuração › Integrações › WhatsApp não-oficial** — rota `/config/integracoes/whatsapp-baileys`. Duas abas: **Visão geral** e **Sessões (QR)**. > **Atenção.** > **Não substitui o WhatsApp Cloud API.** O canal oficial é o recomendado para atendimento ao cliente final, com respaldo da Meta, templates e janela de 24h. O não-oficial é complementar — grupos e comunicação operacional. ## Quando usar | Situação | Canal indicado | |----------|----------------| | Atendimento ao cliente final, 1 a 1 | WhatsApp Cloud API (oficial) | | Conversas em **grupos** | WhatsApp não-oficial | | Iniciar conversa fora das 24h | WhatsApp Cloud API (com template HSM) | | Comunicação operacional interna | WhatsApp não-oficial | ## Aba Sessões (QR) Onde você conecta e gerencia as sessões. A tela se atualiza sozinha a cada poucos segundos. 1. Clique em **Conectar WhatsApp**. Um QR code aparece. 2. No celular, abra o WhatsApp → **Aparelhos conectados** → **Conectar um aparelho** e aponte a câmera para o QR. 3. A sessão passa de **Aguardando QR** para **Conectando** e, então, **Conectado**. Os grupos e contatos são sincronizados. ### Estados da sessão **Conectado** · **Conectando** · **Aguardando QR** · **Desconectado** · **Erro** (a mensagem do erro aparece no card). Cada card mostra rótulo, número/JID e contadores: grupos, contatos, mensagens, não lidas, quando conectou e o último evento. ### Ações por sessão - **Abrir chat** — vai para os [Grupos de WhatsApp](/comunicacao/grupos-whatsapp). - **Reconectar / Renovar QR** — quando a sessão não está conectada. - **Ressincronizar** — atualiza a lista de grupos. - **Reparar prévias** — recalcula a última mensagem e o horário de cada conversa. - **Recuperar mídia** — re-tenta baixar imagens, áudios e vídeos dos últimos 10 dias. - **Renovar sessão** — gera um novo QR sem apagar os dados. - **Desconectar** — encerra a conexão e limpa a autenticação, mas mantém os dados. - **Editar nome** e **Membros**. > **Importante.** > **Remover é irreversível.** Apaga a sessão e **todos os dados** dela — grupos, contatos, mensagens, mídias e a autenticação. Só use quando tiver certeza. ## Riscos e limitações - Não tem o respaldo da Meta — use com responsabilidade. - Não suporta templates HSM nem a janela de 24h da API oficial. - Depende do celular pareado seguir ativo; muito tempo offline pode derrubar a sessão. - Volume alto de mensagens em massa aumenta o risco de bloqueio do número pela própria Meta. ## Veja também - [Grupos de WhatsApp](/comunicacao/grupos-whatsapp) - [WhatsApp Cloud API](/configuracoes/integracoes/whatsapp-cloud) - [Status e diagnóstico](/configuracoes/integracoes/status)