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:
- No card do portal, clique em ⋮ › Configurações e URLs (ou clique no card).
- Em URL do XML de imóveis, clique em Copiar. Se o portal tiver Webhook de leads, copie também.
- 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:
- 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.
- Na ficha do imóvel (Incluir/Editar Imóvel) — a seção Portais tem as mesmas opções.
- 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
- Clique no card do portal (ou em ⋮ › Configurações e URLs).
- Em Limites de anúncios, defina os limites por nível de destaque (padrão, destaque, super destaque…) e clique em Salvar configurações.
- 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 ⋮.
- Para receber leads no CRM, copie também o Webhook de leads e informe ao portal.
- 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.
