Mensagens de erro — o que significam e o que fazer

Este é o guia de referência dos erros do sistema: o que cada mensagem quer dizer, a causa provável e o que fazer. Use para se orientar e, ao abrir um chamado, mande um print da mensagem completa — é o que faz o suporte resolver rápido.

Login e sessão

Mensagem	O que significa	O que fazer
Usuário ou senha inválidos	Login, senha ou licença errados	Confira os dados; se mudou a senha no CRM antigo, use a nova
Confirme que você é humano para continuar	Muitas tentativas de login dispararam a verificação de segurança	Resolva o "não sou robô" e prossiga (é proteção contra ataque)
Muitas tentativas. Aguarde N minuto(s)	Bloqueio temporário por tentativas seguidas	Espere o tempo indicado e tente de novo
Sua sessão expirou / Faça login novamente	A sessão caiu ou você entrou em outro dispositivo	Faça login de novo (o sistema permite uma sessão por vez)
Sistema bloqueado por pendência financeira	A licença está com pagamento em aberto	O administrador acerta o pagamento; depois o acesso volta
SSO ... (token inválido/expirado/já utilizado)	O link "Novo CRM" vindo do sistema antigo expirou ou foi reusado	Volte ao CRM antigo e clique de novo no botão

"Erro interno" e o código que aparece (ref:)

Quando uma tela quebra de forma inesperada, o sistema mostra "Ops, deu ruim" ou "Não foi possível abrir", às vezes com um código tipo ref: a1b2c3....

• Esse ref: é um código técnico do momento do erro. Ele muda a cada nova versão do sistema, então não é um código fixo — serve para o suporte localizar o erro no painel interno.
• O que fazer: clique em "Tentar de novo". Se persistir, abra um chamado informando o ref:, a tela onde aconteceu, o horário e a sua licença.

Importante: muitas vezes "erro interno" é só instabilidade momentânea de conexão com o servidor — recarregar resolve. Se acontecer logo após uma atualização do sistema, a página costuma se recarregar sozinha.

Conexão com o servidor

Mensagem	O que significa	O que fazer
Não conseguimos falar com o servidor agora	Instabilidade momentânea de conexão	Aguarde alguns segundos e tente de novo
Backend indisponível	O servidor não respondeu a tempo	Recarregue; se persistir por minutos, acione o suporte
Limite de uso excedido / Muitas requisições	Excesso de chamadas em pouco tempo (às vezes uma integração em loop)	Reduza o ritmo; se for integração própria, revise o laço de chamadas

Permissões

Mensagem	O que significa	O que fazer
Requer permissões: ... (lista as permissões)	Falta a permissão citada para essa ação	Um administrador habilita a permissão em Gestão › Usuários (ver Permissões)
Você não tem permissão para visualizar leads	Falta a permissão "Ver seus leads"	Administrador habilita em Usuários
Menu com cadeado	Falta "Ver Marketing" ou "Ver Gestão"	Administrador libera a permissão correspondente

Upload de fotos

Sintoma	Causa provável	O que fazer
Salve o cadastro básico para enviar fotos	O imóvel ainda não foi salvo	Salve o cadastro; a área de fotos libera depois
Sessão expirada ao enviar	A sessão caiu durante o upload	Faça login de novo e reenvie
Falha ao processar imagem	Arquivo corrompido ou formato não suportado	Reexporte como JPG/PNG e reenvie
Erro sem mensagem clara ao enviar muitas fotos	Lote grande ou arquivo acima de 25 MB	Envie menos fotos por vez e reduza imagens muito pesadas
Falha ao enviar / erro de rede	Instabilidade momentânea	Tente de novo em instantes

Detalhes em Fotos do imóvel.

Portais (XML)

Sintoma no card do portal	O que significa	O que fazer
Erro no XML (500)	O arquivo do portal falhou ao ser gerado	Veja o "Detalhe" no modal, clique em Atualizar; se persistir, mande o print ao suporte
"Última solicitação" muito antiga	O portal não está lendo o XML	Confira no painel do portal se a URL do XML está cadastrada certa
Erros reportados pelo portal (HTTP 400/404...)	O portal recusou um anúncio	Veja a referência e a mensagem no modal; ajuste o imóvel apontado
URL desatualizada — copie a nova URL do XML	A URL antiga do feed parou de valer	Copie a URL atual na tela Portais e recadastre no portal

Facebook / Meta

Sintoma	O que significa	O que fazer
Integração ainda não configurada no servidor	Falta o administrador concluir a configuração inicial do app Meta	É configuração de servidor; acione o suporte/administrador
Conexão com status EXPIRED / ERROR / REVOKED_BY_USER	O acesso ao Facebook expirou ou foi removido	Clique em Reativar ou reconecte a conta (ver Integração do Facebook)
Lead marcado como "Não distribuído"	O lead chegou mas não foi atribuído a ninguém	Verifique o mapeamento do formulário e as regras da Roleta
state expirou (>10 min) ao conectar	Você demorou para autorizar no Facebook	Refaça a conexão

WhatsApp e IA

Sintoma	O que significa	O que fazer
Falha ao enviar mensagem / WhatsApp desconectado	O número do WhatsApp caiu	Reconecte o número (reescaneie o QR Code)
IA respondeu valor/informação errada	O imóvel pode ter mudado e a IA usou dado antigo	Confira o valor no cadastro; reporte ao suporte com print (é prioridade)
No chat do Insider: "⚠️ ..." (erro do provedor)	A chave de IA da imobiliária ficou inválida	Um administrador reconfigura a chave nas configurações do Insider
Chave inválida (badge vermelho) no Insider	A chave de API foi recusada pelo provedor	Gere/atualize a chave e salve novamente
IA diz "ainda não tenho essa informação"	Não é erro — a IA evita inventar e registra a dúvida	A pergunta vai para a fila de melhoria; pergunte de outro jeito ou acione um corretor

Quando abrir um chamado (e o que mandar)

Para o suporte resolver rápido, envie sempre:

1. Print da mensagem completa (incluindo o ref: se aparecer).
2. A tela/endereço onde aconteceu.
3. O horário aproximado e a sua licença (aparece abaixo do seu nome no menu do perfil).
4. O que você estava fazendo quando o erro apareceu.