🏠 Configurazione CSV Package Immobiliare

Guida completa per integrare il tuo listino immobiliare con AI4CALL tramite file CSV per ricerche e prenotazioni automatiche

AI4CALL - MCP CSV Package Immobiliare Configurazione

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"

⚠️ 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.).

⚠️ IMPORTANTE - Sistema Standalone
Il CSV Package Immobiliare è un plugin LOCALE che lavora sul file CSV che carichi.

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.

1

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.

📋 colonne OBBLIGATORIE nel CSV:
  • Comune: città dell'immobile (es. "Milano", "Roma")
  • Zona: zona geografica specifica (es. "Centro", "Porta Romana")
  • Tipo_Immobile o Tipologia: tipo immobile (es. "bilocale", "trilocale", "monolocale")
  • Prezzo: prezzo in euro (es. 250000, 450000)
📝 colonne CONSIGLIATE (opzionali ma utili):
  • Indirizzo, CAP: dati ubicazione completi
  • Locali, Superficie, Bagni: caratteristiche immobile
  • Piano, Totale_piani, Balconi: dettagli struttura
  • Camere_da_letto, Classe_energetica, Box, Ascensore
  • Anno_di_costruzione, Tipo_di_vendita, Data_di_consegna, Spese_condominiali
⚠️ Formato intestazioni
Le intestazioni devono corrispondere ESATTAMENTE ai nomi indicati!

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.
2

Carica il file CSV nel sistema

Una volta preparato il CSV con il formato corretto, caricalo nel pannello di configurazione AI4CALL.

🎯 procedura di caricamento:
  1. Seleziona "Configurazione CSV Package" dall'elenco dei tupi Plugin
  2. Clicca sul pulsante "CARICA CSV"
  3. Seleziona il file dal tuo computer (formato .csv)
  4. Il sistema caricherà il file e mostrerà lo stato "Attivo"
  5. Vedrai il nome del file caricato (es. "csv-agenzia.csv") e la data di upload
ℹ️ Verifica formato CSV richiesto
Nella sezione di configurazione vedrai un box giallo con il warning "⚠️ Formato CSV Richiesto" che elenca tutte le colonne che il sistema si aspetta di trovare:

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_condominiali

Verifica che il tuo CSV abbia almeno le colonne obbligatorie prima di caricarlo.
⚠️ Sostituzione file esistente
Quando carichi un nuovo CSV, il file precedente viene completamente sostituito.

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.
File caricato correttamente
Quando il caricamento è riuscito, vedrai:
  • Nome file: csv-agenzia.csv
  • Stato: Attivo
  • Icona cestino per eliminare il file se necessario

L'assistente può ora cercare negli annunci caricati!
Caricamento CSV
Pannello configurazione: formato CSV richiesto, metodo prenotazioni e upload file
3

Configura il metodo di prenotazione

Scegli come l'assistente deve gestire le prenotazioni delle visite agli immobili.

📅 metodi disponibili:
1. SMTP Email - Invia email
  • 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)
💡 Configurazione consigliata
Per la maggior parte delle agenzie, il metodo migliore è:

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.
⚠️ Prerequisiti integrazione Google Calendar
Per usare i metodi Google Calendar, devi prima:
  1. Configurare l'integrazione Google Calendar in AI4CALL
  2. Autorizzare l'accesso al tuo calendario Google
  3. Selezionare quale calendario usare per le prenotazioni

Se l'integrazione non è configurata, usa il metodo SMTP Email.
4

Configura i dati della tua agenzia

Personalizza l'assistente con le informazioni della tua agenzia immobiliare per gestire correttamente orari e disponibilità.

🏢 campi da configurare:
  • 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)
🤖 Come l'assistente usa questi dati
Quando un cliente richiede una visita, l'assistente:
  1. Verifica che il giorno richiesto NON sia tra i "Giorni Chiusura"
  2. Controlla che l'orario richiesto rientri negli "Orari Apertura"
  3. Se la richiesta è fuori orario, propone automaticamente alternative valide
  4. 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?"
⚠️ Formato orari apertura
Usa il formato HH:MM-HH:MM con "e" per separare le fasce:

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)
5

Istruisci l'assistente per i workflow

Configura il prompt dell'assistente per utilizzare correttamente i tool CSV Package nei flussi di conversazione comuni.

📝 Workflow consigliati da inserire nel prompt
1. Ricerca immobili:
"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'."
Test del sistema
Fai una chiamata di prova al tuo assistente e prova questo flusso:
  1. Chiedi: "Cerco un trilocale a Milano zona Porta Romana, budget max 400mila euro"
  2. L'assistente dovrebbe invocare search_csv_immobiliare e mostrarti i risultati
  3. Scegli un immobile e chiedi: "Vorrei visitare questo, siete disponibili domani alle 15?"
  4. L'assistente verifica orari e usa book_appointment per confermare

Se funziona, il sistema è configurato correttamente! 🎉


Scenario 1: ricerca e prenotazione trilocale

Conversazione:
Cliente: "Buongiorno, cerco un trilocale a Milano zona centro, budget massimo 500mila euro."

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

Conversazione:
Cliente: "Ho visto un bilocale che mi interessa, siete disponibili domenica mattina per vederlo?"

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]

🎯 RIEPILOGO RAPIDO - CSV Package Immobiliare
  1. Prepara CSV → colonne obbligatorie: Comune, Zona, Tipo_Immobile, Prezzo
  2. Carica file → pulsante "CARICA CSV" nel pannello configurazione
  3. Scegli metodo prenotazione → SMTP Email o Google Calendar (Crea se libero consigliato)
  4. Configura agenzia → nome, città, orari apertura, giorni chiusura
  5. Istruisci assistente → workflow ricerca e prenotazione nel prompt

⚡ RICORDA: il sistema è standalone - per aggiornare annunci devi ricaricare il CSV manualmente. Non c'è sincronizzazione automatica con portali immobiliari.

❓ 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.


Alcuni degli utilizzatori di ai4call