Como uma imobiliária importa o catálogo do CRM para a Seeki.eu

Última revisão: 2026-08-11

O seu CRM já tem lá dentro todos os imóveis que a imobiliária gere, com as fotos, os preços e as descrições. Pôr esse catálogo noutro portal costuma significar que alguém das operações o volta a escrever anúncio a anúncio, ou que um programador tenta adivinhar uma especificação de feed que ninguém documentou. Isto é o que o caminho até à Seeki.eu é na prática, desde uma exportação do CRM até anúncios que os compradores de toda a Europa conseguem encontrar.

O que é que uma imobiliária tem mesmo de fazer para começar?

Cinco passos, e só um deles dá trabalho a sério.

1. Comece pela subscrição. Uma chave API é emitida contra uma subscrição ativa: o painel não cria uma chave antes de a ter, e a API de importação recusa uma chave cuja subscrição entretanto caducou. Existe um único plano, por isso não há nada para dimensionar nem para negociar. O que está incluído fica descrito na página para imobiliárias.
2. Gere uma chave API. O painel mostra a chave completa uma única vez, no momento em que é criada, e guarda apenas um hash dela, por isso ponha-a no seu cofre de segredos antes de fechar a janela. As chaves podem ser rodadas ou revogadas mais tarde no mesmo ecrã.
3. Mapeie a exportação do CRM para um formato suportado. São aceites três: o esquema JSON da Seeki.eu, documentado campo a campo; o OpenImmo, em XML simples ou num zip que junta o XML aos ficheiros de fotos; e o Idealista XML-ML. Se o seu sistema já emite um deles, este passo é sobretudo configuração.
4. Envie o catálogo para a API de importação em ingest.seeki.eu. Os catálogos grandes seguem numa série de lotes em vez de um único ficheiro enorme.
5. Acompanhe o ecrã de importações. Cada anúncio tem a sua linha com o estado atual, o motivo caso tenha falhado, e uma repetição que não obriga a enviar o feed inteiro outra vez.

O passo 3 é onde está o esforço. Os passos 4 e 5 correm do nosso lado.

O que acontece a um anúncio depois de chegar?

Um anúncio não aparece no portal no instante em que o seu pedido termina. Cada item é tratado à parte e de forma assíncrona: é validado, a morada é resolvida para um ponto no mapa, os campos derivados são calculados, é escrito no catálogo e é pontuado. Um problema em qualquer dessas fases marca esse item como falhado com um motivo concreto e deixa o resto do lote a correr.

Na prática, as falhas concentram-se em dois sítios. O primeiro é um campo obrigatório em falta, apanhado pelo esquema antes de mais nada acontecer. O segundo é a localização: uma morada que não é possível resolver para um ponto, ou coordenadas que caem fora do país do próprio anúncio. Ambos são problemas de dados a montante, ambos se identificam pelo nome no painel, e ambos podem ser corrigidos no CRM e repetidos sem reenviar o feed.

Cada anúncio que entra recebe também uma nota de anúncio e uma pontuação de localização, os dois sinais por que os compradores podem filtrar e ordenar. O que estes dois números medem vale dez minutos do tempo de um responsável de operações, porque a nota responde diretamente à qualidade da sua exportação: quantos campos preenche, quantas fotos envia e quão substancial é a descrição mexem todos com ela.

Quanto tempo fica publicado um anúncio importado?

Sessenta dias a contar da importação bem-sucedida mais recente. Um processo diário retira da publicação tudo o que passe desse ponto, e o painel assinala os anúncios que vão expirar na semana seguinte antes de isso acontecer.

Essa regra molda a integração mais do que qualquer outra coisa nesta página. Reenviar um anúncio renova-lhe a vida mesmo que nada nele tenha mudado, por isso o padrão a construir é uma ressincronização noturna do inventário ativo e não um carregamento único em massa. Uma imobiliária que importa uma vez e nunca mais vê o catálogo esvaziar-se em silêncio ao fim de dois meses.

Isso dá-lhe também uma segunda forma, mais suave, de retirar um imóvel: deixe de o incluir na ressincronização e ele caduca sozinho.

Entrada manual ou importação por API: o que serve a sua imobiliária?

Dois caminhos reais para a plataforma, pensados para escalas muito distintas.

Abordagem	Esforço de configuração	Indicado para	Escala até
Entrada manual no painel	Nenhum. Entre e comece a escrever.	Alguns imóveis premium, ou uma imobiliária a experimentar a plataforma antes de ligar seja o que for	Dezenas
Importação por feed ou API	Uma manhã de integração, menos se o CRM já emitir OpenImmo ou Idealista XML	Uma imobiliária com CRM, com alterações frequentes de preço e de estado, ou com inventário em mais do que um país	Milhares, enviados em lotes

A escolha é normalmente pragmática. Se o seu sistema já exporta OpenImmo, ou se tem um programador capaz de produzir o nosso JSON, a API é o sítio mais barato onde aterrar e o único que aguenta uma atualização noturna. Uma boutique com uma dúzia de imóveis premium fica melhor servida a introduzi-los à mão e a gastar a manhã poupada na fotografia, que mexe mais no interesse dos compradores do que a parte técnica.

O que mostra realmente o painel de importações?

O ecrã de visão geral tem os números com que um operacional faz o dia: anúncios publicados, importações ainda a decorrer, importações falhadas e anúncios a expirar dentro da semana. Por baixo, o ecrã de importações lista cada item com o ID externo que o seu CRM usa, o seu estado, um código de erro e uma mensagem em linguagem corrente quando algo correu mal, com filtro para trazer só as falhas.

Abra uma linha e tem o payload que recebemos ao lado do erro, o que normalmente chega para separar um problema de dados no CRM de um problema de mapeamento na exportação. As linhas falhadas têm uma repetição que volta a pôr esse item na fila. Não é preciso recarregar um feed inteiro por causa de uns poucos registos com erro.

Porquê pôr um catálogo nacional num portal pan-europeu?

Porque o seu comprador pode não viver no seu país nem procurar na sua língua. Um catálogo que só existe num portal nacional chega às pessoas que já procuram lá, nessa língua, e para aí. A Seeki.eu é um portal para todo o continente: o título e a descrição de um anúncio leem-se na língua em que o visitante está a navegar, o preço aparece na moeda que ele escolher, e o anúncio fica no mesmo conjunto de resultados que casas do outro lado da fronteira para quem está a comparar mercados.

O alcance vai para além do site. Os compradores que procuram através de um assistente de IA chegam ao catálogo a partir do ChatGPT e do Claude, sem conta e sem configuração do seu lado. Se está a ponderar onde deve estar o inventário de uma imobiliária, o nosso panorama dos principais sites imobiliários da Europa explica para que serve realmente cada tipo de portal.

O que cobre a subscrição?

Um só plano: €99 por mês, ou €990 por ano, o que sai dois meses mais barato. Anúncios sem limite, cancela quando quiser. Não há custo por anúncio em cima disso, não há pacote de créditos para comprar, e não há escalão de capacidade para negociar antes de começar.

Há uma consequência que vale a pena conhecer antes de assinar e não depois. Se uma subscrição for cancelada ou pausada, os anúncios publicados dessa imobiliária saem com ela, e reativá-la volta a colocá-los no ar. Uma fatura que esteja apenas em atraso não faz isto: enquanto um pagamento está por regularizar, as importações continuam a funcionar e os anúncios mantêm-se publicados. O estado da faturação, o fim do período atual e as faturas ficam todos no ecrã de faturação do painel, tratados através do portal de cliente do próprio Stripe.

Perguntas frequentes

Que formatos de feed posso enviar?

Três. O esquema JSON da Seeki.eu é o nosso: uma estrutura plana e documentada que cobre os campos do anúncio e os URLs das fotos. O OpenImmo, a norma XML que a maioria dos sistemas de língua alemã exporta, é aceite em XML simples ou num zip que junta o XML aos ficheiros de fotos. O Idealista XML-ML é aceite para sistemas espanhóis e portugueses cuja exportação já o fala. A referência da API tem a lista completa de campos.

Como são tratados os duplicados?

Um anúncio é identificado pela sua imobiliária mais o ID externo que o seu CRM já usa para ele. Reenviar esse mesmo ID externo atualiza o registo existente em vez de criar um segundo, e renova ao mesmo tempo os seus 60 dias de vida. É isso que torna segura uma ressincronização noturna completa: não precisa de lógica de desduplicação sua, e reenviar um anúncio que não mudou não lhe custa nada.

Posso atualizar anúncios em massa?

Sim, e não há nada de separado para chamar. Criar e atualizar são a mesma operação: reenvie um anúncio com campos alterados e o registo publicado é atualizado. Envie apenas o subconjunto que mudou e os anúncios ausentes desse lote ficam intocados, com uma ressalva que vale a pena repetir, que é a de que um anúncio que deixe de enviar também deixa de ver renovados os seus 60 dias de vida.

Como retiro um anúncio?

De duas formas, e nenhuma delas é um estado no feed. Pause-o a partir do ecrã de anúncios no painel da imobiliária, o que o tira da pesquisa e se desfaz com a mesma facilidade, ou deixe de o incluir na ressincronização e deixe os 60 dias de vida esgotarem-se sozinhos. Se um imóvel foi vendido e quer a página fora hoje, pause-o.

Uma imobiliária de fora da UE pode importar inventário europeu?

Pode. Onde a sua imobiliária tem sede não é verificado. O que conta é que o imóvel esteja num dos mercados europeus que cobrimos e que a morada resolva para um ponto dentro do próprio país. Uma mediadora em Londres ou em Nova Iorque com inventário espanhol ou checo usa exatamente a mesma integração. A sua estrutura fiscal e contratual continua a ser responsabilidade sua, e o nosso contrato é pelo serviço de publicação.

Com que rapidez fica publicado um anúncio importado?

Cada item é apanhado por si só assim que chega, em vez de esperar por uma reconstrução noturna, por isso um anúncio fica normalmente pesquisável pouco depois de o lote ser aceite. O título e a descrição são traduzidos a pedido para compradores que naveguem noutra língua, o que significa que é encontrável na língua de origem desde o início e se lê na língua do visitante no momento em que ele o abre.

O que acontece aos meus anúncios se cancelar?

São retirados da publicação juntamente com a subscrição, e voltam se reativar. Um pagamento em atraso é tratado de outra maneira: enquanto uma fatura está por regularizar, as importações continuam a funcionar e os anúncios publicados mantêm-se no ar. Nada é apagado quando uma subscrição termina, por isso reativar restaura o catálogo em vez de o obrigar a importar tudo de novo.

Próximos passos

Se a sua imobiliária está pronta, o caminho é curto: comece a subscrição, gere uma chave, envie um lote pequeno de teste a partir de uma exportação real do CRM, acompanhe-o no painel e depois ligue o feed noturno. Mantemos de propósito a distância entre «tenho uma exportação» e «os anúncios estão publicados em toda a Europa» tão curta quanto é possível, e o trabalho da plataforma é absorver a complexidade operacional em vez de a devolver para si.

A página para imobiliárias descreve o que a subscrição inclui, e a referência da API descreve a lista de campos, os códigos de erro e a consola interativa que o seu programador vai querer aberta na primeira manhã.