Come un'agenzia immobiliare carica il CRM su Seeki

Ultima revisione: 2026-04-14

Un'agenzia immobiliare può portare l'intero catalogo dal proprio CRM a Seeki tramite l'API di ingest. Nella dashboard si genera una chiave, si invia un lotto di immobili in un formato supportato, e ogni annuncio viene elaborato e pubblicato nei mercati europei in cui operiamo, senza scrivere codice. La dashboard mostra l'avanzamento per ogni elemento, evidenzia il motivo di eventuali errori e consente di riprovare singole righe senza ricaricare l'intero lotto.

Questo articolo è l'orientamento che vorremmo per ogni responsabile operativo di agenzia che guarda Seeki per la prima volta. Accompagna nell'intera importazione, da „abbiamo migliaia di annunci nel CRM" a „sono pubblicati sul portale in tutte le lingue che serviamo", e descrive cosa aspettarsi a ogni passaggio.

Onboarding in 5 passi

1. Genera una chiave API. Accedi alla dashboard dell'agenzia e crea una chiave nella sezione chiavi API. La chiave è legata alla tua agenzia.
2. Formatta il payload. Mappa l'export del CRM in un formato supportato. Accettiamo Seeki-JSON (il nostro schema canonico), OpenImmo (lo standard europeo OASIS molto usato dai CRM DACH) e Idealista XML-ML (diffuso in Spagna e Portogallo).
3. Invia il lotto. Fai POST del file all'API di ingest. I cataloghi molto grandi si spediscono a blocchi.
4. Segui la dashboard delle importazioni. Ogni annuncio ha una riga propria con stato in tempo reale, motivo dell'errore e pulsante di nuovo tentativo.
5. Gli annunci vengono pubblicati. Una volta elaborato, l'annuncio è attivo in tutte le lingue supportate e ricercabile dalle pagine paese e dalla ricerca con IA.

La maggior parte del lavoro è nel passo 2. I passi da 3 a 5 girano lato Seeki.

Cosa succede dopo l'arrivo di un annuncio

Un annuncio non compare sul portale nel momento in cui il tuo POST restituisce 200. Ogni elemento viene validato in modo asincrono, arricchito con dati derivati, valutato e pubblicato. La maggior parte degli annunci si chiude in secondi. Se un annuncio ha un problema rimediabile (un campo obbligatorio mancante, un URL di una foto che non si carica, un indirizzo che non riusciamo a posizionare sulla mappa), risulta fallito in dashboard con motivo specifico e il resto del lotto prosegue.

Non ti serve sapere cosa gira sotto il cofano. Ti serve sapere che la dashboard ti dice esattamente dove si trova ogni annuncio e che correggere un record sbagliato non implica ricaricare l'intero feed.

Inserimento manuale, import web e ingest API

Tre modi per pubblicare su Seeki, pensati per scale molto diverse.

La scelta è di solito pragmatica: se il CRM esporta già OpenImmo o hai uno sviluppatore che produce Seeki-JSON, l'API è la via più economica. Se gestisci un'agenzia boutique con poche decine di annunci premium, l'inserimento manuale va benissimo.

Cosa mostra la dashboard delle importazioni

Nella dashboard l'operativo dell'agenzia passa la maggior parte del tempo dopo il primo lotto. In alto c'è il riepilogo dell'import (totale, riusciti, in corso, falliti) e la tabella sotto dice esattamente cosa succede a ogni record. Filtri sui falliti, leggi la colonna del motivo, correggi i dati nel CRM e premi riprova sulle righe interessate. Non serve ricaricare l'intero feed per pochi record sbagliati.

Quando un annuncio viene pubblicato, la riga rimanda direttamente alla pagina pubblica per verificare la resa nella lingua di destinazione.

Gestisci le tue importazioni qui appena hai una chiave attiva.

Abbonamento e accesso

L'ingest API è una funzione a pagamento per agenzie. L'onboarding include un passaggio di abbonamento gestito da Stripe: scegli un piano, inserisci i dati di pagamento o di fatturazione, e la chiave API diventa attiva. La fatturazione è mensile, con la possibilità del pagamento annuale anticipato. Se l'abbonamento decade, l'ingest viene messo in pausa. Gli annunci esistenti restano pubblicati, ma le importazioni nuove vengono rifiutate finché la fatturazione non è in regola. Il piano corrente, il consumo e gli eventuali avvisi di rinnovo si vedono in dashboard dalla schermata di riepilogo.

Sopra l'abbonamento non c'è un costo per annuncio. Il throughput dipende dal piano. Se ti serve davvero un throughput concorrente molto alto, contattaci prima della sottoscrizione per dimensionare il piano giusto.

Domande frequenti

Quale formato di payload è supportato?

Tre formati. Seeki-JSON è il nostro schema canonico, uno schema JSON piatto e ben documentato che copre tutti i campi dell'annuncio e gli URL delle foto. OpenImmo (lo standard europeo OASIS molto usato dai CRM DACH) viene accettato come XML o come pacchetto zip con XML e file foto. Idealista XML-ML è accettato per agenzie spagnole e portoghesi il cui CRM parla già quel dialetto. La sezione chiavi API della dashboard rimanda al riferimento completo dello schema e a un playground interattivo.

Come vengono gestiti i duplicati?

Gli annunci sono identificati dall'ID della tua agenzia più l'ID esterno dell'annuncio, l'identificatore che il tuo CRM già usa. Se reinvii un annuncio con lo stesso ID esterno, Seeki lo tratta come un aggiornamento, non come un nuovo annuncio. Così i refresh ordinari del catalogo (giornalieri, orari o ogni volta che il CRM emette una modifica) funzionano senza logica di deduplica da parte tua.

Posso aggiornare gli annunci in blocco?

Sì. L'endpoint di ingest è lo stesso per creazione e aggiornamento. Reinviare un annuncio con campi modificati aggiorna il record pubblicato. Se vuoi aggiornare solo un sottoinsieme, invia solo quegli annunci. Seeki non tocca quelli assenti dal lotto. Per rimuovere un annuncio, marcalo come inattivo nel CRM e invialo con stato venduto o ritirato. Verrà archiviato dalla ricerca.

E le agenzie fuori dall'UE con inventario in Europa?

L'API non controlla dove ha sede la tua agenzia. Controlla se il paese dell'annuncio rientra nei mercati europei serviti da Seeki. Un'agenzia con sede a Londra o New York che gestisce inventario spagnolo o ceco usa lo stesso endpoint di ingest. La struttura fiscale e contrattuale dal tuo lato resta una tua responsabilità. Il contratto con Seeki è per il servizio di pubblicazione.

Quanto velocemente compaiono i nuovi annunci?

Un annuncio in genere si conclude in secondi. Il tempo totale dal tuo POST alla ricercabilità pubblica dipende dalla dimensione del lotto e dal carico corrente, ma i piccoli lotti si pubblicano di norma sotto il minuto per annuncio end-to-end. Le traduzioni nelle altre lingue vengono generate alla prima visualizzazione. L'annuncio è quindi pienamente ricercabile nella lingua di origine subito e appare tradotto la prima volta che qualcuno lo apre in un'altra localizzazione.

Cosa succede se un annuncio non passa la validazione?

Viene marcato come fallito in dashboard con motivo specifico: campo obbligatorio mancante, URL foto non raggiungibile, prezzo sotto la soglia di plausibilità, e così via. Il resto del lotto prosegue. Correggi i dati nel CRM, riesporta e invia di nuovo il lotto intero oppure riprova le righe fallite dalla dashboard. Non ci sono penalità per i retry, e la deduplica sull'ID esterno previene i duplicati accidentali.

Prossimi passi

Se la tua agenzia è pronta, il percorso è breve: crea una chiave, invia un piccolo lotto di prova dall'export del CRM, seguilo in dashboard e poi attiva il feed completo. Manteniamo volutamente la distanza minima possibile tra „ho un CSV" e „gli annunci sono pubblicati in tutta Europa". La complessità operativa è compito della piattaforma, non viene rimandata indietro a te.

Quando sei pronto, la pagina di onboarding ti accompagna fra creazione della chiave, pagamento e prima importazione in un unico flusso.