Lifecycle completo
Regole e transizioni dal lead all'eventuale riattivazione.
Help Center
Tutta la documentazione operativa di Tetralink.
Dalla logica dei cicli al percorso completo lead -> vendita -> recensione -> follow-up: questa pagina raccoglie struttura, regole e funzionalita in modo ordinato e pratico.
Ultimo aggiornamento: 28 Febbraio 2026
Data model chiaro
Tabelle core, relazioni e isolamento per company_id.
Funzioni workspace
CRM, Funnel, Agenda, Report, Reputazione, Sito e Impostazioni.
Runbook operativo
FAQ e best practice per uso quotidiano del team.
Panoramica
Questa guida e pensata per dare al team una mappa unica: cosa fa ogni modulo, in quale ordine usare le funzioni e quali vincoli applica il motore lifecycle.
Per ruoli operativi
Commerciale, operations e amministrazione trovano la sequenza completa per lavorare senza salti tra strumenti.
Per ruoli tecnici/owner
Vedi struttura dati, regole API e punti di controllo che garantiscono coerenza tra CRM, agenda, recensioni e report.
Cosa sono i Cicli
Il ciclo e l'unita operativa che racconta tutto il percorso commerciale di un contatto: apertura, avanzamento, incasso, recensione e chiusura.
Un contatto ha un ciclo attivo alla volta
Il campo active_cycle_id del contatto punta al ciclo operativo corrente. Questo evita ambiguita tra eventi vecchi e nuovi.
Ogni azione viene loggata in timeline
Le azioni lifecycle scrivono eventi strutturati per tenere storico completo: ingresso lead, cambi stage, interventi, incassi, review, follow-up e chiusura ciclo.
Le regole bloccanti evitano errori operativi
Esempio: non puoi segnare lead acquisito senza almeno un intervento valido; non puoi registrare incasso superiore al residuo dell'intervento.
Il ciclo chiuso non si perde: si apre il successivo
Quando un follow-up viene chiuso come vinto, il ciclo precedente viene chiuso won e il sistema apre un nuovo ciclo di riattivazione collegato.
Stati ciclo supportati
lead_openlead_wonintervention_scheduledintervention_completedpayment_recordedreview_requestedreview_receivedclosed_wonclosed_lostreactivation_programmedreactivation_due
Logica dei Dati
Il modello e multi-tenant: ogni record operativo e isolato per company_id. I dati del ciclo vengono poi proiettati nei funnel e nei KPI.
Entita
Ruolo
Campi chiave
companies
Anagrafica tenant e configurazione workspace (timezone, review URL, flag lifecycle).
id, company_timezone, review_base_url, lifecycle_engine_v2_enabled
contacts
Anagrafica lead/clienti con riferimento al ciclo attivo.
id, company_id, stage, active_cycle_id, source
contact_funnels
Stato sintetico per funnel (lead, follow-up, review) usato da board e report.
contact_id, funnel_id, stage
contact_sales_cycles
Stato lifecycle formale del ciclo commerciale e relativi timestamp.
id, contact_id, status, opened_at, won_at, closed_at
contact_interventions
Interventi pianificati/completati, con importo e origine funnel.
id, cycle_id, service_date, status, quote_amount, origin_funnel
contact_payments
Incassi associati ad interventi e ciclo, con controllo importi residui.
id, cycle_id, intervention_id, amount, paid_at
review_requests
Richieste recensione con token, URL, reminder, stato e rating.
id, cycle_id, token, review_url, remind_on, status, rating
contact_follow_up_events
Follow-up programmati/operativi con esito finale.
id, cycle_id, event_date, reminder_sent_at, kanban_stage, outcome
contact_lifecycle_events
Audit log cronologico degli eventi lifecycle.
id, contact_id, cycle_id, event_type, payload, event_at
Regola chiave di consistenza
Le API lifecycle salvano prima l'evento reale (intervento, pagamento, review, follow-up) e poi sincronizzano la proiezione funnel. Questo tiene board, agenda e report sempre coerenti.
Percorso Lead: dall'Ingresso alla Vendita, Recensione e Follow-up
Sequenza standard raccomandata per lavorare ogni contatto in modo prevedibile e misurabile.
1) Ingresso lead
Il lead entra da sito o inserimento manuale e viene creato in contacts con company_id corretto e stage iniziale da contattare.
2) Qualifica commerciale
Il team aggiorna stage Lead (da contattare, contattato, negoziazione). Da qui parte il lavoro su funnel, note e prossima azione.
3) Acquisizione (vinto)
Per passare a acquisito il sistema richiede coerenza operativa: almeno un intervento valido o creazione contestuale con data/ora e importo.
4) Intervento e completamento servizio
L'intervento passa da scheduled/completed. Al completamento puo essere pianificata automaticamente la richiesta recensione.
5) Registrazione incasso
Gli incassi si registrano per intervento; il sistema blocca importi superiori al residuo e mantiene il saldo dovuto per ogni intervento.
6) Recensione
Viene creato un link recensione con token dedicato. La richiesta passa da queued/sent/opened/completed e alimenta la reputazione.
7) Follow-up e riattivazione
I follow-up possono essere programmati o operativi. Se un follow-up e vinto, il ciclo corrente si chiude e ne parte uno nuovo di reactivation.
Funnel e Stati Operativi
Tetralink separa i funnel per mantenere il lavoro leggibile: commerciale (Lead), ricontatto (Follow-up), reputation (Recensioni).
Lead
da contattare -> contattato -> negoziazione -> acquisito -> perso
Pipeline commerciale primaria che determina apertura/chiusura ciclo di vendita.
Follow-up
da richiamare -> chiamata fatta -> meeting fissato -> concluso
Gestione ricontatti; distingue eventi programmati da eventi operativi pronti all'azione.
Recensioni
da inviare -> richiesta inviata -> recensione ricevuta -> archiviato
Workflow reputation legato a review request, reminder e rating finale.
Next Step Recommendation
Il motore calcola fase, prossima azione e tab target (panoramica, interventi, follow-up, recensioni, storia) in base allo snapshot corrente del contatto.
Documentazione Funzioni Workspace
Panoramica modulo per modulo, con obiettivo operativo e principali azioni disponibili.
Home Workspace
Cabina operativa giornaliera con KPI, attivita in scadenza e priorita di giornata.
Attivita di oggi: interventi, follow-up, richieste review
KPI scaduti, in scadenza, completati
Riepilogo economico rapido e sito analytics sintetico
Contatti
Anagrafica unica clienti/lead con ricerca, filtri, import/export e dettaglio completo.
Ricerca per nome, email, telefono
Filtri funnel/date e selezione multipla
Import CSV, export CSV/Excel
Funnels
Gestione operativa Lead e Follow-up in vista Kanban o Lista con outcome guidati.
Lead board con stati commerciali
Follow-up programmati e operativi separati
Dialoghi guidati per esiti won/lost/no answer
Agenda Team
Planning giorno/settimana/mese e vista smart con azioni consigliate.
Eventi servizio, follow-up, recensione
Vista smart con priorita automatiche
Azioni consigliate generate dal motore lifecycle
Reputazione
Inbox recensioni con KPI, card operative, retry invio e archiviazione controllata.
Stati card: queued, sent, opened, completed, archived
KPI open/completion/rating
Dettaglio feedback e apertura contatto collegato
Report
Pannello decisionale per business, revenue, marketing, traffico, team e reputazione.
Filtri temporali, owner, funnel, source, channel
KPI trend con grafici di dettaglio
Tab executive, sales, revenue, marketing, traffic, team, reputation
Sito + CMS
Monitoraggio sito, anteprima live, analytics e gestione articoli blog.
Stato deploy e dominio
Dashboard analytics sito
CMS articoli draft/published con preview e pubblicazione
Impostazioni
Configurazione profilo, sicurezza, azienda, team e integrazioni dati.
Profilo e avatar utente
Sicurezza account (email/reset password)
Azienda (timezone, logo, soglia review, URL Google)
Altre funzioni operative incluse
Quick actions: creazione contatto, follow-up, richiesta recensione.
Registrazione incassi con controllo automatico del residuo.
Timeline contatto con storico eventi lifecycle.
Operazioni di team
Inviti membri, ruoli admin/editor e revoca inviti.
Undo su azioni distruttive (es. rimozione membro/card/contatto).
CMS con stato draft/published e anteprima articolo live.
Ruoli, Permessi e Sicurezza
Il sistema applica controllo accessi su API e isolamenti per tenant prima di ogni operazione sensibile.
Ruolo
Scope
Permessi principali
admin
Workspace azienda
Configura azienda, invita team, gestisce pipeline e dati operativi.
editor
Workspace azienda
Opera su CRM, funnel, agenda e contenuti senza accesso completo ai settaggi critici.
tetralink_admin / tetralink_support
Vista staff multi-company
Accede ai workspace clienti (impersonation) e supporta configurazione/operations.
Controllo membership
Ogni endpoint verifica che l'utente appartenga alla company del record prima di leggere o scrivere.
Sicurezza account
Gestione email, reset password e supporto provider esterni tramite auth metadata.
Integrazioni e Sync
Tetralink collega dati operativi con servizi esterni per ridurre attività manuali ripetitive.
Google Analytics
Le metriche traffico e sorgenti popolano dashboard/report quando l'account Google e connesso.
Google Calendar
Interventi, follow-up e review reminder possono sincronizzarsi nel calendario Google aziendale.
Lifecycle API actions
Azioni centralizzate per mutazioni critiche (lead, interventi, pagamenti, review, follow-up) con validazioni consistenti.
Recovery e fallback
Gli errori API espongono messaggi utente puliti, evitando dettagli SQL sensibili e facilitando troubleshooting operativo.
FAQ Operative
Risposte rapide ai dubbi piu frequenti durante uso quotidiano del workspace.
Perche alcuni contatti non avanzano al passo successivo?
Il motore lifecycle applica regole bloccanti (es. intervento mancante, importo non valido, review non inviata). La next action mostra il blocco preciso.
Cosa cambia tra follow-up programmato e operativo?
Programmato: evento creato ma non ancora attivo (reminder non inviato). Operativo: evento pronto per lavorazione e chiusura esito.
Quando posso inviare una recensione?
Dopo almeno un intervento valido sul contatto. In assenza di interventi il sistema blocca la creazione della richiesta.
Come viene protetto il dato multi-tenant?
Ogni query e filtrata su company_id e i controlli membership/ruolo vengono verificati su API prima delle operazioni sensibili.