O que é integração por XML com portais imobiliários e como ela funciona na prática
Por Semperia · · 7 min de leitura
Integração por XML com portais imobiliários é o mecanismo pelo qual o seu sistema publica um arquivo com todos os seus imóveis, num formato que o portal entende, e o portal lê esse arquivo de tempos em tempos para criar, atualizar e retirar anúncios. Você cadastra o imóvel uma vez; o anúncio aparece no ZAP, no VivaReal, na OLX, no Imovelweb ou em outro portal sem digitar de novo. É o que as pessoas chamam de "integração com os portais" ou "conectar o CRM ao portal".
Quem está começando costuma imaginar que precisa enviar um arquivo para cada portal, toda vez que muda algo. Não é assim. O arquivo fica num endereço fixo, o link de integração, e o portal é quem vai buscá-lo. Você conecta uma vez e esquece.
O que tem dentro do arquivo
XML é um formato de texto organizado em etiquetas, parecido com o HTML das páginas da internet. No arquivo de imóveis, cada anúncio é um bloco com os campos que o portal pede:
- Código do imóvel na sua carteira (a referência que liga o anúncio ao cadastro).
- Tipo (apartamento, casa, terreno), finalidade (venda, aluguel) e preço, com condomínio e IPTU quando houver.
- Endereço, com a regra de mostrar ou esconder rua e número.
- Quartos, suítes, vagas, áreas útil e total, ano de construção.
- Título, descrição e características (varanda, piscina, portaria).
- Os links das fotos, na ordem em que devem aparecer.
- Data da última modificação, para o portal saber o que mudou.
O arquivo inteiro é gerado pelo sistema a partir do cadastro. Você não edita XML; você edita o imóvel, e o arquivo muda sozinho.
Cada portal tem o seu formato
Não existe um XML único para todos. Os principais formatos no Brasil:
- VRSync, do Grupo OLX, lido pelo Canal Pro para publicar no ZAP Imóveis, no VivaReal e na OLX. É também o formato aceito por muitos portais regionais e pelo Mercado Livre Imóveis.
- OpenNavent, do Imovelweb. Com a localidade escrita por extenso, o mesmo arquivo vale para Imovelweb, Wimóveis e Casa Mineira. Exige descrição de pelo menos 50 caracteres e de 5 a 50 fotos por anúncio.
- Formato do Chaves na Mão e Megaportal (Lugar Certo), com campos próprios.
- Padrão antigo do ZAP ("Carga"), ainda aceito por alguns portais menores e pelo Portal do CRECI em alguns estados.
Um bom sistema gera um arquivo por portal, cada um no formato certo, a partir do mesmo cadastro. Você só ativa o link em cada painel.
Como ativar, passo a passo
- Contrate o plano no portal. A integração publica os anúncios, mas quem dá o direito de anunciar é o plano contratado com o portal. O que define o preço está em quanto custa anunciar no Canal Pro e no Imovelweb.
- Marque no sistema quais imóveis vão para os portais. Nem toda a carteira precisa ir; imóveis em sigilo ou já reservados ficam de fora.
- Copie o link de integração que o sistema gera para aquele portal.
- Cadastre o link no painel do portal. No Canal Pro, em Configurações da conta › Integração de anúncios. No Imovelweb, no Self-Service. Em portais menores, o cadastro é pedido ao suporte do portal.
- Espere a primeira leitura. O portal lê o arquivo em intervalos (de algumas horas a uma vez por dia, conforme o portal). Depois disso, toda mudança no cadastro aparece na leitura seguinte.
Algumas integrações, como a do Mercado Livre, funcionam por login na conta do portal, em vez de link; o princípio é o mesmo: o sistema entrega os imóveis, o portal publica.
O caminho de volta: os leads
A integração tem dois sentidos. O arquivo leva os imóveis para o portal; a entrada de leads traz de volta quem se interessou. No Grupo OLX, o anunciante escolhe no Canal Pro qual sistema recebe os contatos, e eles chegam ligados ao código do imóvel. No Imovelweb, o portal envia cada contato ao sistema homologado, também com a referência do anúncio. Quando o portal não tem esse caminho, o lead chega por e-mail, e um sistema que lê esse e-mail resolve.
O ganho é que o lead já nasce ligado ao imóvel certo, com a origem gravada, e o corretor é avisado no celular. Como organizar esses contatos a partir daí está em como organizar leads de portal.
O que pode dar errado
- Anúncio recusado por falta de fotos. O Imovelweb exige no mínimo 5 fotos; imóveis com menos ficam fora do arquivo. Veja como fotografar imóvel com celular.
- Descrição curta ou com símbolos. Alguns portais recusam emojis e textos abaixo do mínimo. Escreva a descrição completa no cadastro.
- Endereço incompleto. Sem cidade, bairro e CEP válidos, o anúncio não entra na busca por região.
- Imóvel duplicado. Se você cadastrou o mesmo imóvel no painel do portal e no sistema, aparecem dois anúncios. Escolha uma origem só, de preferência o sistema.
- Preço diferente entre os lugares. Acontece quando parte dos imóveis é atualizada à mão no portal. Com a integração, a única fonte é o cadastro.
- Link de integração sem imóveis marcados. Alguns portais recusam cadastrar um arquivo vazio. Marque os imóveis antes de ativar.
Integração não é importação
Vale separar dois movimentos. A integração por XML leva os seus imóveis do sistema para o portal. A importação faz o caminho inverso: traz para o sistema os imóveis que você já anuncia. Os grandes portais não permitem copiar o anúncio a partir do link; o que funciona é usar o arquivo do portal, o link do seu próprio site ou colar o texto e as fotos do anúncio. Para a carteira inteira, o arquivo do portal é o caminho mais rápido.
Como a Semperia integra com os portais
Na Semperia, você conecta uma vez e todo imóvel marcado vai sozinho. O sistema gera um link de integração para cada portal, no formato de cada um: ZAP Imóveis, VivaReal e OLX pelo Canal Pro, Imovelweb, Wimóveis e Casa Mineira num arquivo só, Chaves na Mão, Lugar Certo, Mercado Livre Imóveis (pelo login) e portais regionais. Configurações › Portais mostra o passo a passo de cada um, com o botão que abre o painel do portal.
Os leads voltam para o funil ligados ao imóvel, com aviso no celular, e a ficha do imóvel mostra em quais portais ele está. Quando um portal começa a ler o arquivo, você recebe uma tarefa confirmando. A integração faz parte de todos os planos, inclusive do Grátis, que publica até 10 imóveis. Veja o CRM imobiliário ou os planos.
Perguntas frequentes
- O que é integração por XML com portais?
- É um arquivo com todos os seus imóveis, gerado pelo sistema num endereço fixo, que o portal lê de tempos em tempos para criar, atualizar e retirar anúncios. Você cadastra o imóvel uma vez e ele aparece nos portais conectados.
- Preciso enviar o arquivo toda vez que mudo um imóvel?
- Não. O link de integração é cadastrado uma vez no painel do portal, e o portal busca o arquivo sozinho. Toda mudança no cadastro aparece na leitura seguinte.
- O mesmo arquivo serve para todos os portais?
- Não. Cada portal tem o seu formato (VRSync no Grupo OLX, OpenNavent no Imovelweb, formatos próprios no Chaves na Mão e no Lugar Certo). O sistema gera um arquivo por portal a partir do mesmo cadastro.
- A integração substitui o plano do portal?
- Não. O plano é contratado com o portal e dá o direito de anunciar. A integração só evita digitar os imóveis de novo e traz os leads de volta ao sistema.
- Os leads voltam para o CRM?
- No Grupo OLX, sim, pela escolha do sistema no Canal Pro. No Imovelweb, pelo envio do portal ao sistema homologado. Nos outros, pelo e-mail de lead, que um sistema pode ler e transformar em cliente.