🏠 Configurazione CSV Package Immobiliare
Guida completa per integrare il tuo listino immobiliare con AI4CALL tramite file CSV per ricerche e prenotazioni automatiche
Vai in "MARKET" → "Marketplace Plugin" e clicca su Acquista di "CSV Package Immobiliare" → FREE
Vai in "MARKET" → "I Miei Plugin" e clicca su Configura di "CSV Package Immobiliare"
🚀 Navigazione rapida:
⚠️ Servizi di terze parti
Le integrazioni descritte fanno riferimento a servizi di terze parti.
Rate limit, modalità di autenticazione, configurazioni tecniche, costi e policy sono definiti esclusivamente dai rispettivi provider e possono variare nel tempo.
I costi dei servizi esterni sono sostenuti direttamente dall’utente finale a favore dei fornitori dei servizi stessi e non sono in alcun modo gestiti o intermediati dal nostro portale (es. Meta o altri fornitori per WhatsApp, Zapier, Calendly, ecc.).
Non c'è sincronizzazione automatica con portali immobiliari (Immobiliare.it, Idealista, etc.) o database esterni. Per aggiornare prezzi, disponibilità o aggiungere nuovi annunci, devi caricare manualmente un nuovo file CSV aggiornato.
L'assistente può SOLO leggere i dati dal CSV e gestire prenotazioni - non può modificare immobili o prezzi.
Prepara il file CSV con gli annunci
Il primo passo è creare o esportare il file CSV contenente tutti i tuoi annunci immobiliari con le colonne nel formato corretto.
Comune: città dell'immobile (es. "Milano", "Roma")Zona: zona geografica specifica (es. "Centro", "Porta Romana")Tipo_ImmobileoTipologia: tipo immobile (es. "bilocale", "trilocale", "monolocale")Prezzo: prezzo in euro (es. 250000, 450000)
Indirizzo,CAP: dati ubicazione completiLocali,Superficie,Bagni: caratteristiche immobilePiano,Totale_piani,Balconi: dettagli strutturaCamere_da_letto,Classe_energetica,Box,AscensoreAnno_di_costruzione,Tipo_di_vendita,Data_di_consegna,Spese_condominiali
❌ SBAGLIATO: "comune" (minuscolo), "TipologiaImmobile" (senza underscore), "Costo" (nome diverso)
✅ CORRETTO: "Comune", "Tipo_Immobile", "Prezzo"
Il sistema cerca le colonne per nome esatto. Se non le trova, la ricerca potrebbe non funzionare correttamente.
Carica il file CSV nel sistema
Una volta preparato il CSV con il formato corretto, caricalo nel pannello di configurazione AI4CALL.
- Seleziona "Configurazione CSV Package" dall'elenco dei tupi Plugin
- Clicca sul pulsante "CARICA CSV"
- Seleziona il file dal tuo computer (formato .csv)
- Il sistema caricherà il file e mostrerà lo stato "Attivo"
- Vedrai il nome del file caricato (es. "csv-agenzia.csv") e la data di upload
Comune, Zona, Indirizzo, CAP, Prezzo, Locali, Superficie, Bagni, Piano, Totale_piani, Balconi, Camere_da_letto, Classe_energetica, Box, Ascensore, Anno_di_costruzione, Tipo_di_vendita, Data_di_consegna, Spese_condominialiVerifica che il tuo CSV abbia almeno le colonne obbligatorie prima di caricarlo.
Se avevi caricato "annunci-dicembre.csv" e carichi "annunci-gennaio.csv", il primo file sarà eliminato e l'assistente userà solo il nuovo. Non c'è merge automatico - assicurati che il nuovo CSV contenga TUTTI gli annunci che vuoi rendere disponibili.
- Nome file:
csv-agenzia.csv - Stato: Attivo
- Icona cestino per eliminare il file se necessario
L'assistente può ora cercare negli annunci caricati!
Configura il metodo di prenotazione
Scegli come l'assistente deve gestire le prenotazioni delle visite agli immobili.
- L'assistente invia una email di conferma al cliente con i dettagli della visita
- Invia contemporaneamente una copia all'agenzia come notifica interna
- NON verifica disponibilità su calendario - gestione manuale appuntamenti
- Quando usarlo: Se gestisci gli appuntamenti manualmente o con un CRM esterno
2. Google Calendar - Crea sempre
- Crea automaticamente un evento nel calendario Google dell'agenzia
- NON verifica se l'orario è già occupato - crea sempre l'evento
- Utile per tracciare tutte le richieste anche se in conflitto
- Quando usarlo: Se vuoi un log completo di tutte le richieste di visita
3. Google Calendar - Crea se libero
- Verifica PRIMA se l'orario richiesto è disponibile sul calendario
- Crea l'evento SOLO se non ci sono conflitti
- Se occupato, l'assistente propone orari alternativi al cliente
- Quando usarlo: Per evitare automaticamente doppie prenotazioni (CONSIGLIATO)
Google Calendar - Crea se libero
Vantaggi:
- ✅ Evita automaticamente appuntamenti doppi
- ✅ L'assistente propone orari realmente disponibili
- ✅ Il calendario Google diventa la fonte di verità per le prenotazioni
- ✅ Sincronizzabile con app mobile per notifiche in tempo reale
Se non usi Google Calendar, scegli SMTP Email e gestisci manualmente il calendario.
- Configurare l'integrazione Google Calendar in AI4CALL
- Autorizzare l'accesso al tuo calendario Google
- Selezionare quale calendario usare per le prenotazioni
Se l'integrazione non è configurata, usa il metodo SMTP Email.
Configura i dati della tua agenzia
Personalizza l'assistente con le informazioni della tua agenzia immobiliare per gestire correttamente orari e disponibilità.
- Nome Assistente:
nome con cui l'AI si presenterà al cliente
→ es. "Assistente Casa Conveniente", "Bot Immobiliare Milano" - Descrizione:
breve descrizione del servizio o specializzazione
→ es. "Assistente virtuale per ricerca immobili e prenotazione visite" - Nome Agenzia:
nome ufficiale della tua agenzia immobiliare
→ es. "Casa Conveniente Milano", "Immobiliare Porta Romana" - Città:
città principale di operazione
→ es. "Milano", "Roma" - Orari Apertura:
fasce orarie in cui l'agenzia è aperta e può gestire visite
→ es. "08:00-12:00 e 16:00-18:00" (con pausa pranzo)
→ es. "09:00-19:00" (orario continuato) - Giorni Chiusura:
giorni della settimana in cui l'agenzia è chiusa
→ es. "sabato, domenica e festivi"
→ es. "domenica" (se aperto il sabato)
- Verifica che il giorno richiesto NON sia tra i "Giorni Chiusura"
- Controlla che l'orario richiesto rientri negli "Orari Apertura"
- Se la richiesta è fuori orario, propone automaticamente alternative valide
- Include il nome dell'agenzia nella conferma della prenotazione
Esempio: Cliente chiede visita domenica ore 10:00. Se domenica è giorno di chiusura, l'assistente risponderà: "L'agenzia Casa Conveniente Milano è chiusa domenica. Posso proporti lunedì mattina dalle 09:00 alle 12:00 o pomeriggio dalle 16:00 alle 18:00. Quale preferisci?"
✅ CORRETTO:
08:00-12:00 e 16:00-18:00(mattina e pomeriggio)09:00-19:00(orario continuato)10:00-13:00 e 15:00-20:00(due fasce personalizzate)
❌ SBAGLIATO:
8-12 e 16-18(mancano i minuti e gli zeri)08:00-12:00, 16:00-18:00(usa "e" non virgola)mattina e pomeriggio(non interpretabile)
Istruisci l'assistente per i workflow
Configura il prompt dell'assistente per utilizzare correttamente i tool CSV Package nei flussi di conversazione comuni.
"Quando il cliente cerca un immobile, raccogli: città/comune, zona preferita, tipologia (monolocale/bilocale/trilocale/etc), budget massimo. Poi usa search_csv_immobiliare filtrando per questi criteri. Presenta i risultati trovati con: indirizzo, prezzo, caratteristiche principali (mq, piano, bagni)."
2. Prenotazione visite:
"Dopo aver trovato immobili interessanti, chiedi al cliente quale preferisce visitare. Proponi date e orari rispettando gli orari apertura dell'agenzia. Raccogli: nome completo, email, telefono. Poi usa book_appointment per confermare la prenotazione. Specifica sempre l'indirizzo esatto dell'immobile da visitare."
3. Gestione fuori orario:
"Se il cliente chiede visita in giorni/orari di chiusura, spiega gentilmente che l'agenzia è chiusa e proponi le prime 3 alternative disponibili negli orari di apertura. Non prenotare mai fuori dagli orari configurati."
4. Dettagli immobile:
"Se il cliente chiede dettagli specifici su un immobile (classe energetica, spese condominiali, anno costruzione), cerca nel CSV e fornisci le informazioni disponibili. Se un dato non è presente nel CSV, sii onesto e dì 'questa informazione non è disponibile nel sistema, posso farti parlare con un agente'."
- Chiedi: "Cerco un trilocale a Milano zona Porta Romana, budget max 400mila euro"
- L'assistente dovrebbe invocare
search_csv_immobiliaree mostrarti i risultati - Scegli un immobile e chiedi: "Vorrei visitare questo, siete disponibili domani alle 15?"
- L'assistente verifica orari e usa
book_appointmentper confermare
Se funziona, il sistema è configurato correttamente! 🎉
🛠️ Tool CSV Package Disponibili
2 tool interni per gestire ricerche e prenotazioni immobiliari.
search_csv_immobiliare
Parametri:
comune(opzionale): città (es. "Milano")zona(opzionale): zona geografica (es. "Centro")tipo(opzionale): tipologia immobile (es. "trilocale")prezzo_min/prezzo_max(opzionale): range prezzo in euro
Restituisce: lista immobili con tutti i dati disponibili nel CSV
book_appointment
Parametri:
property_id(obbligatorio): ID immobile dal CSVdate(obbligatorio): data e ora visita richiestauser_name(obbligatorio): nome completo clienteuser_contact(obbligatorio): email o telefono cliente
Azione: invia email conferma o crea evento Calendar secondo metodo configurato
💡 Workflow Pratici
Esempi concreti di come l'assistente gestisce le conversazioni con i clienti.
Scenario 1: ricerca e prenotazione trilocale
Assistente: [invoca
search_csv_immobiliare(comune="Milano", zona="Centro", tipo="trilocale", prezzo_max=500000)]Assistente: "Ho trovato 3 trilocali in zona Centro a Milano entro il tuo budget:
1. Via Dante 15 - 450.000€ - 85mq, piano 3/5, 2 bagni, balcone
2. Corso Garibaldi 42 - 480.000€ - 90mq, piano 2/4, 1 bagno, terrazzo
3. Via Manzoni 8 - 495.000€ - 95mq, piano 1/3, 2 bagni, box auto
Quale ti interessa approfondire?"
Cliente: "Il primo sembra interessante, posso vederlo?"
Assistente: "Certamente! L'agenzia Casa Conveniente Milano è aperta dalle 08:00 alle 12:00 e dalle 16:00 alle 18:00, dal lunedì al venerdì. Quando preferisci venire?"
Cliente: "Domani alle 17:00 va bene?"
Assistente: "Perfetto! Per confermare la visita a Via Dante 15 domani alle 17:00, ho bisogno di: nome completo, email e numero di telefono."
Cliente: "Mario Rossi, mario.rossi@email.com, 333-1234567"
Assistente: [invoca
book_appointment(property_id="apt_dante15", date="2025-01-16T17:00", user_name="Mario Rossi", user_contact="mario.rossi@email.com")]Assistente: "✅ Visita confermata! Domani 16/01/2025 ore 17:00 in Via Dante 15, Milano. Ti ho inviato una email di conferma con tutti i dettagli. A domani!"
Scenario 2: gestione richiesta fuori orario
Assistente: "Mi dispiace ma l'agenzia Casa Conveniente Milano è chiusa sabato, domenica e festivi. Posso proporti questi orari alternativi:
• Lunedì 13/01 ore 09:00, 10:00, 11:00 (mattina)
• Lunedì 13/01 ore 16:00, 17:00 (pomeriggio)
• Martedì 14/01 ore 09:00, 10:00, 11:00 (mattina)
Quale preferisci?"
Cliente: "Ok, lunedì alle 10 allora."
Assistente: "Perfetto! Per confermare la visita lunedì 13/01 alle 10:00, mi dai per favore nome completo, email e telefono?"
[Procede con book_appointment normalmente]
- Prepara CSV → colonne obbligatorie: Comune, Zona, Tipo_Immobile, Prezzo
- Carica file → pulsante "CARICA CSV" nel pannello configurazione
- Scegli metodo prenotazione → SMTP Email o Google Calendar (Crea se libero consigliato)
- Configura agenzia → nome, città, orari apertura, giorni chiusura
- Istruisci assistente → workflow ricerca e prenotazione nel prompt
❓ Domande Frequenti
Risposte alle domande più comuni sul CSV Package Immobiliare
Il CSV deve contenere almeno: Comune, Zona, Tipo_Immobile (o Tipologia), Prezzo. Colonne consigliate: Indirizzo, CAP, Locali, Superficie, Bagni, Piano, Totale_piani, Balconi, Camere_da_letto, Classe_energetica, Box, Ascensore, Anno_di_costruzione, Tipo_di_vendita, Data_di_consegna, Spese_condominiali. Le intestazioni devono corrispondere esattamente a questi nomi.
Il plugin lavora in modalità standalone basandosi sul file CSV caricato. Per aggiornare prezzi, disponibilità o aggiungere nuovi immobili, devi caricare un nuovo file CSV aggiornato tramite il pulsante "CARICA CSV". Il sistema sostituirà il file precedente con quello nuovo. Non c'è sincronizzazione automatica con portali esterni.
SMTP Email invia una email di conferma appuntamento al cliente e all'agenzia quando viene prenotata una visita. Google Calendar crea automaticamente un evento nel calendario Google dell'agenzia con i dettagli della visita. Puoi scegliere "Crea sempre" (prenota senza verificare il calendario) o "Crea se libero" (verifica prima la disponibilità).
No, se definito nel prompt. L'assistente verifica sempre gli "Orari Apertura" e i "Giorni Chiusura" configurati nella sezione "Crea/Modifica Assistente Immobiliare". Se il cliente chiede un appuntamento in orari non disponibili (es. domenica se chiusi), l'assistente proporrà automaticamente alternative negli orari validi.
L'assistente usa il tool search_csv_immobiliare che filtra il CSV caricato in base ai parametri richiesti dal cliente: Comune (es. "Milano"), Zona (es. "Centro"), Tipo (es. "trilocale", "bilocale"), range di Prezzo. Il tool confronta i valori esatti per Comune/Zona e cerca corrispondenze parziali per Tipo. Restituisce tutti gli immobili che matchano i criteri.
No. Il CSV Package Immobiliare è un sistema standalone locale. Devi esportare manualmente i dati dai portali in formato CSV e caricarli nel sistema. Non c'è integrazione API diretta con portali immobiliari esterni. Per aggiornamenti, esporta nuovamente il CSV dal portale e ricaricalo.
No. Il plugin funziona esclusivamente sul file CSV che hai caricato. Se un immobile viene venduto o il prezzo cambia, devi aggiornare manualmente il CSV ed effettuare un nuovo upload. Non c'è sincronizzazione in tempo reale con database esterni o CRM immobiliari.
Non c'è un limite tecnico rigido, ma per performance ottimali si consiglia di mantenere il CSV sotto i 10.000 annunci. File troppo grandi possono rallentare le ricerche. Se hai molti annunci, considera di caricare solo quelli attivi/disponibili e di segmentare per città se gestisci più zone geografiche.
No, il plugin CSV Package supporta UNA sola agenzia per assistente AI4CALL. Se gestisci più agenzie, devi creare assistenti AI4CALL separati, ciascuno con il proprio file CSV caricato e configurazione (nome agenzia, orari, città). Ogni assistente funzionerà in modo indipendente.
Quando il cliente prenota una visita, l'assistente invoca il tool book_appointment che utilizza la configurazione del tuo SMTP per inviare una email al cliente con: data/ora visita, indirizzo immobile, recapiti agenzia. Contemporaneamente invia una copia all'email dell'agenzia configurata nel sistema come notifica interna.
Il sistema tenterà di caricare il CSV ma potrebbe dare errori se: le colonne obbligatorie mancano, i separatori sono errati (deve usare virgola o punto e virgola), ci sono caratteri speciali non gestiti. In caso di errore, riceverai un messaggio specifico. Usa il template CSV fornito da AI4CALL per evitare problemi di formato.
No. L'assistente può SOLO leggere i dati dal CSV caricato. Non può modificare prezzi, disponibilità o caratteristiche degli immobili. Qualsiasi modifica ai dati richiede l'aggiornamento del file CSV e il suo ricaricamento nel sistema tramite l'interfaccia di configurazione.
Se usi il metodo "Google Calendar - Crea se libero", il sistema verifica la disponibilità sul calendario prima di confermare. Se usi "SMTP Email - Invia email" o "Crea sempre", NON c'è controllo automatico dei doppi appuntamenti - la gestione è manuale. Per evitare sovrapposizioni, usa l'integrazione Calendar con verifica disponibilità.
I campi di ricerca principali sono fissi: Comune, Zona, Tipo (tipologia immobile), Prezzo. Puoi però personalizzare il prompt dell'assistente per far sì che raccolga altri criteri (es. "con giardino", "ultimo piano") e poi filtri manualmente i risultati della ricerca base prima di proporli al cliente.
Nel campo "Orari Apertura" usa il formato: "HH:MM-HH:MM e HH:MM-HH:MM". Esempio per mattina e pomeriggio: "08:00-12:00 e 16:00-18:00". L'assistente interpreterà automaticamente le due fasce orarie separate e proporrà appuntamenti solo in questi range. Per orario continuato usa una sola fascia: "09:00-18:00".
Sì, il campo Tipo_Immobile (o Tipologia) nel CSV non ha limitazioni. Puoi inserire "negozio", "ufficio", "capannone", "terreno" oltre a "monolocale", "bilocale", etc. L'assistente cercherà esattamente ciò che il cliente richiede. Assicurati di usare nomi consistenti nel CSV per la stessa tipologia.
Sì. Il sistema non distingue tra vendita e affitto - lavora solo sui dati CSV. Puoi caricare un CSV con immobili in affitto specificando il "Prezzo" come canone mensile e usando la colonna Tipo_di_vendita con valore "affitto". L'assistente gestirà le ricerche e prenotazioni allo stesso modo.
No, il file CSV contiene solo dati testuali (testo, numeri). Per le immagini, puoi includere una colonna con URL/link alle foto ospitate online. L'assistente può fornire questi link al cliente durante la conversazione, ma non può mostrare direttamente le immagini durante la chiamata telefonica.