Procedimento detalhado para criação, validação e solução de conflitos nas cargas XML de integração com portais imobiliários (Grupo OLX/Canal Pro, VivaReal, ZAP, Chaves na Mão, DF Imóveis), correção de metragem de área útil zerada, adição/remoção individual de imóveis da carga e funcionamento automático do Arbo Hub.
Visão geral
O Imobiliárias CRM exporta os anúncios para os portais imobiliários através de arquivos XML padronizados (formato VrSync) gerados em Marketing > Portais. Todas as cargas passam por um processamento diário automático às 22h. Além das integrações individuais contratadas pela imobiliária com cada portal, as licenças que contam com o Arbo Hub publicam automaticamente os imóveis em uma rede de portais parceiros sem necessidade de configuração manual de XML.
Quando usar
Utilize este procedimento quando:
- Imóveis recém-cadastrados ou editados (destaques, fotos ou valores) ainda não tiverem atualizado no portal imobiliário;
- O portal Canal Pro / Grupo OLX exibir a Área Útil do imóvel como 10 m²;
- Você precisar retirar um imóvel específico dos portais mantendo-o publicado apenas no site da imobiliária (ou adicioná-lo de volta à carga);
- A imobiliária receber leads ou visualizar anúncios no ImovelWeb, Casa Mineira, Dream Casa, Buskaza ou QuintoAndar sem ter criado carga XML para esses portais.
Sintoma ou cenário comum
A equipe altera um imóvel para Super Destaque ou cadastra novas unidades à tarde e, ao consultar o portal imediatamente, a alteração não consta; ou o gestor nota que imóveis sem área útil preenchida aparecem com 10 m² no Grupo OLX; ou ainda tenta desmarcar a publicação na ficha do imóvel sem conseguir tirá-lo apenas da carga do portal.
Benefício da resolução
- Sincronização previsível e sem erros de leitura XML nos principais portais do mercado;
- Controle total sobre quais imóveis consomem o limite do pacote contratado (padrão, destaque e super destaque);
- Correção definitiva de metragens substituídas automaticamente por falta de preenchimento;
- Compreensão clara dos leads gerados pelo Arbo Hub Premium.
Onde acessar no sistema
No menu lateral do Imobiliárias CRM, acesse Marketing > Portais (ou Menu Principal > Portais) e o cadastro individual em Imóveis > Gestão de Imóveis.
Pré-requisitos e permissões
- Perfil de Gestor ou Diretor no Imobiliárias CRM;
- Conta ativa junto ao portal terceiro (quando se tratar de integração direta fora do Arbo Hub);
- Imóvel com status ativo, endereço válido e pelo menos uma foto cadastrada.
Causas prováveis
- Consulta realizada no portal antes do ciclo diário de atualização do arquivo XML (que ocorre todos os dias às 22h);
- Campo Área Útil deixado com valor
0(zerado) no cadastro do imóvel — como o Canal Pro rejeita imóveis com área útil zerada, o integrador envia o valor mínimo10para não bloquear o anúncio; - Limite de anúncios ou de destaques configurado na carga do CRM diferente do pacote contratado junto ao portal (ex.: 35 padrões + 5 destaques);
- Atuação automática do Arbo Hub, que publica diretamente pelas contas corporativas do Hub sem exibir link XML na tela de portais.
Passo a passo: Como fazer ou corrigir
- Criar ou Copiar o Link da Carga XML e Respeitar a Janela das 22h:
- Acesse Marketing > Portais (ou Portais > + Novo registro caso esteja configurando um portal pela primeira vez);
- Defina a quantidade de imóveis do seu pacote contratado (ou habilite a opção de enviar todos os imóveis em anúncio) e salve;
- Copie o Link XML gerado (padrão VrSync) e abra-o em uma aba do navegador para confirmar que o código XML carrega sem erros;
- Importante: Toda nova carga criada ou alteração feita durante o dia é processada na rotina noturna às 22h. Envie o link ao suporte do portal (ex.: Chaves na Mão, Grupo OLX, DF Imóveis) ou valide as alterações na manhã do dia seguinte.
- Remover ou Readicionar um Imóvel Especificamente da Carga de Portais:
- Para tirar um imóvel dos portais mantendo-o visível no site da imobiliária (ou gerenciar manualmente os imóveis de uma integração), acesse Marketing > Portais e abra a carga do portal desejado;
- Na listagem de imóveis da carga, pesquise o imóvel pelo seu código completo, selecione a caixa de marcação correspondente e clique em Remover da carga;
- Quando desejar que o imóvel volte a ser enviado ao portal, acesse o mesmo local na carga do portal, localize o imóvel pelo código, selecione-o e clique na opção "Adicionar à carga".
- Corrigir Imóveis com Área Útil Igual a 10 m² no Canal Pro (Grupo OLX):
- Acesse Imóveis > Gestão de Imóveis, localize o imóvel pelo código e clique em Editar;
- Na seção de medidas/características, preencha o campo Área Útil com a metragem real do imóvel (nunca deixe
0ou vazio) e salve; - Após a atualização das 22h, o valor real substituirá automaticamente o número
10no portal.
- Identificar Anúncios e Leads Vindos do Arbo Hub:
- Caso sua imobiliária receba leads de portais como ImovelWeb, Casa Mineira, Dream Casa (incluindo rede parceira QuintoAndar) e Buskaza sem possuir contrato direto com eles, verifique se o seu plano inclui o Arbo Hub;
- No Arbo Hub, a publicação ocorre diretamente através das contas oficiais do Hub nos portais (por isso não há arquivo XML individual listado em Marketing > Portais), e os leads entram automaticamente no seu CRM vinculados ao código único de cada imóvel.
Como validar se funcionou
No dia seguinte à alteração (após o ciclo das 22h), abra o link do arquivo XML no navegador, pressione Ctrl + F e busque pelo código completo do imóvel (ex.: AP0476_SUFIXO). Se o imóvel e seus atributos (preço, área útil e tipo de destaque) constarem no XML, o envio pelo CRM está 100% operacional.
Erros comuns e como evitar
- Enviar o link XML recém-criado ao portal antes da 1ª atualização das 22h: Se você criar a carga hoje às 14h e enviar imediatamente ao portal, o arquivo ainda estará vazio. Aguarde o processamento das 22h e envie no dia seguinte.
- Tentar remover o imóvel do portal apenas pelo botão na ficha do imóvel: A gestão fina de presença por portal deve ser feita diretamente dentro de Marketing > Portais (Remover da carga / Adicionar à carga).
Boas práticas
- Caso um imóvel já apareça atualizado dentro do arquivo XML do CRM mas ainda não tenha refletido no site do portal terceiro após 24 horas, capture um print do trecho do XML com o código do imóvel e acione o suporte do portal para que forcem a leitura da fila.
- Mantenha a contagem de Destaques e Super Destaques no CRM idêntica ao limite contratado no portal para evitar rejeição de carga.
Quando acionar o suporte
Acione o Suporte CRM (menu CRM Imobiliárias > Suporte CRM > Integração / Imóveis) caso o atributo de destaque ou um imóvel ativo não apareça dentro do código-fonte do link XML mesmo após o ciclo das 22h.
Perguntas frequentes (FAQ)
1. Qual é o horário exato em que a carga XML dos portais é atualizada?
A rotina de atualização das cargas XML roda diariamente a partir das 22h. Qualquer edição realizada no CRM durante o expediente refletirá nos portais no dia seguinte.
2. Posso usar o XML do CRM para integrar com assistentes de IA (como Lais IA ou Plaza) ou Facebook Marketplace?
Sim. Basta gerar uma carga em Marketing > Portais no formato padrão XML VrSync (ou catálogo para Facebook) e fornecer a URL gerada para a plataforma parceira. Caso utilize IA de atendimento, solicite ao parceiro que configure o seu domínio próprio no lugar do domínio padrão.
3. Imóveis com status "Anúncio Pausado" vão para a carga XML dos portais?
Não. Imóveis pausados ou removidos da carga não são enviados no XML dos portais e, no site da imobiliária, só podem ser visualizados por quem possuir o link direto, não aparecendo na busca geral.
Exemplos práticos
Cenário: A imobiliária reativou seu contrato com o portal Chaves na Mão e percebeu que os novos imóveis não estavam subindo, além de dois apartamentos aparecerem com 10 m² no Canal Pro.
Resolução aplicada: O gestor acessa Marketing > Portais, ajusta o limite da carga para contemplar todo o pacote contratado, copia o link XML atualizado e encaminha ao portal. Em paralelo, preenche a Área Útil real dos dois apartamentos no CRM. Após as 22h, todos os anúncios sincronizam corretamente.
Resumo rápido
- Copie e gerencie os links XML em Marketing > Portais;
- Lembre-se de que as cargas atualizam diariamente às 22h;
- Use Remover da carga / Adicionar à carga dentro do portal no CRM para controlar quais imóveis vão para cada canal;
- Preencha sempre a Área Útil no cadastro do imóvel para evitar que o Canal Pro exiba
10 m².