> ## Documentation Index > Fetch the complete documentation index at: https://docs.mattone.co/llms.txt > Use this file to discover all available pages before exploring further. # Setup landing agenzia — GHL step-by-step > Guida operativa: come si prepara il sub-account GHL di un nuovo cliente con lo snapshot «Mattone V2», come si mantiene quello snapshot, come si crea il form della landing, si prende l'embed code e il PIT e si collega alla piattaforma. Fase 6 dell'onboarding marketing. Questa è la procedura tecnica da seguire per ogni nuovo cliente marketing, dopo che ha completato le fasi 1-5 dell'[onboarding marketing](/delivery/marketing-onboarding). Copre il setup GHL + form + PIT + landing. **Dove stanno gli snapshot in GHL:** vista agenzia → **Account Snapshots** (nel menu a sinistra dell'Agency View). Lì trovi lo snapshot da caricare, e lì si aggiorna e si fa il push. **Lo snapshot che diamo agli studenti si chiama «Mattone V2»** ed è mantenuto da chi lavora in GHL per Mattone a partire dal sub-account **Sandbox**, dedicato solo a questo. Contiene la pipeline di acquisizione **CRM \[Nome Agenzia]** (12 stadi) e la pipeline post-firma **Proprietari \[Nome Agenzia]** (3 stadi): lo studente può sostituire "\[Nome Agenzia]" con il nome della sua attività. **«Mattone V2» non si ricrea mai da zero**: si aggiorna solo con **Refresh** dal sub-account Sandbox. Come si mantiene: più sotto, nella sezione *Come si mantiene lo snapshot «Mattone V2»*. **Il contratto vero non sono gli ID né i nomi delle pipeline: sono gli stadi.** La piattaforma Mattone riconosce la pipeline di acquisizione guardando le **parole chiave dentro il nome di ogni stadio** (l'ID dello snapshot e della location cambia a ogni sub-account creato, e non ha nessuna importanza per la piattaforma). Vedi la sezione [Il contratto reale: sono gli stadi, non i nomi](#il-contratto-reale-sono-gli-stadi-non-i-nomi) più sotto prima di rinominare qualunque cosa. ## Cosa fai, per ogni nuovo cliente Due strade, a seconda che il sub-account esista già o no. * **Sub-account da creare**: **Account Snapshots** → trova «Mattone V2» → pulsante **Create New Account (+)** → compila i dati del sub-account → **Add Sub-Account**. Serve il ruolo **Agency Admin**. * **Sub-account già esistente e vuoto**: **Sub-Accounts** → sul sub-account del cliente **Actions → Load Snapshot** → scegli «Mattone V2» → **Select All** → conferma scrivendo `confirm`. Contatti, appuntamenti e conversazioni non viaggiano con lo snapshot: nel sub-account del cliente arriva solo la configurazione. Entra nel sub-account del cliente → **Opportunities → Pipelines**. Devono esserci: * **CRM \[Nome Agenzia]**, con 12 stadi: 🔵 Nuovo Lead · 🟢 Lead Qualificato / Analisi in corso · 🟡 Call Pitch Fissata · 🟠 Sopralluogo Effettuato / Trattativa Attiva · 🟤 Follow-Up Manuale · 🔴 Invio Form Dati Contratto · 🔴 Contratto Inviato - In Attesa di Firma · ⚪️ Lead Freddo / Futuro · ⚪️ Downsell Affitti Transitori · ⚫️ Lead Non Raggiunto · ⚫️ Lead KO · ⚫️ Lead Non Qualificato / KO * **Proprietari \[Nome Agenzia]**, con 3 stadi: 🟣 Contratto Firmato - Onboarding Avviato · 🟣 Onboarding Completato · 🟣 Proprietari Attivi "\[Nome Agenzia]" è un segnaposto: **il nome della pipeline è libero**, lo studente lo può sostituire con quello della sua attività (vedi [Il contratto reale: sono gli stadi, non i nomi](#il-contratto-reale-sono-gli-stadi-non-i-nomi)). Quello che deve restare identico sono gli **stadi**, con le loro parole chiave. Se le pipeline non ci sono, rifai il **Load Snapshot** (passo 1, seconda strada). Sub-account del cliente → **Sites** → **Forms** → **+ Add Form** Nome: `Landing - Valutazione Immobile` Campi (in questo ordine): * **Nome e cognome** — required, single line * **Telefono** — required, phone field * **Email** — required, email field * **Indirizzo immobile** — required, single line * **Note aggiuntive** — optional, multi-line Checkbox privacy (obbligatoria): * Testo: *"Acconsento al trattamento dati come da privacy policy"* * Link a privacy policy del cliente (se ha) o placeholder generico Submit button: **"Richiedi la valutazione →"** **Actions on submit**: * Contact → aggiungi alla pipeline di acquisizione del cliente (quella nata da **CRM \[Nome Agenzia]**) → stadio **🔵 Nuovo Lead** * In **Automation → Workflows** controlla quale workflow parte sul nuovo lead e che il suo trigger comprenda questo form * Redirect URL: `https://nomeagenzia.vercel.app/grazie` (metterlo dopo aver deployato la landing) Nella pagina del form appena creato → tab **Integrate** → **Iframe embed** Copia il tag `` completo. È quello che va nella config della landing Vercel al passo 7. Il codice è tipo: ```html theme={null} ``` Il PIT è un token API del sub-account del cliente che serve alla piattaforma Mattone per leggere i lead. * Sub-account del cliente → **Settings** (in basso a sinistra) * **Private Integrations** * **+ Create New Integration** * Nome: `Mattone` * Scopes: seleziona almeno * `contacts.readonly` * `opportunities.readonly` * `locations.readonly` * Click **Create** * **Copia il token che appare UNA volta sola** (non si può recuperare dopo) Vedi anche [PIT + Location GHL](/integrazioni/ghl/pit-location) per il dettaglio scope. Il collegamento si fa **dall'account Mattone del cliente**, in **Connessioni → GoHighLevel**, e subito dopo si sceglie la **pipeline di acquisizione** (deve risultare in uso la pipeline nata da **CRM \[Nome Agenzia]**, o la pipeline che il cliente usa davvero). Procedura completa e verifica: [Collegamento](/integrazioni/ghl/collegamento). Vedi guida dedicata [Procedura marketing — Fase 7](/delivery/marketing-onboarding#7-landing-page-personalizzata-vercel): Sinteticamente: 1. Su GitHub: template repo `mattone-landing-template` → **Use this template** → nuovo repo `nomeagenzia` 2. Modifica `lib/config.ts` sul web GitHub: * `nomeAgenzia`, `città`, `nomeAgente` * `coloreAccent` + `coloreAccentHover` (hex del brand cliente) * Numeri stats reali (`ourImmobili`, `anniEsperienza`, `ratingMedio`) * Testimonianze reali (min 3) * **Incolla il codice iframe form GHL** del passo 4 in `ghlFormEmbedHtml` * **Incolla il codice iframe booking GHL/Calendly** in `bookingEmbedHtml` (per la thank you page — vedi §"Booking embed sulla TYP" sotto) * Contatti telefono/email 3. [https://vercel.com/new](https://vercel.com/new) → import repo → Deploy 4. Live su `nomeagenzia.vercel.app` in \~90 sec **QUESTO PASSO È OBBLIGATORIO** — senza, il cliente vede la thank you page nativa di GHL invece della nostra `/grazie` brandata (con upsell booking, prova sociale, contatti). Torna al form GHL (passo 3) → **Actions on submit** → **Redirect URL** (o **After Submit URL**) Imposta esattamente: ``` https://nomeagenzia.vercel.app/grazie ``` Sostituisci `nomeagenzia` con lo slug reale del progetto Vercel. Ricordati **`/grazie`** in fondo — è la thank you page del template. Se metti solo il dominio nudo, l'utente torna sulla stessa landing e sembra che il form non abbia fatto nulla. Salva il form GHL (GHL a volte non salva al primo click — verifica sempre che il valore rimanga dopo il salvataggio). Da ora chi invia il form sulla landing atterra sulla nostra thank you page brandata `/grazie` (hero grazie, 3 step "cosa succede ora", booking embed per prenotare subito, prova sociale, contatti veloci). * Apri `https://nomeagenzia.vercel.app` in incognito * Compila il form con dati di test (usa email tua, telefono tuo) * Submit → devi essere reindirizzato a `/grazie` * Verifica nel sub-account del cliente → pipeline di acquisizione del cliente → deve esserci un nuovo contatto in **🔵 Nuovo Lead** * Verifica nella piattaforma Mattone del cliente → il lead deve apparire nella sezione Marketing * Cancella il contatto di test da GHL ## Booking embed sulla TYP (thank you page) La landing template ha una **thank you page brandata su `/grazie`** che (oltre a ringraziare) può ospitare un **calendario booking** per far prenotare la call SUBITO al lead — senza aspettare il richiamo del team. Doppia opportunità di conversione: se il lead è caldo, si prenota da solo. ### Come funziona 1. Crei il **calendario** GHL del sub-account del cliente (o Calendly cliente): tipo "Consulenza gratuita 15 min" 2. Prende il **codice iframe embed** del calendario (in GHL: **Calendars** → apri calendario → tab **Integrate**) 3. Lo incolla nella config del template landing (`lib/config.ts` → campo `bookingEmbedHtml`) 4. Deploy Vercel → la sezione "💡 Vuoi saltare la fila?" sulla TYP mostra il calendario inline ### Se il campo è vuoto Il template mostra un **placeholder graficato** con avviso "⚠️ QUI VA MESSO IL BOOKING EMBED" + le istruzioni per chi la configura. È sicuro deployare la landing anche senza booking configurato — non rompe nulla, si vede solo il fallback fino a quando non si incolla l'iframe. ### Perché è importante Il flusso è: **ad → landing → form → TYP con booking**. Nel 20-30% dei casi il lead prenota subito la call su TYP, saltando la queue di richiamo del team. Meno friction = più conversioni. *** ## Il contratto reale: sono gli stadi, non i nomi Questa sezione conta più di tutte le altre: se non è chiara, prima o poi qualcuno rinomina la cosa sbagliata e Marketing smette di leggere i lead senza che compaia nessun errore. La piattaforma Mattone (`src/lib/ghl/pipelines.ts`, funzioni `normalizeStageName` e `classifyStage`, repo `mattone-platform`) **non guarda l'ID dello snapshot, non guarda l'ID della location, e non guarda il nome della pipeline**. Guarda solo i **nomi degli stadi** dentro ogni pipeline, li normalizza (via emoji, maiuscole e punteggiatura) e cerca una **parola chiave**. Se in una pipeline trova **almeno 3 stadi** che ricalcano la scala di acquisizione del Mattone 1, la riconosce come pipeline di acquisizione; se trova stadi post-firma ("contratto firmato", "onboarding", "proprietari attivi") la riconosce come pipeline proprietari. Verificato sullo snapshot «Mattone V2»: **12 stadi di acquisizione su 12** e **3 stadi proprietari su 3** riconosciuti. Da qui le conseguenze pratiche: * **Il nome della pipeline è libero.** «CRM \[Nome Agenzia]» e «Proprietari \[Nome Agenzia]» sono solo i nomi di partenza: lo studente li può rinominare come vuole (es. col nome della sua agenzia), e la piattaforma continua a riconoscerli. * **Prima del collegamento, gli stadi devono avere la parola chiave** (tabella qui sotto): è così che la piattaforma li riconosce la prima volta. Il resto del testo dello stadio (emoji, maiuscole, aggettivi) è libero. * **Dopo il collegamento, gli stadi si possono rinominare liberamente.** Quando lo studente collega GoHighLevel (o sceglie la pipeline di acquisizione), la piattaforma **memorizza ogni stadio per il suo ID interno**: da quel momento «Nuovo Lead» può diventare «Da chiamare» e Marketing, lista chiamate e chiusure continuano a contarlo. * **Se si aggiunge uno stadio nuovo** a una pipeline già collegata, la piattaforma lo riconosce dalla parola chiave; per memorizzarlo per ID si va in **Connessioni → GoHighLevel** e si preme **«Aggiorna mappa stadi»**. Stesso bottone se si rifà la struttura della pipeline. * **L'ID cambia a ogni sub-account creato dallo snapshot, ed è normale**: la piattaforma memorizza gli ID di quel sub-account al collegamento, non quelli dello snapshot. **Esempio di rinomina sbagliata *prima* del collegamento**: «Nuovo Lead» → «New lead» o «Da chiamare». La parola chiave "nuovo lead" sparisce, la piattaforma non riconosce lo stadio, e Marketing e la lista chiamate dello studente mostrano **0 lead, senza nessun errore a video**. Per questo si collega prima e si rinomina dopo. | Stadio | Parola chiave che deve restare | | - | - | | Nuovo Lead | "nuovo lead" | | Lead Qualificato / Analisi in corso | "qualificat" oppure "analisi" | | Call Pitch Fissata | "pitch" oppure "call fissata" | | Sopralluogo Effettuato / Trattativa Attiva | "sopralluogo" oppure "trattativa" | | Invio Form Dati Contratto | "form dati" oppure "form documenti" | | Contratto Inviato - In Attesa di Firma | "contratto inviato" oppure "attesa di firma" | | Follow-Up Manuale | "follow up manuale" | | Lead Freddo / Futuro | "freddo" oppure "futuro" | | Downsell Affitti Transitori | "downsell" oppure "transitor" | | Lead Non Raggiunto | "non raggiunto" | | Lead KO / Lead Non Qualificato / KO | "ko", "non qualificat" oppure "perso" | | Contratto Firmato - Onboarding Avviato | "contratto firmato" | | Onboarding Completato | "onboarding" | | Proprietari Attivi | "proprietari attivi" | ## Come si mantiene lo snapshot «Mattone V2» **«Mattone V2» esiste già**: lo mantiene chi lavora in GHL per Mattone a partire dal sub-account **Sandbox**, dedicato solo a questo (non ci lavora nessuno, non ha contatti veri). **Non si crea un nuovo snapshot**: si aggiorna quello esistente con **Refresh**, che rilegge le modifiche fatte nel sub-account Sandbox. Cosa dice GHL sugli snapshot, in breve: * **Uno snapshot copia gli asset così come sono.** Non si rinominano i singoli asset al momento del load: si rinominano prima, nel sub-account di origine (qui, Sandbox). * **Caricato su un sub-account che ha già degli asset**, GHL mostra i conflitti e per ciascuno si sceglie **Override** (sostituisce quello esistente) o **Skip** (tiene quello esistente). Gli asset senza conflitto vengono aggiunti. * **Refresh** rilegge le modifiche dal sub-account di origine (Sandbox) nello snapshot; **Push Update** le manda ai sub-account che hanno già caricato lo snapshot, scegliendo quali sub-account e quali asset. ### Chi la fa Chi lavora in GHL per Mattone, **se ha il permesso di agenzia giusto**. In GHL i permessi sugli snapshot sono granulari e si impostano nella vista agenzia: **Settings → Team → utente → Edit → Snapshot Scopes**. Gli scope sono *View*, *Create*, *Edit*, *Share/Import*, *Push*, *Refresh* e *Delete*. | Serve per | Permesso | | - | - | | Modificare il sub-account Sandbox e fare il Refresh dello snapshot | utente **di agenzia** con gli scope *View* e *Refresh* e, se si fa il push, *Push* | | Creare un sub-account nuovo direttamente dallo snapshot (ogni nuovo studente) | **Agency Admin**: GHL lo richiede esplicitamente | | Caricare lo snapshot su un sub-account esistente (**Load Snapshot**) | GHL rimanda ai ruoli e permessi di agenzia senza nominare lo scope: se il pulsante non compare, serve **Agency Admin** | Un utente che vede solo i sub-account (utente di sub-account) non ha **Account Snapshots** e non può fare questa procedura. ### Regola di manutenzione Quando serve cambiare qualcosa nel CRM che diamo agli studenti (uno stadio, un workflow, un campo), sempre in quest'ordine: 1. **Prima il sub-account Sandbox.** Si fa la modifica dentro Sandbox — mai direttamente sullo snapshot, mai su un sub-account di uno studente. 2. **Prima del Refresh, l'audit.** Chi lavora in GHL fa passare Sandbox dallo script di audit (vedi [Troubleshooting → Verificare un nuovo Refresh dello snapshot](/integrazioni/ghl/troubleshooting#verificare-un-nuovo-refresh-dello-snapshot-per-il-team)): si procede solo con **0 residui** dei nomi di clienti e modelli usati in passato per costruire il CRM (la lista esatta è nello script, non si scrive qui). Lo script legge solo i **nomi** degli asset via API: il **contenuto** di workflow, email/SMS e funnel page si controlla **a mano**, aprendo ognuno. 3. **Poi lo snapshot.** Account Snapshots → «Mattone V2» → **Refresh** e si scelgono gli asset cambiati. 4. **Il push ai sub-account degli studenti è una scelta a parte.** **Push Update** manda la modifica agli studenti che hanno già caricato lo snapshot, ma tocca CRM su cui lavorano ogni giorno: si fa solo su decisione esplicita del titolare. Dopo il push, apri la cronologia (**View History** nel menu a tre punti dello snapshot) e controlla, sub-account per sub-account, quali asset sono arrivati: GHL segnala che uno stato "Completed" può comparire anche se non tutti gli asset sono stati caricati. **Non si crea mai un nuovo snapshot al posto del Refresh.** Un nuovo snapshot ha un ID diverso: chi lo carica su un sub-account nuovo prende una configurazione scollegata dalla cronologia di «Mattone V2», e il Push Update dei sub-account già esistenti resta legato allo snapshot vecchio. ## Processo per un nuovo studente (in breve) Il processo completo per attivare marketing a un cliente è nei 9 passi di "[Cosa fai, per ogni nuovo cliente](#cosa-fai-per-ogni-nuovo-cliente)" più sopra. Il nucleo — dal sub-account GHL al collegamento in piattaforma — è questo: **Chi:** il team (serve **Agency Admin**). Account Snapshots → «Mattone V2» → **Create New Account (+)**. **Chi:** il team. Nel sub-account appena creato → **Settings → Private Integrations** → nuovo token con gli scope di lettura (vedi [PIT + Location GHL](/integrazioni/ghl/pit-location)). **Chi:** il team, con lo studente loggato sul suo account. **Connessioni → GoHighLevel** → incolla PIT + Location ID. In **Connessioni** la pipeline di acquisizione riconosciuta deve essere quella nata da **CRM \[Nome Agenzia]**; in **Marketing** e nella lista chiamate compaiono i lead. Pipeline libere, stadi solo mantenendo la parola chiave (vedi tabella sopra). ## Studenti già connessi con il vecchio snapshot (Cosmica CRM) Gli studenti collegati prima dell'arrivo di «Mattone V2» hanno ricevuto il vecchio snapshot con le pipeline e i workflow di Cosmica così come sono. Oggi hanno **due pipeline di acquisizione**: quella ereditata **Crm Cosmica Italia Affitti Brevi** e la propria. **Non si ricarica lo snapshot nuovo sopra**: aggiungerebbe una terza pipeline con gli stessi stadi, e GHL non documenta come risolve i conflitti fra asset con nomi diversi. Sulla piattaforma, dall'account dello studente: **Connessioni → GoHighLevel → Pipeline di acquisizione**, scelta manuale fra le pipeline che ricalcano gli stadi del Mattone 1, con il numero di opportunità di ciascuna — segna in uso quella con le opportunità vere dello studente. La scelta manuale è disponibile in piattaforma dal 15/09/2026. Se nessuno la fa, la piattaforma sceglie da sola: scarta la pipeline con "Cosmica" nel nome e preferisce quella con più opportunità. Dopo la scelta, la piattaforma memorizza anche gli stadi di quella pipeline per ID (vedi [Il contratto reale](#il-contratto-reale-sono-gli-stadi-non-i-nomi)). Nel sub-account dello studente → **Opportunities → Pipelines** → «Crm Cosmica Italia Affitti Brevi»: * **Se ha 0 opportunità**: cancellala. * **Se è quella che lo studente usa davvero**: rinominala col nome della sua attività (solo il nome della pipeline, non gli stadi). **Automation → Workflows**, cerca "Cosmica". I workflow degli ospiti delle prenotazioni dirette e il kit contratto di Cosmica, se lo studente non li usa, si tolgono (o si mettono in bozza); gli altri si rinominano. Se c'è la pipeline **Direct Booking Guests** e non ha opportunità, si toglie. * In **Marketing**, sopra i numeri, la riga *Numeri calcolati sulla pipeline di acquisizione …* nomina la pipeline dello studente * Non compare l'avviso *rinomina la pipeline* * Il numero di lead in Marketing corrisponde a quello della pipeline in GHL ## Errori comuni + fix **Form iframe non appare nella landing** → il codice embed copiato è tagliato. Verifica di aver preso il ``. Copia direttamente dalla tab Integrate di GHL, non da altre fonti. **PIT test fallisce con 401 in piattaforma** → verifica che gli scope siano stati abilitati sul PIT (`contacts.readonly` è quello minimo). Se hai creato il PIT senza scope, cancellalo e creane uno nuovo — gli scope non si possono aggiungere dopo. **Redirect form non funziona (rimane su GHL)** → l'URL nel campo "Redirect URL" deve essere completo con `https://` all'inizio. Controlla anche che sia salvato (GHL a volte non fa save al primo click). **Marketing vuoto con il CRM pieno** → quasi sempre gli stadi della pipeline sono stati rinominati e la piattaforma non la riconosce più, oppure in Connessioni è in uso un'altra pipeline. Vedi [Troubleshooting](/integrazioni/ghl/troubleshooting). ## Tempo stimato * Passo 1-2 (snapshot): 3 min * Passo 3 (form): 10 min * Passo 4 (embed): 1 min * Passo 5-6 (PIT): 3 min * Passo 7 (landing Vercel): 5 min * Passo 8-9 (redirect + test): 3 min **Totale**: \~25 min per un nuovo cliente end-to-end. ## Fonti ufficiali GoHighLevel * [Snapshots — panoramica](https://help.gohighlevel.com/support/solutions/articles/48000982511-snapshots-overview) * [Creare uno snapshot](https://help.gohighlevel.com/support/solutions/articles/48000982512-creating-new-snapshots-in-highlevel) — cosa è incluso ed escluso; si nomina lo snapshot, non i singoli asset * [Creare un sub-account da uno snapshot](https://help.gohighlevel.com/support/solutions/articles/155000005762-create-a-new-sub-account-using-snapshot) — solo Agency Admin; funnel e siti in bozza * [Caricare uno snapshot su un sub-account esistente](https://help.gohighlevel.com/support/solutions/articles/48000982582-load-snapshots-into-existing-sub-account) — conflitti, Override e Skip * [Refresh e push di uno snapshot](https://help.gohighlevel.com/support/solutions/articles/48000982583-refresh-or-update-snapshots) * [Cronologia dei push](https://help.gohighlevel.com/support/solutions/articles/155000004171-snapshot-push-update-history) * [Permessi granulari sugli snapshot](https://help.gohighlevel.com/support/solutions/articles/155000004594-granular-permissions-for-snapshots) ## Riferimenti * [Procedura marketing completa](/delivery/marketing-onboarding) — flusso 7 fasi * [Template Ads Mattone](/delivery/marketing-template-ads) — script da lanciare dopo che la landing è live * [PIT + Location GHL](/integrazioni/ghl/pit-location) — approfondimento sul token * [Collegamento](/integrazioni/ghl/collegamento) — collegare il PIT e scegliere la pipeline di acquisizione * Template landing: repo `mattone-landing-template` (URL esatto nel repo interno) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.