ImobTotalCentral de Ajuda

Portais (Zap, Viva Real, OLX)

O ImobTotal funciona como um HUB de distribuição: você cadastra o imóvel uma vez e ele é enviado e atualizado automaticamente nos portais configurados — sem retrabalho manual.

Onde fica

Menu Marketing › Portais imobiliários.

Como funciona (o XML)

O sistema gera um arquivo (o XML) com todos os seus imóveis num formato padrão. O portal lê esse arquivo e monta os anúncios. Você cadastra o link do XML no painel do portal uma única vez.

No card de cada portal você vê dois horários importantes:

  • Último processamento — quando o nosso servidor gerou o XML pela última vez.
  • Última solicitação — quando o portal buscou o XML pela última vez. Se esta data estiver muito antiga, o problema costuma estar no portal, que não está lendo o arquivo.

Botões e configuração

  • Atualizar — força a geração do XML agora.
  • Configurar — define limites, níveis de destaque e filtros.
  • Caminho do XML — a URL que você cadastra no painel do portal.
  • Caminho de integração de leads — a URL (webhook) que o portal usa para mandar os leads dos anúncios direto pro CRM.

As duas URLs da integração (onde copiar cada uma)

Toda integração de portal tem duas pontas, e as duas URLs já ficam prontas na tela — clique no card do portal (ou em Configurações e URLs) para abrir o painel com os botões Copiar:

  • URL do XML de imóveis (saída) — é daqui que o portal importa os seus anúncios. Cadastre essa URL no painel do portal (ou envie ao contato comercial dele).
  • Webhook de leads (entrada) — é para cá que o portal envia os contatos interessados, que entram no CRM e passam pela Roleta de distribuição. Nem todo portal oferece webhook; quando oferece, a linha aparece no painel.

Dica: se o portal tiver e-mail de integração cadastrado, o botão Enviar e-mail de integração monta uma mensagem pronta com as duas URLs no corpo — você só revisa e envia. Se o portal te deu um código de cliente (número da sua conta lá), cite-o nesse e-mail para eles localizarem seu cadastro.

Importante: alguns portais (ex.: Imovel Web) exigem informar o código de cliente aqui na configuração — nesses casos o campo N. Cliente aparece no painel do portal. Nos demais, o código que o portal te fornece é só a referência da sua conta com eles; não precisa ser cadastrado no ImobTotal.

SUB100: o webhook de leads do SUB100 passa por uma homologação feita pelo portal. Copie o Caminho de integração de leads do card e peça a liberação ao contato comercial do SUB100 ([email protected]), citando a sua imobiliária. Enquanto a homologação não estiver concluída, o portal ainda não envia os contatos — o XML de imóveis continua funcionando normalmente.

Como marcar imóveis para o portal

Você escolhe imóvel por imóvel o que vai para cada portal, em dois lugares:

  1. Na lista de Imóveis — clique no ícone de megafone no card do imóvel. Abre a lista de portais habilitados com os níveis (padrão, destaque, super destaque…). Marque o portal e o nível desejado.
  2. Na ficha do imóvel (Incluir/Editar Imóvel) — a seção Portais tem as mesmas opções.

Também dá para marcar Não ir para Portais quando um imóvel não deve sair em nenhum portal. E lembre da regra de vagas: cada nível respeita o limite do seu contrato com o portal — imóvel marcado sem vaga no nível não entra no XML.

"Quais imóveis publicar"

Na tela de configuração do portal você escolhe uma das três opções:

  • Todos os imóveis (aleatório) — os imóveis marcados para o portal entram garantidos e as vagas restantes dos limites são preenchidas aleatoriamente com os demais imóveis disponíveis. Útil para a carga inicial sem precisar marcar tudo.
  • Somente imóveis marcados — vão só os imóveis que você marcou para aquele portal. Se marcar menos que o limite do plano, as vagas restantes ficam vazias.
  • Imóveis marcados primeiro, completando por pontuação — os marcados entram primeiro e, se não preencherem o limite do plano, o sistema completa automaticamente com os imóveis não marcados de melhor pontuação de cadastro (anúncios mais completos na frente).

Como integrar um portal

  1. Abra o portal e clique em Configurar.
  2. Defina os limites por nível de destaque (padrão, destaque, super destaque…).
  3. Copie o Caminho do XML e cadastre no painel do portal.
  4. Para receber leads no CRM, copie também o Caminho de integração de leads e informe ao portal.
  5. Marque os imóveis desejados (ou deixe o sistema completar) e clique em Atualizar.

Importante: os pacotes e a quantidade de anúncios são contratados direto com o portal. O ImobTotal fornece a integração (XML + leads), não o contrato de anúncios.

Atenção: Órulo, 360 e DWV não são portais — funcionam de forma diferente e ficam em Minhas integrações.

Problemas comuns

  • O portal mostra menos imóveis do que eu tenho — cada portal tem um limite de vagas (do seu contrato). Ajuste os limites por nível; imóvel sem vaga no nível não entra.
  • Como desativar um portal — em Configurar, desligue o portal (ou zere os limites/desmarque os imóveis) e remova a URL do XML no painel do portal; ele para de receber seu estoque.
  • As imagens não aparecem no portal — confira se os imóveis têm fotos e estão "Divulgar no site"; o portal pode levar horas para reprocessar. Se persistir, veja se o card do portal mostra "Erro no XML" (ver Mensagens de erro).
  • "URL de integração desatualizada" — copie a URL atual do XML aqui na tela e recadastre no painel do portal.
  • "Última solicitação" muito antiga — o portal não está lendo o XML; verifique no painel do portal se a URL foi cadastrada certa.
  • Portal exibe o tipo errado (ex: "Outro" em vez de "Apartamento") — ajuste seus tipos em Gestão › Configurações para baterem com os do portal.
  • Marquei só em "Destaque" e o imóvel sumiu — confira se há vaga nesse nível; se o limite estourou, ele não entra.

Perguntas frequentes

Quanto tempo o portal leva para atualizar? O ImobTotal envia na hora, mas o processamento no portal pode levar horas (cada um no seu ritmo).

A integração de leads funciona com todos os canais? Os portais que oferecem webhook mandam o lead pro CRM; ele entra e passa pela Roleta de distribuição.

O que muda no seu site

Esta tela é sobre portais externos, não sobre o seu site. Os imóveis do seu próprio site são controlados pelo cadastro e pelo status (Divulgar no site), não aqui.