Integração com portais imobiliários: feeds XML, rejeições e leads

Como os anúncios chegam aos portais

A forma mais comum de publicar imóveis em portais imobiliários é o feed XML: um arquivo estruturado, gerado pelo sistema da imobiliária ou da construtora, que descreve cada anúncio com seus campos, como código, tipo de imóvel, finalidade, endereço, área, dormitórios, vagas, valores de venda ou locação, condomínio, IPTU, descrição e endereços das fotos. O portal lê esse arquivo periodicamente, compara com a versão anterior e cria, atualiza ou remove anúncios. Alguns portais também oferecem APIs para envio direto, mas a lógica de manter o estoque sincronizado é a mesma.

Cada portal publica sua própria documentação, com o formato esperado, os campos obrigatórios, as listas de valores aceitos e as regras de atualização. Embora os formatos sejam parecidos, as diferenças são suficientes para causar problemas: um portal exige o tipo de imóvel em uma lista fechada, outro pede a área útil em um campo específico, um terceiro tem regras próprias para destaque e quantidade de fotos. Por isso, a integração precisa de um mapeamento por portal, e não de um único arquivo genérico enviado para todos.

Por que anúncios são rejeitados

Rejeições são o principal ponto de atrito nessas integrações, e quase sempre têm causa no cadastro, não no portal. Os motivos mais frequentes envolvem campos obrigatórios vazios, valores fora das listas aceitas, endereço incompleto ou que não pode ser localizado, fotos em resolução abaixo do mínimo ou com links quebrados, preço incompatível com a finalidade e anúncios considerados duplicados. Quando o sistema de origem não mostra esses erros de forma clara, a equipe só descobre o problema quando um proprietário pergunta por que o imóvel dele não aparece.

A solução passa por duas camadas. A primeira é validar o anúncio antes de enviá-lo, aplicando as regras de cada portal no próprio cadastro e avisando o responsável sobre o que falta. A segunda é ler o retorno do portal, quando ele oferece relatórios de processamento ou arquivos de retorno, e transformar cada rejeição em uma pendência visível para quem cadastrou o imóvel. Com esse ciclo fechado, o cadastro melhora com o tempo, e a gestão consegue acompanhar quantos anúncios estão efetivamente publicados em cada canal.

• Campos obrigatórios ausentes ou fora da lista aceita
• Endereço incompleto ou não localizável
• Fotos com resolução insuficiente ou link inválido
• Valores incoerentes com a finalidade
• Anúncios identificados como duplicados

Leads por webhook, e-mail e API

Do lado oposto, os portais enviam os contatos dos interessados. Historicamente, muitos leads chegavam por e-mail, o que exigia leitura automática das mensagens para extrair nome, telefone, código do imóvel e texto do contato. Hoje, quando o portal oferece essa opção, o caminho mais confiável é o webhook: o portal faz uma requisição para um endereço da empresa no momento em que o lead é gerado, com os dados estruturados. Isso permite que o contato chegue ao CRM em segundos e seja distribuído imediatamente ao corretor responsável.

Uma integração bem construída trata alguns detalhes que fazem diferença na rotina. Ela confirma o recebimento ao portal, guarda o conteúdo original da requisição para auditoria, identifica se o lead já existe no CRM para evitar duplicidade, associa o contato ao imóvel correto pelo código do anúncio e registra a origem para fins de análise de canal. Se o CRM estiver indisponível por alguns minutos, os leads precisam ficar em uma fila e ser processados assim que o sistema voltar, sem perda de nenhum contato.

Estoque único: uma fonte oficial para cada imóvel

Muitos problemas de integração nascem da existência de vários cadastros do mesmo imóvel: um no sistema da imobiliária, outro em uma planilha, um terceiro preenchido diretamente no painel de um portal. Quando o preço muda ou o imóvel é vendido, alguém precisa lembrar de atualizar todos os lugares, e o resultado são anúncios desatualizados, clientes frustrados e corretores atendendo interessados em imóveis que já não estão disponíveis. A prática que recomendamos é manter um estoque único, do qual todos os canais são alimentados automaticamente.

Para construtoras e incorporadoras que trabalham com imobiliárias parceiras, o estoque único ganha ainda mais importância. A disponibilidade das unidades, a tabela de preços vigente e as reservas precisam ser as mesmas para todos os parceiros, sob pena de duas equipes negociarem a mesma unidade. Nesses casos, a integração vai além dos portais e inclui APIs ou sincronizações com os sistemas das imobiliárias, com regras claras de conflito e registro de quem alterou cada informação. O mesmo vale para redes e franquias de imobiliárias que compartilham imóveis entre unidades e precisam evitar anúncios duplicados do mesmo endereço nos portais.

Monitoramento e manutenção contínua

Integrações com portais não são um projeto que termina na entrega. Formatos mudam, campos novos se tornam obrigatórios, regras de qualidade são revistas e endereços de envio são atualizados. Por isso, a integração deve ter monitoramento: alertas quando o feed deixa de ser lido, quando o número de rejeições aumenta de forma anormal ou quando nenhum lead chega por um canal que costuma ser ativo. Um painel simples com anúncios ativos, rejeitados e removidos por portal já ajuda a equipe a agir antes que o problema afete o resultado comercial.

Também é importante documentar o mapeamento de cada portal, manter um ambiente de testes e versionar as mudanças. Quando um portal publica uma nova versão do seu formato, a equipe técnica consegue ajustar o mapeamento, validar com alguns anúncios e só então aplicar a todos. Todas as integrações devem seguir a documentação pública ou contratual de cada portal; não há necessidade, nem é adequado, recorrer a extração automatizada de dados dos sites para contornar limitações. Respeitar esses canais oficiais preserva a relação comercial com o portal e reduz o risco de bloqueios inesperados da conta da empresa.

O que avaliar em um projeto de integração

Ao contratar ou desenvolver uma integração com portais, vale verificar se ela cobre os dois sentidos, publicação de anúncios e recebimento de leads, se valida os dados antes do envio, se apresenta as rejeições de forma compreensível para quem cadastra e se mantém histórico das alterações. Também é importante entender como a solução lida com fotos, que costumam ser o item mais pesado do processo, e como despublica automaticamente os imóveis vendidos, alugados ou com autorização de venda vencida. Outro ponto é a gestão de destaques e cotas de anúncios contratadas em cada portal, que precisa ser configurável pela equipe comercial sem depender de alterações técnicas.

Por fim, a integração com portais deve conversar com o restante da operação: o CRM, o site próprio, as campanhas de mídia e os relatórios de desempenho por canal. Quando esses elementos estão conectados, a empresa consegue responder perguntas que antes ficavam sem resposta, como quais portais geram mais visitas para cada tipo de imóvel ou quanto tempo leva, em média, entre o lead e o primeiro contato. É essa visão integrada que transforma uma obrigação técnica em fonte de informação para decisões comerciais.