Imóveis, fotos e infraestrutura do CRM
Só elegíveis por finalidade, com texto e preço formatados
Catálogo de consumo, um imóvel por linha
Agente de IA, busca semântica e feed dos portais
O que resolve
- O agente só oferece imóvel que está à venda ou para alugar e liberado para divulgação.
- O cliente recebe preço, características e fotos legíveis, e não um campo bruto do CRM.
- Site, portais e agente mostram o mesmo imóvel com o mesmo preço.
Perguntas de negócio que responde
Faça estas perguntas ao seu agente quando o caso estiver pronto.
O que você precisa
- CRM de imóveis conectado na Nekt, com fotos e infraestrutura
- A regra de imóvel elegível por finalidade, aprovada pela gerência
- Um domínio público para as fotos, se o feed for para portais
O que você recebe
- Uma tabela de consumo com um imóvel por linha, só os elegíveis
- Texto ou JSON por imóvel pronto para o agente e para a busca semântica
- Feed XML no padrão dos portais
- Data da última carga em cada linha
Onde ativar
O cache do agente recebe a tabela de elegíveis por evento, com tenant_id, e o agente responde com texto, preço e link prontos.
Um JSON por imóvel com chaves legíveis vai para o índice vetorial, com o id estável para atualizar e remover quem saiu do catálogo.
O destino XML da Nekt publica o feed VrSync a partir da mesma tabela, com fotos públicas e destaque por imóvel.
A regra de elegibilidade é curta. O trabalho está em transformar campos aninhados, fotos e valores em texto confiável e em manter a carga sempre fresca. O detalhado traz as regras de negócio, as armadilhas e o teste de aceitação. Ou mande tudo direto para o seu agente com o MCP da Nekt.
O cadastro de imóveis do CRM tem centenas de colunas, campos aninhados de infraestrutura e fotos, valores como texto e imóveis que não podem ser divulgados. O agente que lê o cadastro bruto oferece imóvel vendido, mostra 'R$ 0' e manda link de foto interna. Lançamento, usado e locação têm regras diferentes de disponível e de preço, e cada canal precisa do imóvel num formato.
Como costuma ser feito, e a regra
Cada linha é um erro que já aconteceu na prática.
Venda de usado: marcado para exibir no site e com status Venda, Venda e Aluguel ou Em Negociação, excluindo a categoria empreendimento e terrenos inativos. Lançamento: categoria empreendimento, situação diferente de usado e marcado para o site. Locação: valor total de aluguel maior que zero e abaixo de um teto de sanidade (por exemplo, R$ 50 mil). Cada finalidade vira uma tabela ou uma coluna de finalidade.
Imóvel em negociação continua elegível para não perder o cliente, mas o agente diz que ele está em negociação e oferece parecidos. Vendido, alugado, reservado ou suspenso nunca entra. Imóvel que não existe no catálogo é uma resposta diferente de imóvel indisponível.
Valores chegam como número, como texto com vírgula ou como 'valor|BRL' (no Bitrix24). Converta, arredonde e formate como R$ 1.250.000,00. Valor zero ou nulo vira uma frase fixa, por exemplo 'Entre em contato para informações de valores.'. Lançamento mostra 'a partir de'; usado mostra o valor. Condomínio e IPTU saem em campos próprios.
Infraestrutura e características chegam como estrutura com dezenas de campos Sim, Não ou vazio. Gere uma lista só com o que é Sim ou tem valor, cada item com o rótulo em português ('Piscina', 'Churrasqueira', 'Água: poço artesiano'). Campos vazios somem do texto, em vez de virar 'Rótulo:' sem valor.
Use apenas as fotos marcadas para exibir no site, com a foto de destaque primeiro. A URL precisa ser pública: fotos do CRM novo costumam exigir um domínio base para o feed dos portais. Link de site com localhost ou de ambiente de teste fica fora.
Para o agente, um texto por imóvel com 'Rótulo: valor' separados por vírgula, começando pelo código. Para a busca semântica, um JSON por imóvel com chaves legíveis e o mesmo conteúdo como metadado, com o id do imóvel estável para atualizar e apagar. Para os portais, uma linha por imóvel já no padrão VrSync. Os três saem da mesma tabela de elegíveis.
Mapeie o tipo do imóvel do CRM para o PropertyType do VrSync por dicionário (apartamento, casa, sobrado, cobertura, terreno, sala comercial). Título com até 100 caracteres, descrição sem HTML e sem o fechamento de CDATA, com até 3000 caracteres. Transação vazia vira venda. Dormitórios vazios usam quartos mais suítes. Ano de construção fora de 1800 a 2100 vira nulo. O destaque do anúncio vem do campo de portais do imóvel.
A tabela do agente nunca leva nome, telefone ou documento do proprietário, captador, comissão nem observações internas. Ela traz só o que pode ser dito ao cliente final. Ampliar o que o agente pode dizer é decisão da gerência, registrada.
Quando o mesmo agente atende mais de uma imobiliária ou marca, cada linha leva o tenant_id e o agente filtra sempre por ele. Cache de imóveis e cache de contatos ficam em tabelas separadas.
A tabela roda por evento logo depois da sincronização do CRM e cada linha guarda a data da carga. Se a carga atrasou além do limite combinado, o agente não confirma disponibilidade: diz que vai verificar com um corretor.
Quem entra no catálogo
Regras reais de elegibilidade, por finalidade, a partir do cadastro do CRM.
Definições
Armadilhas que já aconteceram
O agente lia o cadastro inteiro e oferecia imóveis que não estavam liberados para divulgação ou já tinham sido vendidos.
Agente lê só a tabela de elegíveis.
Uma transformação do catálogo ficou com o filtro de um único código de imóvel usado no teste e publicou um catálogo de um imóvel.
Teste de aceite com a contagem de elegíveis contra o CRM a cada carga.
A consulta que alimentava a IA saiu com um limite de 10 linhas usado na exploração.
Revise limites e filtros antes de ligar a tabela ao agente.
O cache do agente trazia a coluna de imóvel ativo, mas não filtrava por ela, e o agente oferecia inativos quando a instrução falhava.
Filtre na tabela, não na instrução do agente.
Empreendimentos cadastrados no CRM e ainda não publicados no site ficavam fora do catálogo, enquanto o corretor já vendia.
Una os lançamentos do site com os do CRM marcados para divulgação que ainda não estão no site.
Sem teto, valores de aluguel fora da realidade, por erro de cadastro, entravam no catálogo de locação ao lado dos imóveis reais.
Teto de sanidade no valor e lista dos imóveis barrados para correção.
Teste de aceitação
O caso está pronto quando todos os itens passam.
- A quantidade de imóveis elegíveis por finalidade bate com a contagem no CRM aplicando a mesma regra (diferença zero).
- Nenhum imóvel vendido, alugado, reservado, suspenso ou fora do site aparece no catálogo.
- Nenhuma linha tem preço 'R$ 0', valor com '|BRL' ou link com localhost.
- Toda linha tem a data da última carga e ela é de menos de 24 horas.
- Nenhuma coluna da tabela do agente contém nome, telefone ou documento de proprietário.
Pacote para o agente
Cole no Claude, ChatGPT ou outro cliente com o MCP da Nekt conectado.
Catálogo de imóveis para o agente - Ofereça só imóveis da tabela de elegíveis. Se o imóvel não está nela, ele não pode ser oferecido. - Elegível: venda de usado com exibir no site = Sim e status Venda, Venda e Aluguel ou Em Negociação; lançamento com categoria empreendimento e situação diferente de usado; locação com aluguel maior que zero e abaixo do teto. - Imóvel em negociação: diga que está em negociação e ofereça parecidos. - Imóvel não encontrado é diferente de indisponível. Não encontrado: diga que não achou e ofereça parecidos. Indisponível: diga que não está mais disponível. - Preço: use o preço formatado da tabela. Se vier a frase de entre em contato, não invente valor. Lançamento é 'a partir de'. - Nunca informe dados de proprietário, captador, comissão ou observações internas. - Se a data da última carga tiver mais de <horas> horas, não confirme disponibilidade: diga que um corretor vai confirmar. - Filtre sempre pelo tenant_id da imobiliária que está atendendo. - Negociação de preço, proposta, documentos e visita agendada passam para um corretor. Exceções por cliente: - <cliente>: teto de aluguel de R$ <valor> para locação. - <cliente>: imóveis da categoria <categoria> não entram no catálogo do agente.
Construa no meu workspace Nekt o caso "Catálogo de imóveis para agente de IA" seguindo as regras em https://academy.nekt.com/industrias/imobiliario/catalogo-imoveis-agente-ia.md. 1) Encontre as tabelas de origem e confirme as colunas usadas pelas regras. 2) Crie uma transformação no grão indicado aplicando todas as regras. 3) Rode o teste de aceitação e me mostre o resultado de cada item. 4) Crie o context document do caso no workspace, com as exceções dos meus clientes em aberto para eu preencher.
Variações
Catálogo por unidade disponível do espelho de vendas, com tipologia, metragem e preço da tabela vigente, sem unidades reservadas.
Um cache separado de contatos, com o melhor telefone da base única, para o agente reconhecer quem já é cliente.
Lista diária dos imóveis marcados para o site que ficaram fora do catálogo por falta de foto, preço ou link, para o captador corrigir.