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.
Todo erro tem um número. As mensagens trazem um código no fim, no formato
IT-NNNN(ex: "Dados inválidos (IT-3001)"). A lista completa de códigos com o significado de cada um está em Códigos de erro (IT-NNNN). Informe esse número ao abrir o chamado.
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:
- Print da mensagem completa (incluindo o
ref:se aparecer). - A tela/endereço onde aconteceu.
- O horário aproximado e a sua licença (aparece abaixo do seu nome no menu do perfil).
- O que você estava fazendo quando o erro apareceu.
Importante — erro é uma coisa, dúvida é outra. O chamado é para o que está quebrado: mensagem de erro na tela, lead que não chegou, cobrança. Se a sua pergunta é "como eu faço isso?", o caminho é o treinamento ao vivo: as aulas são gratuitas, acontecem cerca de três vezes por semana e terminam com tira-dúvidas aberto — inclusive o de sexta-feira, às 10h, que aceita qualquer assunto. Veja Treinamentos ao vivo.