Wolksettembre 2026
Sincronizzazione annunci con Immobiliare.it: la guida per agenzie
Per sincronizzare automaticamente gli annunci su Immobiliare.it la scelta migliore è l’API REST, che aggiorna i dati quasi in tempo reale. Se il gestionale offre già il “Sincronizzatore”, attivalo e chiedi le credenziali di test a Immobiliare.it prima di lanciare qualunque annuncio in produzione. Prima del rollout, controlla anche l’abbonamento attivo e i limiti sul numero di annunci previsti dal contratto con il portale.
In breve:
- La sincronizzazione in tempo reale tramite API REST richiede una gestione accurata di test, credenziali, IP whitelist e controllo dei codici di risposta HTTP.
- Un annuncio con campi obbligatori incompleti o mal formattati, come identificativo, prezzo, geolocalizzazione o media, può risultare invisibile o incompleto sui portali.
- L’uso del lucchetto del sincronizzatore deve essere valutato attentamente: chi cura manualmente annunci di pregio dovrebbe chiuderlo, mentre chi punta all’automazione dovrebbe lasciarlo aperto.
- La riduzione del tempo tra sopralluogo e pubblicazione online è fondamentale per catturare più clienti, e l’impiego di strumenti vocali come Wolk può migliorare la qualità dei dati raccolti.
- Per un’attivazione efficace, è essenziale seguire la sequenza di richiesta supporto, test, verifica e controllo manuale sui primi annunci pubblicati.
Indice
- Confronto pratico: API REST in tempo reale o feed batch/XML?
- Quali sono i requisiti tecnici per collegarsi a Immobiliare.it?
- Quali campi sono obbligatori per pubblicare correttamente un annuncio?
- Cos’è il Sincronizzatore e come funziona il lucchetto?
- Come attivare test e rollout della sincronizzazione
- Come Wolk riduce gli errori prima della sincronizzazione
- Perché la sincronizzazione è un investimento, non un costo tecnico
- Wolk: dal sopralluogo al kit annuncio pronto per la sincronizzazione
- Documentazione e risorse tecniche da consultare
- Fonti
- Domande frequenti
Confronto pratico: API REST in tempo reale o feed batch/XML?
La documentazione ufficiale di Immobiliare.it descrive due strade per l’integrazione: l’API REST-XML e l’invio tramite feed batch. Sono due filosofie diverse, non due varianti della stessa cosa.
Con l’API REST ogni modifica al gestionale (prezzo, stato, foto) arriva al portale quasi subito. Il feed batch, invece, funziona per lotti: un file XML viene generato e caricato a intervalli fissi, spesso una o più volte al giorno.
- API REST: aggiornamenti quasi immediati, ma richiede sviluppo più curato e gestione degli errori in tempo reale.
- Feed batch/XML: più semplice da implementare, adatto a chi pubblica pochi annunci o cambia i dati raramente.
- Impatto sul cliente finale: con l’API REST un immobile venduto o un prezzo ribassato si aggiorna sul portale in pochi minuti, non a fine giornata.
Per un’agenzia con portafoglio piccolo e variazioni poco frequenti, il batch può ancora bastare. Chi gestisce molti immobili o lavora in mercati competitivi, dove un prezzo aggiornato con ritardo costa contatti persi, dovrebbe puntare direttamente sull’API REST in tempo reale.
Quali sono i requisiti tecnici per collegarsi a Immobiliare.it?
Prima di scrivere una riga di codice servono alcuni prerequisiti che il supporto tecnico di Immobiliare.it verifica sempre.
- Comunicare gli IP pubblici che effettueranno le chiamate: senza whitelisting, le richieste vengono rifiutate a prescindere dalla correttezza del payload.
- Usare l’autenticazione HTTP Basic sugli endpoint REST indicati nella guida ufficiale all’integrazione, che raccomanda proprio questa modalità per la sincronizzazione quasi in tempo reale.
- Richiedere credenziali e ambiente di test al supporto: nessuna integrazione seria va costruita direttamente in produzione.
- Leggere i codici di risposta HTTP: un 401 segnala quasi sempre credenziali o IP non validati, un 400 indica un payload malformato o un campo obbligatorio mancante, un 500 è quasi sempre temporaneo e va ritentato dopo qualche minuto.
Un errore comune è ignorare i log delle risposte e limitarsi a controllare se l’annuncio “è apparso” sul sito. Molti rifiuti sono silenziosi lato interfaccia ma esplicitati nel codice di risposta dell’API.
Quali campi sono obbligatori per pubblicare correttamente un annuncio?
Immobiliare.it rifiuta o pubblica in modo incompleto gli annunci con dati mancanti o mal formattati. I campi che causano più problemi in fase di mappatura sono sempre gli stessi.
- Identificativo univoco e data di ultima modifica: servono al portale per capire se un annuncio è nuovo o aggiornato.
- Tipologia e contratto: vendita o affitto, appartamento, villa, box, con codici che devono rispettare esattamente lo standard richiesto dal feed.
- Prezzo: formato numerico puro, senza simboli di valuta o separatori incoerenti con lo standard richiesto.
- Geolocalizzazione: indirizzo completo più coordinate, fondamentali per la mappa e per la ricerca per zona.
- Media: numero minimo di foto, formato e risoluzione adeguati; immagini sfocate o troppo piccole vengono spesso penalizzate nella visibilità dell’annuncio.
La causa più comune di annunci “fantasma” (pubblicati ma invisibili nei filtri di ricerca) è una tipologia mappata in modo errato tra gestionale e portale. Vale la pena controllare questa corrispondenza prima di qualsiasi altro campo.
Cos’è il Sincronizzatore e come funziona il lucchetto?
Il Sincronizzatore è il servizio che importa automaticamente gli annunci dal gestionale su Getrix e ImmobiliarePro, le piattaforme del gruppo Immobiliare.it dedicate agli agenti. Ogni annuncio importato mostra un’icona a forma di lucchetto, che determina chi ha la priorità sulle modifiche.
- Lucchetto aperto: il gestionale esterno continua a inviare aggiornamenti automatici, sovrascrivendo eventuali modifiche fatte manualmente su Getrix.
- Lucchetto chiuso: l’annuncio si “stacca” dal flusso automatico e può essere modificato direttamente sul portale senza rischio di sovrascrittura.
La scelta va valutata annuncio per annuncio. Chi cura manualmente la scheda di un immobile di pregio, con testi e foto ritoccati apposta per quel canale, dovrebbe chiudere il lucchetto. Chi invece vuole un flusso completamente automatizzato dal gestionale dovrebbe lasciarlo aperto.
Un consiglio: prima di chiudere un lucchetto su un annuncio, verifica che nessun collega dell’agenzia stia ancora aggiornando quel dato dal gestionale: è la causa più frequente di informazioni disallineate tra i due sistemi.
Come attivare test e rollout della sincronizzazione
La procedura segue una sequenza precisa, e saltare un passaggio è quasi sempre la causa dei problemi che emergono dopo il lancio.
- Contatta il supporto tecnico di Immobiliare.it e richiedi l’attivazione dell’integrazione.
- Comunica gli IP pubblici che useranno l’API e attendi la conferma del whitelisting.
- Ottieni un account di ambiente di test e invia un annuncio di prova completo di tutti i campi obbligatori.
- Analizza i feedback restituiti dal portale: un annuncio di prova che passa senza errori è la prova vera che la mappatura è corretta.
- Dopo il rollout, controlla manualmente foto, prezzo, indirizzo e contatti sui primi annunci pubblicati: un controllo visivo diretto individua errori che i log da soli non sempre segnalano.
Come Wolk riduce gli errori prima della sincronizzazione
Molti errori di sincronizzazione non nascono dall’API, ma da dati raccolti male durante il sopralluogo: descrizioni scritte di fretta, foto senza riferimento alla stanza, prezzi trascritti a mano ore dopo la visita.
Il workflow “cammina, parla, pubblica” di Wolk affronta il problema alla radice: mentre l’agente scatta le foto, descrive a voce ogni ambiente, e la trascrizione avviene interamente sul dispositivo, senza caricare alcun dato vocale. Il risultato è un kit annuncio già pronto per l’MLS, generato in circa 15 secondi, con testi coerenti e completi da mappare poi sui campi richiesti da Immobiliare.it.
Un testo dettato sul posto, ambiente per ambiente, riduce le incongruenze tra ciò che l’agente ha visto e ciò che finisce scritto nell’annuncio: è un problema di qualità del dato in ingresso, non di tecnologia di sincronizzazione.
Un consiglio: usa un kit annuncio generato subito dopo il sopralluogo come fonte unica per popolare i campi obbligatori del feed: elimina il passaggio, spesso fonte di errori, in cui qualcuno riscrive a memoria ore dopo la visita.
Perché la sincronizzazione è un investimento, non un costo tecnico
Il vero valore dell’integrazione non è tecnico, è temporale. Ogni ora che passa tra un sopralluogo e la pubblicazione online è un’ora in cui un concorrente può intercettare lo stesso cliente. Un’agenzia che riduce questo tempo a pochi minuti, invece che a giorni, sposta davvero l’ago della bilancia sulle vendite. Prova con un piccolo gruppo di annunci prima di generalizzare il flusso a tutto il portafoglio: i numeri reali convincono più di qualsiasi promessa.
— Marco
Wolk: dal sopralluogo al kit annuncio pronto per la sincronizzazione
Wolk non sostituisce l’integrazione con Immobiliare.it, la alimenta con dati migliori e più rapidi da inserire. Mentre fai il giro dell’immobile e scatti le foto, descrivi a voce ogni stanza: in circa 15 secondi ottieni un annuncio pronto per l’MLS, uno script per i social e un messaggio pronto da inviare al cliente, tutto elaborato sul dispositivo senza caricare la voce da nessuna parte.
È disponibile un piano gratuito che permette di provare il servizio su un numero limitato di sopralluoghi. Chi lavora da solo può passare al piano Pro, disponibile con opzioni mensili o annuali per utente su Wolk. Le agenzie con più operatori trovano il piano Growth, con prezzi disponibili su richiesta, mentre i posti aggiuntivi si aggiungono con tariffe variabili per utente nella pagina di upgrade. Chi gestisce team più ampi con pipeline e CRM condiviso può valutare direttamente il piano Brokerage su Wolk. Parti dal piano gratuito su Wolk e verifica quanto tempo risparmi già dal primo sopralluogo.
Documentazione e risorse tecniche da consultare
Per l’attivazione consulta la guida ufficiale all’integrazione e la pagina di supporto sul Sincronizzatore. Approfondisci anche mappature e lucchetti nella guida sugli errori di sincronizzazione.
Fonti
Domande frequenti
Immobiliare.it è gratuito per chi pubblica annunci?
No, la pubblicazione per agenzie e professionisti richiede un abbonamento a pagamento con Immobiliare.it; solo alcune ricerche e funzioni base per gli utenti privati sono gratuite.
Qual è la differenza tra Immobiliare.it e Idealista per la sincronizzazione?
Entrambi i portali offrono integrazioni tramite feed o API con i principali gestionali, ma le regole di mappatura, i formati richiesti e le funzionalità come il Sincronizzatore sono specifiche di ciascun portale e vanno configurate separatamente. Trovi un confronto pratico anche nella guida alla sincronizzazione con Idealista.
Come riconosco un’agenzia gestionale poco affidabile per l’integrazione?
Un gestionale da evitare è quello che non offre ambiente di test, non documenta chiaramente i codici di errore dell’API e non gestisce in modo esplicito la logica del lucchetto con Immobiliare.it.
Qual è il modo più veloce per sincronizzare gli annunci con Immobiliare.it?
L’API REST in tempo reale, descritta nella documentazione ufficiale, è la modalità più rapida. Un flusso a monte più ordinato, come il kit annuncio generato da Wolk subito dopo il sopralluogo, riduce ulteriormente il tempo tra visita e pubblicazione.
Cosa succede se il lucchetto resta aperto per errore?
Il gestionale esterno continua a sovrascrivere le modifiche fatte manualmente su Getrix o ImmobiliarePro, quindi eventuali correzioni dirette sul portale vengono perse al giro di sincronizzazione successivo.