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 |
| Entro e sempre abre o CRM antigo | O endereço salvo no navegador é o do sistema antigo | Entre por https://app.imobtotal.com.br/login com Código da imobiliária, Usuário ou e-mail e Senha, e salve esse endereço nos favoritos |
| E-mail ou senha não conferem. Esse acesso é para contas de demonstração — corretores entram com Apple ou Google. (aplicativo do iPhone e do Android; no Android a frase termina em "entram com Google") | Você digitou o login do CRM no formulário de demonstração do aplicativo (link "Entrar com e-mail e senha" na versão 1.4.4; "Acesso de demonstração (avaliador da Apple)" nas seguintes, "avaliador do Google Play" no Android). No aplicativo não se usa a senha do CRM | Toque em Voltar e entre com Apple ou Google (no Android, Google); depois conecte pelo QR code ou código em seu nome › Entrar no aplicativo. Não troque a senha nem reinstale: veja Aplicativo |
| Código inválido ou expirado. Gere um novo no computador. (aplicativo do iPhone e do Android) | O código de conexão do aplicativo vale 5 minutos e uma vez só | No CRM, seu nome › Entrar no aplicativo › Gerar novo código e leia (ou copie) o novo |
| Este QR code não é o de acesso do ImobTotal. (aplicativo do iPhone e do Android) | A câmera de dentro do aplicativo leu outro QR (link, imóvel, Pix, QR da loja) | Leia o QR da janela Entrar no aplicativo com o botão Ler QR code do aplicativo, ou use Tenho um código |
Importante: os erros da tela de entrada do aplicativo (iPhone e Android) não têm código IT. O IT-3001 ("Dados inválidos") é de uma tela do CRM que ficou desatualizada durante uma atualização do sistema: recarregue a página (no aplicativo, puxe a tela para baixo ou feche e abra) e ele some. Ele não aparece no login do aplicativo, e nenhum problema de entrada no aplicativo se resolve trocando a senha ou reinstalando.
"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.