Solução de problemas · trilha “Resolução de problemas e suporte”, 1 de 3
Solução de problemas
Resolver sozinho os problemas comuns (WhatsApp desconectado, extensão sem o app, conversa que não abre, campanha parada).
Antes de começar
Nada: pode começar por aqui.
Passo a passo
Cada problema traz o sintoma (o texto que aparece na tela), as causas verificadas no código ou em testes, como conferir, como resolver e quando procurar o suporte. Hipóteses não confirmadas estão marcadas como tal.
Antes de pedir ajuda, veja Como pedir suporte: o que enviar e o que nunca enviar.
O WhatsApp não conecta ou desconectou
Sintoma. A barra do topo mostra um destes estados em vez de "Conectada":
| Estado na barra | Causa verificada | Como resolver |
|---|---|---|
| "Aguardando QR Code" | A conta foi criada, mas o QR ainda não foi lido | No celular: WhatsApp › Dispositivos conectados › Conectar dispositivo. Leia o QR do app. |
| "Precisa conectar de novo" | O WhatsApp desconectou este computador, pelo celular ou por tempo sem uso | Leia o QR Code de novo |
| "Sessão encerrada" | Alguém clicou em "Encerrar sessão" neste computador | Clique em "Conectar de novo" e leia o QR |
| "Sem conexão" | O computador ficou sem acesso ao WhatsApp | Confira a internet. Clique em "Tentar agora". |
| "Erro" ("A página do WhatsApp parou de responder…") | A página do WhatsApp travou | Clique em "Recarregar" |
| "Suspensa" | A conta foi suspensa pelo menu "⋯" | Menu "⋯" da conta › Retomar |
| "Número diferente" ("Outro número conectado…") | O QR foi lido com outro celular | Escolha "Usar <número> nesta conta" se estiver certo, ou "Encerrar sessão" e leia com o celular certo |
No painel do CRM: a faixa vermelha "Atenção: Sessão expirada. Faça login manual." quer dizer que o WhatsApp está pedindo o QR Code. Uma campanha assistida em andamento é pausada. Depois de reconectar, aparece "WhatsApp conectado de novo. Clique em Continuar para retomar a campanha.".
Limite conhecido: depois que o computador dorme (suspensão), a conta pode continuar "Conectada" por um tempo sem estar. Se as mensagens não chegam, clique em Recarregar no menu "⋯" da conta.
Procure o suporte se: o QR Code não aparece, ou se aparece "Erro" de novo logo depois de recarregar.
A extensão do Chrome não abre o CRM
Sintoma. O painel da extensão mostra uma tela de conexão em vez do CRM:
| Texto | Causa verificada | Como resolver |
|---|---|---|
| "O Valente Connect está fechado" | A extensão depende do app: os dados ficam nele | Clique em "Abrir o Valente Connect". Se você saiu pelo "Sair", a extensão não reabre o app sozinha. |
| "Para usar o Valente Connect, instale o aplicativo desktop" | O app não está instalado neste usuário do Windows | Instale (Como instalar, atualizar e desinstalar o app e conectar o WhatsApp) e clique em "Já instalei — verificar conexão" |
| "O aplicativo não respondeu" | O app está abrindo ou travou | "Tentar de novo". Se repetir, saia do app pela bandeja e abra de novo. |
| "Atualize o Valente Connect" | Extensão e app em versões que não conversam | "Baixar a versão mais nova" do app e instale por cima |
| "Ative o Valente Connect" / "Licença vencida" | Só em instaladores com licença | veja as instruções de licença enviadas com o instalador |
| Faixa "— o que aparece pode estar desatualizado e nada pode ser salvo agora." | A conexão com o app caiu depois de carregar | "Tentar de novo" |
Dicas da própria tela ("Ajuda para conectar"): o app e o Chrome precisam estar no mesmo usuário do Windows, e cada perfil do Chrome precisa da extensão instalada.
A conversa não abre pelo CRM
Sintoma. Ao clicar em "Abrir conversa", aparece uma destas mensagens:
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Contato não encontrado no WhatsApp pelo nome e sem telefone cadastrado para abrir pelo número." | O nome no CRM é diferente do nome no WhatsApp e não há telefone | Cadastre o telefone na ficha (Editar) |
| "O WhatsApp não aceitou o telefone deste contato (número inválido ou sem WhatsApp). Confira o número no cadastro." | O número está errado ou não tem WhatsApp. O WhatsApp não diz qual dos dois. | Confira o DDD e os dígitos |
| "Há mais de um contato com esse nome. Abra a conversa certa pelo WhatsApp." | Dois contatos com o mesmo nome no WhatsApp | Abra pela lista do WhatsApp ou cadastre o telefone |
| "O WhatsApp abriu outra conversa. Confira o telefone do contato." | O telefone no CRM é de outra pessoa | Corrija o telefone |
| "Recarregue o WhatsApp Web (F5) e tente de novo." | A página do WhatsApp ficou desatualizada | Clique no WhatsApp e aperte F5 |
| "Abra o WhatsApp Web primeiro." | O WhatsApp não está conectado | Veja o primeiro problema acima |
Bom saber: quem não está na agenda do celular é aberto pelo número, com o link oficial do WhatsApp. A página do WhatsApp recarrega nessa hora, e isso é normal.
A ficha não aparece ou aparece "Nenhuma conversa aberta"
- Conversa de grupo: a ficha só funciona em conversas individuais.
- WhatsApp desconectado ou precisando recarregar: o painel mostra "Nenhuma conversa aberta" mesmo com a conversa aberta. Confira a barra do topo.
- Cliente fixado: se a faixa do Cliente diz "Cliente escolhido no CRM" (selo Fixado), a ficha não segue a conversa. Clique em "Voltar a acompanhar a conversa".
Uma campanha parou ou não terminou
| O que aparece | O que significa | O que fazer |
|---|---|---|
| Cartão "Pausada", com "O app foi fechado durante o envio…" | O app fechou no meio do envio automático. Ele não recomeça sozinho. | "Retomar envio automático". O que estava no meio é conferido na conversa antes de qualquer reenvio. |
| "Requer atenção" | O envio automático parou por um motivo: sessão expirada, WhatsApp escondido, 3 falhas seguidas, licença… | Leia o motivo no cartão, resolva e retome |
| Histórico: "Não terminou", com "Continuar envio (N)" | A campanha foi encerrada ou cancelada com contatos que nunca receberam | "Continuar envio": reabre só quem nunca recebeu |
| "Sem confirmação" | O clique de enviar aconteceu, mas o WhatsApp não mostrou o ✓ | Confira na conversa. Esses contatos não são reenviados sozinhos, para não mandar duas vezes. |
| "O WhatsApp do número remetente precisa ficar à vista durante o envio…" | O envio automático não envia com o WhatsApp escondido | Deixe o WhatsApp da conta remetente à vista |
A aba Hoje mostra esses casos em "Envios que não terminaram", e a aba Envios ganha um número. Detalhes no Entender os números de uma campanha.
Um contato não recebeu a campanha
Veja "Não enviadas (N)" no cartão da campanha: cada contato aparece com o motivo. Motivos comuns:
- "Número inválido ou sem WhatsApp";
- "Não encontrado no WhatsApp pelo nome (e sem telefone…)";
- "Nome repetido no WhatsApp";
- "Marcou "Não receber campanhas"…";
- "Mesmo telefone de outro destinatário desta campanha".
Limite conhecido: contatos barrados por uma jornada aparecem como "Sem motivo registrado".
Não consigo salvar nada
| Sintoma | Causa | O que fazer |
|---|---|---|
| "O aplicativo Valente Connect não está conectado. Nada foi salvo." (na extensão) | O app está fechado ou a conexão caiu | Abra o app e "Tentar de novo" |
| Faixa "CRM somente leitura — <estado>" | Licença não ativa: só em instaladores com licença | veja as instruções de licença enviadas com o instalador. Ver, pesquisar, exportar e backup continuam funcionando. |
| "Não foi possível salvar. Tentar de novo" (na ficha) | A gravação falhou na hora | Tentar de novo. Se repetir, procure o suporte. |
O Windows bloqueou o instalador
Sintoma. "O Windows protegeu o computador".
Causa verificada: o instalador ainda não tem assinatura digital.
Como resolver: clique em "Mais informações" e depois em "Executar assim mesmo". Faça isso só com o arquivo recebido de quem vendeu o Valente Connect.
Se o antivírus apagar o arquivo: fale com o suporte. Não desligue o antivírus.
Perdi dados ou restaurei o backup errado
- Logo depois de restaurar ou mesclar: use "Recuperar dados anteriores", no aviso que aparece. Ele guarda só a última operação.
- App desktop: há cópias automáticas diárias em
%LOCALAPPDATA%\ValenteConnect\backups\(as 7 mais novas). Restaurar é manual e não traz fotos e anexos. Procure o suporte para fazer isso com segurança. - Passo a passo no Usar backup e dois computadores.
Versão demonstrada: app 0.2.0 · painel 0.5.0.