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 › Divulgação de imóveis › Portais imobiliários — 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. O XML é gerado na hora em que o portal pede, e cada portal costuma lê-lo a cada 12 a 24 horas.

No card de cada portal aparecem:

  • Atualizado pelo cliente — a última vez que alguém da sua equipe clicou em Atualizar naquele portal.
  • Selo do webhook de leads (nos portais que mandam leads): Webhook ok, Último lead há N dias (sem lead há mais de 15 dias — provavelmente o webhook foi desconectado no painel do portal) ou Webhook nunca recebeu lead.
  • N no XML — quantos imóveis o XML daquele portal levou na última atualização, já respeitando os limites e a opção de Quais imóveis publicar. Aparece depois que o XML é gerado pelo menos uma vez.
  • Erro no XML — aparece em vermelho quando o arquivo falhou ao ser gerado.

Botões do card

Na linha de cada portal ficam:

  • Abrir XML — abre o arquivo do portal numa nova aba.
  • Copiar Webhook — copia o endereço para onde o portal manda os leads. Só aparece nos portais que têm webhook de leads.
  • Atualizar — força a geração do XML agora (limite de 3 vezes a cada 10 minutos).
  • ⋮ (Mais ações) — abre o menu com Configurações e URLs, Enviar e-mail de integração (só em alguns portais, veja abaixo) e Desvincular todos os imóveis (só administrador).
  • Ativo / Inativo — a chave no canto direito liga ou desliga o portal para a sua conta.

Clicar em qualquer ponto livre do card também abre as Configurações: as URLs de integração, N. Cliente (nos portais que exigem), Limites de anúncios por nível de destaque, Privacidade do imóvel e Quais imóveis publicar.

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.

Enviar e-mail de integração (onde fica e quando aparece)

O Enviar e-mail de integração fica no menu ⋮ (Mais ações) do card do portal — e também no painel Configurações e URLs, logo abaixo das URLs de integração, como Enviar e-mail de integração para o nome do portal. Ele abre o seu programa de e-mail (Outlook, Gmail do computador, Mail…) com uma mensagem pronta para o portal: assunto "Ativar Integração", a URL do XML de imóveis e, quando existir, a URL do webhook de leads. Você revisa e envia da sua caixa de e-mail.

Importante: o item só aparece nos portais que têm um e-mail de contato cadastrado no sistema — e hoje isso vale para poucos portais. Na maioria deles, o menu ⋮ mostra só Configurações e URLs (e, para o administrador, Desvincular todos os imóveis). Não é erro nem falta de permissão.

Quando o botão não aparece, faça assim:

  1. No card do portal, clique em ⋮ › Configurações e URLs (ou clique no card).
  2. Em URL do XML de imóveis, clique em Copiar. Se o portal tiver Webhook de leads, copie também.
  3. Mande essas URLs ao portal pelo canal que ele usa — o painel do anunciante, o e-mail do seu gerente de contas ou o atendimento do portal. Se o portal te deu um código de cliente (número da sua conta lá), cite-o para eles localizarem seu cadastro.

Dica: o e-mail pronto sai pelo programa de e-mail do seu computador. Se clicar e nada abrir, o computador não tem um programa de e-mail configurado — use o caminho de copiar as URLs acima.

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 Webhook de leads (botão Copiar Webhook no card, ou em ⋮ › Configurações e URLs) 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 o que vai para cada portal em três lugares:

  1. Na lista de Imóveis, um imóvel — clique no ícone de megafone (dica Portais) 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.
  3. Vários imóveis de uma vez — na Lista de Imóveis, marque os imóveis (ou use Selecionar os N do filtro) e clique em Portais na barra do rodapé: escolha Enviar para o portal ou Remover do portal, o portal e o nível. Veja Enviar (ou tirar) vários imóveis de um portal de uma vez.

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. Clique no card do portal (ou em ⋮ › Configurações e URLs).
  2. Em Limites de anúncios, defina os limites por nível de destaque (padrão, destaque, super destaque…) e clique em Salvar configurações.
  3. Copie a URL do XML de imóveis e cadastre no painel do portal — ou use Enviar e-mail de integração, quando o portal tiver esse item no menu ⋮.
  4. Para receber leads no CRM, copie também o Webhook de leads e informe ao portal.
  5. Marque os imóveis desejados (ou deixe o sistema completar) e clique em Atualizar no card.

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. Imóvel com Disponível desligado também não vai para nenhum portal.
  • O contador do limite mostra menos imóveis do que o XML — os campos de limite mostram só os imóveis marcados (por exemplo, 222 marcados / 400). Com Todos os imóveis (aleatório), o XML completa o resto da cota sozinho, então vão mais imóveis do que os marcados. O número que vai de fato aparece no card (N no XML) e no topo de Limites de anúncios (Hoje vão N imóveis no XML deste portal).
  • Como desativar um portal — desligue a chave Ativo / Inativo no canto direito do card (ou zere os limites/desmarque os imóveis) e remova a URL do XML no painel do portal; ele para de receber seu estoque.
  • "Não encontramos essa imobiliária no Casa Mineira" (ou no Imovel Web) ao ativar a integração de leads — antes de informar o Código ou e-mail no portal aqui, é preciso escolher a opção de integração de leads CRM ImobTotal dentro do painel do portal. Feito isso, volte à tela de Portais, clique em Ativar no card do portal e informe o código ou o e-mail de novo. Se não achar a opção no painel, fale com o suporte do portal.
  • Não aparece "Enviar e-mail de integração" no menu ⋮ — esse portal não tem e-mail de contato cadastrado no sistema. Copie a URL do XML de imóveis em ⋮ › Configurações e URLs e mande ao portal pelo canal dele (veja Enviar e-mail de integração).
  • As imagens não aparecem no portal — confira se os imóveis têm fotos e estão com Disponível no site ligado; 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.
  • O portal não mostra as mudanças — o portal lê o XML no ritmo dele (normalmente a cada 12 a 24 horas). Se passar disso, verifique no painel do portal se a URL do XML foi cadastrada certa.
  • Portal exibe o tipo errado (ex: "Outro" em vez de "Apartamento") — ajuste seus tipos em Gestão › Cadastros do sistema › Tipos de imóvel 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.

O que não existe (e o que fazer no lugar)

  • Não existe o botão "Enviar e-mail de integração" em todos os portais. Ele só aparece no menu ⋮ dos portais com e-mail de contato cadastrado. Nos demais, copie a URL do XML de imóveis em ⋮ › Configurações e URLs e mande ao portal.
  • Não existe envio de e-mail pelo próprio sistema. O botão abre o seu programa de e-mail com a mensagem pronta; quem envia é você.
  • Não existe botão "Configurar" separado no card. As configurações abrem clicando no card ou em ⋮ › Configurações e URLs.
  • Não existe cadastrar o e-mail de contato do portal por esta tela. Se o portal que você usa não tem o item, use o caminho de copiar as URLs.

Perguntas frequentes

Onde fica o botão "Enviar e-mail de integração"? No menu ⋮ (Mais ações) do card do portal. Ele só aparece nos portais com e-mail de contato cadastrado no sistema; nos outros, copie a URL do XML em Configurações e URLs e mande ao portal.

Um imóvel fora do site continua com o portal marcado. Ele ocupa vaga? Não. O contador de vagas (por exemplo, 115 marcados / 600) só conta imóveis disponíveis no site e fora da lixeira. A marcação do portal pode continuar acesa no cadastro, mas não consome vaga — se o imóvel voltar ao site, volta a contar com o mesmo nível.

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, na chave Disponível no site, não aqui.