Como uma imobiliária carrega todo o catálogo CRM no Seeki

Última revisão: 2026-04-14

Uma imobiliária pode mover todo o catálogo do CRM para o Seeki através da API de ingestão. No painel da imobiliária gera-se uma chave, envia-se um lote de imóveis num formato suportado, e cada anúncio é processado e publicado nos mercados europeus onde operamos, sem escrever código próprio. O painel mostra o progresso por item, indica o motivo de eventuais falhas e permite repetir linhas afetadas sem reenviar o lote inteiro.

Este artigo é a orientação que gostaríamos que tivesse qualquer responsável de operações de imobiliária que olha para o Seeki pela primeira vez. Percorre toda a importação, desde „temos milhares de anúncios no CRM" até „estão publicados no portal em todos os idiomas que servimos", e descreve o que esperar em cada passo.

Onboarding em 5 passos

1. Gere uma chave API. Entre no painel da imobiliária e crie uma chave na secção de chaves API. A chave fica associada à sua imobiliária.
2. Formate o payload. Mapeie a exportação do CRM para um formato suportado. Aceitamos Seeki-JSON (o nosso esquema canónico), OpenImmo (a norma europeia OASIS amplamente usada nos CRMs DACH) e Idealista XML-ML (comum em Espanha e Portugal).
3. Envie o lote. Faça POST do ficheiro para a API de ingestão. Catálogos muito grandes seguem em blocos.
4. Acompanhe o painel de importações. Cada anúncio tem a sua linha com estado em tempo real, motivo de falha e botão para repetir.
5. Os anúncios são publicados. Quando um anúncio é processado, fica ativo em todos os idiomas suportados e pesquisável a partir das páginas de país e da pesquisa com IA.

A maior parte do trabalho está no passo 2. Os passos 3 a 5 correm do lado do Seeki.

O que acontece depois de um anúncio chegar

Um anúncio não aparece no portal no momento em que o seu POST devolve 200. Cada item é validado de forma assíncrona, enriquecido com dados derivados, pontuado e publicado. A maior parte dos anúncios fica pronta em segundos. Se um anúncio tem um problema corrigível (um campo obrigatório em falta, um URL de foto que não carrega, uma morada que não conseguimos colocar no mapa), fica marcado como falhado no painel, com o motivo concreto, e o resto do lote continua.

Não precisa de saber o que corre por baixo. O que precisa de saber é que o painel diz exatamente onde está cada anúncio e que corrigir um registo errado não obriga a reenviar o feed inteiro.

Entrada manual, importação web e ingestão por API

Três formas de publicar no Seeki, pensadas para escalas muito distintas.

A decisão é normalmente pragmática: se o CRM já exporta OpenImmo ou tem um programador que produza Seeki-JSON, a via API é a mais barata. Se gere uma boutique com algumas dezenas de anúncios premium, a entrada manual chega.

O que o painel de importações mostra

No painel é onde o operacional da imobiliária passa mais tempo após o primeiro lote. Em cima fica o resumo do import (total, com sucesso, em curso, falhados) e a tabela em baixo diz exatamente o que se passa com cada registo. Filtra por falhados, lê a coluna do motivo, corrige os dados no CRM e carrega em repetir nas linhas afetadas. Não é preciso reenviar o feed inteiro por causa de uns poucos registos com erro.

Quando um anúncio é publicado, a linha liga diretamente à página pública, para verificar a apresentação no idioma de destino.

Faça a gestão das suas importações aqui assim que tiver uma chave criada.

Subscrição e acesso

A ingestão por API é uma funcionalidade paga para imobiliárias. O onboarding inclui um passo de subscrição gerido pelo Stripe: escolhe um plano, introduz os dados de pagamento ou de faturação e a chave API fica ativa. A faturação é mensal, com opção de pré-pagamento anual. Se a subscrição expirar, a ingestão é pausada. Os anúncios existentes continuam publicados, mas as novas importações são rejeitadas até a faturação ficar regularizada. O plano atual, o consumo e eventuais avisos de renovação aparecem no painel a partir do ecrã de visão geral.

Não há custo por anúncio adicional à subscrição. O throughput depende do plano. Se precisar mesmo de um throughput concorrente muito alto, fale connosco antes de contratar para dimensionarmos o plano certo.

Perguntas frequentes

Que formato de payload é suportado?

Três formatos. Seeki-JSON é o nosso esquema canónico, um esquema JSON plano e bem documentado que cobre todos os campos do anúncio e os URLs das fotos. OpenImmo (a norma europeia OASIS amplamente usada nos CRMs DACH) é aceite como XML ou como pacote zip com o XML e os ficheiros de fotos. Idealista XML-ML é aceite para imobiliárias espanholas e portuguesas cujo CRM já fala esse dialeto. A secção de chaves API do painel liga à referência completa do esquema e a um playground interativo.

Como são tratados os duplicados?

Os anúncios são identificados pelo seu ID de imobiliária mais o ID externo do anúncio, ou seja, o identificador que o seu CRM já usa. Quando reenvia um anúncio com o mesmo ID externo, o Seeki trata-o como atualização e não como anúncio novo. Assim, os refreshes rotineiros do catálogo (diários, horários ou sempre que o CRM emite uma alteração) funcionam sem lógica de desduplicação do seu lado.

Posso atualizar anúncios em massa?

Sim. O endpoint de ingestão é o mesmo para criar e atualizar. Reenviar um anúncio com campos alterados atualiza o registo publicado. Se quiser atualizar apenas um subconjunto, envie só esses anúncios. O Seeki não toca nos anúncios ausentes do lote. Para remover um anúncio, marque-o como inativo no CRM e envie-o com estado vendido ou retirado. Será arquivado da pesquisa.

E as imobiliárias fora da UE com inventário europeu?

A API não verifica onde a sua imobiliária tem sede. Verifica se o país do anúncio está entre os mercados europeus servidos pelo Seeki. Uma imobiliária sediada em Londres ou Nova Iorque com inventário espanhol ou checo usa o mesmo endpoint de ingestão. A estrutura fiscal e contratual do seu lado é responsabilidade sua. O contrato com o Seeki é pelo serviço de publicação.

Com que rapidez aparecem os novos anúncios?

Um anúncio fica pronto normalmente em segundos. O tempo total desde o seu POST até estar publicamente pesquisável depende do tamanho do lote e da carga atual, mas os lotes pequenos publicam-se normalmente abaixo de um minuto por anúncio, ponta a ponta. As traduções para outros idiomas são geradas na primeira visualização. O anúncio fica imediatamente pesquisável no idioma de origem e surge traduzido quando alguém o abre pela primeira vez noutra localização.

E se um anúncio não passar na validação?

Fica marcado como falhado no painel com o motivo concreto: campo obrigatório em falta, URL da foto inacessível, preço abaixo do limiar de plausibilidade e por aí adiante. O resto do lote continua. Corrija os dados no CRM, exporte de novo e envie o lote inteiro ou repita as linhas falhadas a partir do painel. Não há penalização por repetir e a desduplicação por ID externo evita duplicados acidentais.

Próximos passos

Se a sua imobiliária está pronta, o caminho é curto: crie uma chave, envie um lote pequeno de teste a partir da exportação do CRM, acompanhe-o no painel e depois ligue o feed completo. Mantemos de propósito a menor distância possível entre „tenho um CSV" e „os anúncios estão publicados em toda a Europa". É a plataforma que absorve a complexidade operacional em vez de a devolver para si.

Quando estiver pronto, a página de onboarding acompanha-o na criação da chave, no pagamento e na primeira importação num único fluxo.