Conecte o WhatsApp por QR Code ou passkey, também chamado de API não oficial do WhatsApp, e entenda a dependência do celular e os riscos dessa conexão não oficial
O WhatsApp Web conecta um número de WhatsApp comum: você lê um QR Code com o celular e o número passa a receber e enviar mensagens pelo Novus CRM. É a forma mais rápida de começar com o número que a empresa já usa, sem passar pela aprovação da Meta. As conversas chegam na mesma caixa de entrada dos demais canais.Muita gente chama esse formato de API não oficial, WhatsApp não oficial ou API não oficial do WhatsApp. Não confunda com o WhatsApp Oficial, que é a Cloud API autorizada pela Meta.Se você ainda está decidindo entre esse formato e o WhatsApp Oficial, a comparação entre os dois está em Canais.
Esta é uma conexão não oficial, com risco alto de banimento. O WhatsApp Web não é um canal autorizado pela Meta: a plataforma não reconhece o uso do número por sistemas externos e pode bloquear ou banir o número a qualquer momento, sem aviso e sem direito a recurso. O risco é maior do que no WhatsApp Oficial e aumenta com disparos em massa, mensagens para quem não pediu contato, números novos e bloqueios ou denúncias de destinatários.A VVS Sistemas não se responsabiliza pelo banimento de números. Ao conectar um número por WhatsApp Web, a sua empresa assume esse risco. Para operações de volume alto, campanhas ou números críticos para o negócio, use o WhatsApp Oficial.
No menu lateral, vá em Configurações > Atendimento > Canais, clique em Incluir e escolha WhatsApp Web. O painel Conectar WhatsApp Web abre.
2
Dê um nome ao canal
Preencha Nome do canal. Ele é obrigatório, aceita até 100 caracteres e serve só para você identificar o canal dentro do Novus CRM (por exemplo, “WhatsApp Vendas”). Sem nome, o código não é gerado.
3
Gere o QR Code
Com a opção QR Code selecionada, clique em Gerar QR Code. O canal já é criado nesse momento, antes da leitura: ele aparece na lista mesmo se você fechar o painel sem concluir.
4
Leia o código com o celular
O painel mostra o código e os três passos a seguir no aparelho: Abra o WhatsApp no celular, Toque em Dispositivos conectados e Aponte a câmera para o código.
5
Aguarde a confirmação
Ao conectar, o painel se fecha na hora (a confirmação Canal conectado! só aparece por um instante) e o canal passa a figurar na lista com o status Conectado.
O código tem validade curta. O Novus CRM acompanha a leitura por cerca de 30 segundos. Passado esse tempo sem confirmação, aparece o aviso “O QR Code expirou. Gere um novo para tentar novamente.” — clique em Gerar novo QR Code e leia outra vez.
Na criação de um WhatsApp Web não existe botão de salvar: o rodapé traz só Fechar, porque é a leitura do código que conclui a conexão. Departamento padrão, fluxo, agente de IA e ligações aparecem depois, quando você reabre o canal para editar.
Algumas contas são obrigadas pelo WhatsApp a parear por passkey, em vez de QR Code. Para esses casos, o painel de conexão tem a opção Passkey ao lado de QR Code.
1
Escolha Passkey e inicie
Selecione Passkey e clique em Iniciar pareamento. Depois, clique em Abrir pareamento por passkey: abre em outra aba uma página com o passo a passo e o atalho de pareamento.
2
Guarde o atalho nos favoritos
Nessa página, arraste o botão 🔑 Parear passkey para a barra de favoritos do navegador. Se arrastar não funcionar, copie o código exibido no fim da página (botão Copiar código) e crie um favorito novo colando esse código no lugar do endereço.
3
Entre no WhatsApp Web
Abra web.whatsapp.com e faça login na mesma conta que você quer conectar.
4
Clique no favorito e autorize
Com o web.whatsapp.com aberto, clique no favorito Parear passkey e autorize com a sua biometria ou PIN quando o navegador pedir. A assinatura só funciona dentro do site do WhatsApp — por isso o atalho, e não um botão no painel.
5
Volte ao Novus CRM
Em alguns segundos o canal conecta sozinho. Enquanto isso, o painel mostra um código de confirmação: confira se é o mesmo que aparece no seu dispositivo ao autorizar.
O Novus CRM fica aguardando a autorização por cerca de cinco minutos. Se esse tempo passar, reinicie o pareamento.
Se o pareamento não completar, fale com o administrador. O navegador aberto em web.whatsapp.com precisa conseguir chamar o Novus CRM, e essa liberação (da origem https://web.whatsapp.com) é feita por quem administra o ambiente. Sem ela, o clique no favorito não dá erro visível: o canal simplesmente nunca conecta.
A sessão do aparelho caiu ou foi encerrada em Dispositivos conectados
Aguarde a reconexão automática, use Reiniciar ou reabra o canal para ler um novo QR Code
Duplicado
O número já está conectado em outro canal. Nesse caso o Novus CRM encerra a sessão nova automaticamente
Exclua o canal repetido e conecte de novo, mantendo um só por número
—
O canal foi criado, mas nunca chegou a conectar
Reabra o canal e leia o QR Code
Enquanto a conexão está sendo estabelecida, o status pode aparecer em inglês, como CONNECTING — ou seja, “conectando”. É um estado passageiro, e ele não muda sozinho na tela: a lista de canais é recarregada quando você executa uma ação nela ou digita algo na busca.
O WhatsApp Web depende da sessão do seu aparelho. Mantenha o celular com bateria e internet: se ele ficar muito tempo desligado, ou se alguém remover o Novus CRM de Dispositivos conectados, o canal cai.O que acontece quando isso ocorre:
Os administradores da conta recebem uma notificação avisando que o canal foi desconectado.
O Novus CRM passa a tentar restabelecer a sessão sozinho: a verificação roda a cada 5 minutos, começa depois de 5 minutos sem conexão e vai até 50 tentativas. Um canal parado há mais de 6 horas volta a ser reconectado à força, mesmo tendo estourado as tentativas. Se der certo, o status volta para Conectado sem você fazer nada.
Na tela do Chat, o ícone do canal na conversa fica vermelho enquanto ele está desconectado (e cinza quando o status ainda não é conhecido).
Se a reconexão automática não resolver, você tem duas saídas: a ação Reiniciar, que força o canal a recomeçar a conexão, ou uma nova leitura de QR Code.
Ao reabrir um canal WhatsApp Web que não está conectado, o Novus CRM já gera um novo QR Code automaticamente — e gerar um código novo encerra a sessão atual no celular. Só reabra um canal desconectado quando estiver com o aparelho em mãos para ler o código.
Em Configurações > Atendimento > Canais, o menu de ações da linha traz para o WhatsApp Web:
Editar — abre o canal para ajustes. Clicar na linha faz o mesmo.
Reiniciar — força o canal a recomeçar a conexão. A confirmação aparece como “Canal reiniciado.”. Na visão em lista, cada canal WhatsApp Web também tem um botão de reiniciar fixo no fim da linha.
Sincronizar contatos — importa para o Novus CRM os contatos daquele WhatsApp. A importação roda em segundo plano (“Sincronização de contatos iniciada.”).
Excluir — remove o canal. A confirmação avisa que o canal será desconectado. As conversas já registradas continuam no histórico dos contatos.
Na visão em cards as opções são outras: Configurar (abre o canal), reiniciar e excluir. Sincronizar contatos existe só no menu da linha, na visão em lista.
Identificador do canal — o código do canal, útil em integrações.
Fluxo padrão — fluxo iniciado automaticamente quando uma conversa nova chega. A opção Desabilitar fluxo neste canal ignora o fluxo e manda as mensagens direto para o atendimento.
Departamento padrão — setor que recebe as conversas iniciadas nesse canal.
Agente de IA — assistente que responde antes de encaminhar a um atendente humano.
Ligações — ver abaixo.
Sincronização de histórico — importa atendimentos, mensagens e mídias de um sistema externo para este canal.
Clique em Salvar ao terminar. O tipo do canal não pode ser trocado. O passo a passo completo está em Canais.
Diferente do WhatsApp Oficial, o WhatsApp Web não tem a restrição da janela de 24 horas: você pode escrever para um contato a qualquer momento, sem modelo aprovado. Isso facilita o dia a dia, mas é justamente o uso que mais expõe o número. Vale tratar essa liberdade com cuidado.
Na edição do canal, a opção Habilitar ligações neste canal libera as chamadas de voz: o canal passa a aparecer no discador e as ligações recebidas tocam para a equipe.Com a opção desligada, o canal sai do discador e as ligações recebidas não tocam — são recusadas automaticamente e ficam registradas na conversa como tentativa de ligação.
As ligações funcionam no WhatsApp Web e também no WhatsApp Oficial. A diferença: no Oficial, a Meta exige que o contato autorize a ligação antes de a empresa discar. No WhatsApp Web não existe esse pedido de permissão.
Meu número foi banido pelo WhatsApp. Dá para recuperar pelo Novus CRM?
Não. O bloqueio acontece na plataforma do WhatsApp, e só ela pode revê-lo. O pedido é feito pelo próprio aplicativo, no celular. Conecte outro número no Novus CRM para retomar o atendimento enquanto isso.
O canal cai sozinho de tempos em tempos. É normal?
Costuma ser a sessão do celular: aparelho sem internet, sem bateria ou com o Novus CRM removido em Dispositivos conectados. O sistema tenta reconectar sozinho; se não voltar, use Reiniciar ou reabra o canal para ler um novo QR Code. Quedas frequentes são um bom motivo para migrar para o WhatsApp Oficial.
Posso conectar o mesmo número no Web e no Oficial ao mesmo tempo?
Não. Ao detectar o número em outro canal, o Novus CRM marca o canal novo como Duplicado e encerra a sessão dele. Escolha um dos dois formatos para cada número.
Gerei um QR Code novo por engano e o canal desconectou. Por quê?
Gerar um código novo encerra a sessão que estava ativa no celular — é assim que o WhatsApp trata um novo pareamento. Basta ler o código exibido para o canal voltar a ficar Conectado.