CRM ONE — Specifiche per lo sviluppo 1.0
Documento di riferimento per lo sviluppo del CRM immobiliare: interfaccia, modello dati, acquisizione lead, esiti, schede, permessi e criteri di collaudo.
Interfaccia e priorità
- La schermata iniziale mostra le attività assegnate per oggi e gli arretrati ancora aperti, con scadenza originale. L'agenda contiene anche le attività future.
- Gli appuntamenti e le telefonate concordate conservano il loro orario. Tra le chiamate flessibili hanno precedenza i nuovi lead da campagne. Mostrare separatamente gli arretrati e la loro data originale.
- Per i lead entrati durante l'orario di lavoro, impostare un obiettivo configurabile di 15–30 minuti al primo tentativo. Fuori orario, avviare il conteggio alla riapertura. Rendere configurabili orari, festività, avvisi e soglia di escalation.
- Desktop con contatti a sinistra ed esiti a destra. Mobile con esiti subito sotto la scheda selezionata. Pulsanti touch di almeno 44 px, testo leggibile, icone con nome accessibile e stato attivo evidente.
- Sotto il contatto mostrare Chiama, icona Scheda cliente e icona Immobile se collegato. Un immobile apre la scheda, più immobili aprono l'elenco per indirizzo. Il tocco su Chiama seleziona anche la scheda associata all'esito.
Codifica colori. Usare il testo come identificatore oltre al colore.
- Vende viola · Cerca blu · entrambi se pertinenti.
- Industriale bordeaux · Commerciale verde petrolio · Residenziale arancione.
- Vecchia lista Archivio in grigio.
- Nome completo della campagna nella scheda cliente.
Consentire l'inserimento manuale con + Contatto e contatore giornaliero 0/5. Contano i contatti validi creati manualmente dal collaboratore nella giornata locale, inclusi i personali. Escludere duplicati, importazioni e cancellazioni. Il responsabile può registrare eccezioni con motivazione.
Entità e legami
Contatto
ID stabile, nome, telefono ed email normalizzati, responsabile, zona, personale o immobiliare, data e luogo di nascita facoltativi, stato di contattabilità. Anagrafica unica per persona.
Provenienza
Evento d'ingresso collegato al contatto con canale, campagna, data e ID esterno, se disponibile. Conservare la fonte originaria e le successive interazioni.
Esigenza
Contatto, ruolo VENDE o CERCA, categoria, zona, stato, priorità, prossima azione e responsabile. Una persona può vendere un immobile commerciale e cercarne uno residenziale. Mostrare gli abbinamenti corretti quando le categorie differiscono.
Immobile
Indirizzo, civico, comune, CAP, zona, piano, eventuali scala e interno, categoria, tipologia, superficie e nota. Un contatto può essere collegato a più immobili. L'indirizzo è il riferimento visibile. Usare un ID stabile e distinguere unità allo stesso civico.
Ricerca
Esigenza CERCA, zone, budget massimo, tipologia, tempistica, caratteristiche indispensabili e nota. Collegare l'immobile solo quando viene individuato.
Operazione
Immobile, contatti e ruoli, data incarico, scadenza, rinnovi, prezzo iniziale, richiesto attuale e finale, data rogito e prezzo effettivo di acquisto. Conservare lo storico di prezzi e rinnovi.
Attività
Contatto, eventuale esigenza e immobile, assegnatario, tipo, data e ora, scadenza originale, stato, esito, nota, origine e prossima azione.
Comunicazione
Destinatario, canale, finalità, modello, attività, stato, ID fornitore e tentativi. Separare bozze, accettazione del fornitore, consegna e errore.
Preferenze e audit
Finalità, canale, stato, provenienza e data della preferenza, revoca e blocco. Registrare chi modifica assegnazioni, dati, esiti e impostazioni con data e riferimento.
Acquisizione e assegnazione
- Accettare lead da campagne collegate, caricamento CSV per vecchie liste e archivio, e inserimento manuale. Per i CSV fornire anteprima con mappatura colonne, errori, duplicati e conteggi prima della conferma.
- Richiedere un nome identificativo, almeno un recapito valido e la provenienza. Derivare campagna, ruolo e categoria dalla configurazione della sorgente quando presenti. Consentire modifiche esplicite dalla scheda.
- Verificare telefono ed email normalizzati. Se identificano la stessa anagrafica, collegare la nuova richiesta o fonte. Se telefono ed email puntano a persone diverse, inviare a verifica della direzione. Usare l'ID sorgente per rendere sicura la ripetizione di webhook e importazioni.
- Assegnare i lead immobiliari per zona di competenza. Per zone mancanti o ambigue usare la coda della direzione. I contatti personali restano al collaboratore che ha sviluppato la relazione. La direzione può riassegnare con storico.
- Creare automaticamente la prima attività per i nuovi lead attivi. L'importazione di un archivio storico conserva la provenienza e la contattabilità registrata. La direzione può selezionare quali contatti mettere in lavorazione.
Esiti e automazioni
| Esito o evento | Regola |
|---|---|
| Non risponde | Primo esito: riprova in una fascia diversa nello stesso giorno, se disponibile. Secondo: prossimo giorno lavorativo, fascia diversa. Se la prima ripetizione slitta per chiusura, usare il primo slot utile e mantenere l'alternanza. Dopo tre tentativi totali, prepara il messaggio di cortesia e passa a un riesame secondo la regola configurata. |
| Da richiamare | Oggi, Domani o data scelta, con orario concordato. Una sola attività successiva per lo stesso esito. |
| Interessato | Aprire direttamente Immobile o Ricerca in base all'esigenza. Se ci sono entrambe, offrire due scelte rapide. Se l'utente rinvia la compilazione, prevedere una prossima azione di qualificazione. |
| Appuntamento | Confermare data e ora. Creare o aggiornare un unico appuntamento e gli eventuali promemoria. La riprogrammazione aggiorna calendario e messaggi collegati. |
| Non interessato | Chiudere oppure concordare un richiamo futuro. Mostrare tre e sei mesi come scorciatoie configurabili. |
| Numero inesistente | Bloccare i richiami su quel recapito, preservare gli altri canali utilizzabili e creare una verifica interna. |
| Chiede cancellazione | Bloccare subito le comunicazioni e sospendere le attività di contatto. Inoltrare la richiesta alla direzione per la gestione e registrare l'esito. |
| Visita effettuata | Creare follow-up entro 24 ore. Esiti rapidi per interesse, seconda visita, possibile proposta e rifiuto. Motivo del rifiuto selezionabile, per esempio prezzo, zona, piano o distribuzione. |
| Valutazione senza incarico | Creare una prossima azione proposta e modificabile. Per il proprietario che rimanda la vendita usare la data concordata. |
| Incarico in scadenza | Proporre avvisi 30 e 15 giorni prima, configurabili. Il rinnovo crea una nuova scadenza e aggiorna i promemoria. |
| Contatto personale e ricorrenze | Ciclo di relazione distinto e configurabile. Compleanno e anniversario rogito generano promemoria in base alle date registrate. Gli invii seguono le preferenze del destinatario. |
Schede e integrazioni
Venditore
Aprire con indirizzo, civico, comune, piano e tipologia. Suggerire il CAP tramite ricerca indirizzi e lasciarlo correggibile. Espandere superficie, prezzo, caratteristiche e nota facoltativa quando servono. Accesso rapido al servizio visure in acquisizione con i dati già disponibili. Gestire selezioni ambigue e indirizzi senza corrispondenza.
Acquirente
Zona, budget, tipologia e tempistica. Caratteristiche essenziali con selezioni multiple. Precompilare i dati già acquisiti dalla campagna. Consentire una bozza con prossima azione se mancano informazioni.
Calendario
Salvare nel CRM prima di sincronizzare. Conservare l'ID dell'evento esterno e gestire creazione, spostamento e annullamento. Usare Europe/Rome per visualizzazione e orari di lavoro, con timestamp persistiti in UTC.
WhatsApp ed email
Conferme, promemoria e cortesia dopo i tentativi seguono modelli approvati dall'agenzia e condizioni del canale. Rivalutare contattabilità, preferenze e blocchi al momento dell'invio. Per la condivisione manuale, preparare un link immobile con testo modificabile.
Affidabilità
Accodare integrazioni e notifiche dopo il salvataggio. Registrare errori, eseguire retry controllati e deduplicare invii. Notificare il collaboratore per impegni imminenti e telefonate ancora aperte senza esporre dati superflui sul dispositivo.
Permessi e controlli
Collaboratore
Attività assegnate, anagrafiche di competenza, immobili e ricerche autorizzati. Può registrare esiti e motivare richieste di modifica. Applicare i permessi anche a ricerca, API e download.
Direzione
Assegnazioni, controlli sulle attività, eccezioni e richieste di cancellazione. Ricerca per nome, cognome, indirizzo, zona, budget, categoria e tipologia, con filtri combinabili.
Report
Lead ricevuti e assegnati, tempo al primo tentativo, esiti registrati, arretrati, appuntamenti, incarichi e nuovi contatti validi per collaboratore. Distinguere chiamata dichiarata da evento verificato tramite integrazione.
Dati
Impostare accessi per ruolo, audit, backup e ripristino, configurazione dei tempi di conservazione e gestione di rettifica, blocco e cancellazione. Validare con l'agenzia testi, finalità e modalità di contatto prima dell'attivazione dei canali.
Collaudo e rilascio
Da campagna «Cerco casa» compare CERCA e RESIDENZIALE. Da campagna industriale compare VENDE e INDUSTRIALE. Una persona con due esigenze mostra entrambe sulla stessa anagrafica.
Chiama seleziona il cliente corretto. Scheda e Immobile sono affiancate. Su telefono gli esiti sono vicini al contatto. Un immobile apre direttamente, più immobili mostrano gli indirizzi.
Tre esiti Non risponde generano due richiami e un solo messaggio di cortesia. Verificare fascia serale, weekend, festività e ripetizione della stessa richiesta.
Un richiamo futuro compare in agenda. Un arretrato resta visibile con la scadenza originale. Il cambio giorno aggiorna agenda e contatore giornaliero.
L'esito Interessato apre il percorso corretto. Salvare due immobili o due ricerche senza creare una seconda persona.
Un contatto da archivio rimane riconoscibile. Reimportare lo stesso CSV senza duplicare le anagrafiche o incrementare il contatore.
Riprogrammare e annullare un appuntamento senza duplicare l'evento esterno. Verificare timeout del fornitore e consegna duplicata di callback.
Registrare un blocco prima di un invio già accodato e verificare la sospensione. Un collaboratore non può accedere tramite ricerca o URL a record di un collega fuori permesso.
Ordine di sviluppo e prossimi passi
Ordine di sviluppo. Prima dati, permessi, agenda, esiti e richiamo. Poi schede, inserimento e importazione, ricerca e report. Infine attivare calendario e messaggi con account di test, verificare idempotenza e avviare il pilota. Parametri come fasce orarie, attese, avvisi e modelli messaggio si configurano con la direzione.
Moduli successivi. Telefonia integrata, abbinamento immobili–acquirenti, AI per sintesi e suggerimenti, pipeline complete, gestione documentale, pubblicazione annunci, campagne massive e report avanzati.
Prototipo allegato. Anteprima interattiva con dati dimostrativi e salvataggio locale nel browser. Mostra agenda, chiamate, richiami, schede, etichette e riepilogo direzione. Il capitolato definisce inoltre database condiviso, permessi effettivi, importazione e integrazioni da sviluppare.