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

# Procedura marketing — dall'onboarding cliente al primo lead

> Il flusso end-to-end per attivare marketing su un nuovo cliente: questionario, call di setup, setup Business Manager Meta, script ads, snapshot GHL, landing Vercel personalizzata, PIT collegato alla dashboard. 7 fasi ordinate.

Ogni volta che nell'Admin Overview un cliente attiva la card **Marketing**, parte questo flusso. Serve rendere replicabile ciò che oggi si fa a mente, così ogni onboarding marketing è identico e non dipende dalla persona.

## Le 7 fasi in ordine

<Steps>
  <Step title="1. Questionario Business Anamnesi">
    Alla richiesta di attivazione, la piattaforma genera un link questionario **unico per il cliente**. Non è pubblico: contiene un token, quindi solo il cliente giusto risponde.

    * **URL pattern**: `https://app.mattone.co/questionario-marketing?token=<token>`
    * Il token viene generato dall'Overview quando l'owner Acquisizione attiva la card "Marketing"
    * 6 sezioni (elevator pitch, risultati, target proprietari, offerta, marketing & materiali, angoli d'attacco)
    * Compilazione a cura del cliente (autonoma)
    * L'owner Acquisizione vede la risposta nella scheda cliente

    Il questionario è la base di tutto il resto: le risposte guidano gli script Ads, il posizionamento, la zona di lancio.
  </Step>

  <Step title="2. Booking call con l'owner Acquisizione">
    Quando il cliente completa il questionario, gli arriva il link per prenotare la call con l'owner Acquisizione:

    * **URL**: `https://branded.mattone.co/widget/bookings/consulenzamarketing-mattone`
    * L'owner Acquisizione ha una call di \~45 min sulla base del questionario
    * Output della call: zona/e di lancio confermate, tipologia proprietario target, tono di voce, materiali disponibili (foto/video), obiezioni prevalenti nel mercato
  </Step>

  <Step title="3. Prerequisiti — profili social pronti">
    Prima di lanciare campagne serve che il cliente abbia completato i **Mattone 1 e 2** del percorso corso: sono i moduli che gli fanno setuppare Instagram, Facebook, Google My Business e mettere online almeno l'annuncio base.

    <Note>
      L'owner Acquisizione tiene la checklist di verifica prerequisiti (foto profilo, bio, contatti, link, primo post, ecc.). Se manca qualcosa, la call di setup viene rimandata finché non è completato — non si lancia mai su profili vuoti.
    </Note>
  </Step>

  <Step title="4. Business Manager Meta">
    Il BM Meta è del **cliente**, non nostro. Il cliente lo crea (o lo ha già) e **invita Mattone come partner** con permessi editor/admin sulle campagne.

    * Se il cliente non ha il BM: guida standard di creazione + verifica business (docs Meta ufficiali)
    * Il cliente invita al BM come admin l'**account Meta del team Mattone** — l'indirizzo esatto è nel repo interno, non si scrive qui e non si scambia in chat pubbliche
    * L'owner Acquisizione verifica accesso prima di procedere

    Regola: mai chiedere al cliente le credenziali del suo Meta. Solo invito via BM. Se un cliente insiste per darcele, rifiutiamo — è un rischio sicurezza e violazione ToS Meta.
  </Step>

  <Step title="5. Grafiche + script ads">
    Le grafiche e gli script seguono i **3 template canonici Mattone** — vedi la pagina dedicata: [Template Ads Mattone](/delivery/marketing-template-ads).

    * Grafiche: l'owner Acquisizione le prepara (Canva) sulla base delle foto reali del cliente. Se il cliente non ha foto → usa immagini stock coerenti con la zona.
    * Script: l'owner Acquisizione personalizza i 3 template con nome agenzia, zona, hook. Sempre almeno 2 versioni per split test.
    * Video: opzionale ma consigliato — se il cliente si sente a suo agio davanti alla telecamera (domanda del questionario), l'owner Acquisizione gli manda brief di 30-60s da girare.
  </Step>

  <Step title="6. Setup GHL — snapshot, pipeline, form, PIT">
    In onboarding **diamo al cliente il sub-account creato dallo snapshot «Mattone V2»** (pipeline **CRM \[Nome Agenzia]**, 12 stadi, e **Proprietari \[Nome Agenzia]**, 3 stadi, con i loro workflow). Gli snapshot si trovano nella vista agenzia GHL, alla voce **Account Snapshots**.

    L'owner Acquisizione per ogni cliente:

    1. Crea il sub-account del cliente dallo snapshot **«Mattone V2»**
    2. Verifica che ci sia una pipeline con i 12 stadi di acquisizione (i nomi possono già essere quelli del cliente: quello che conta è la parola chiave in ogni stadio, non il nome della pipeline — vedi [Setup landing agenzia — GHL](/integrazioni/ghl/setup-agenzia-landing#il-contratto-reale-sono-gli-stadi-non-i-nomi))
    3. Crea il **form GHL** per la landing (nome, telefono, email, indirizzo immobile, note) — nella location del cliente
    4. Prende il **codice embed** del form (iframe) → serve per la landing
    5. Crea il **PIT (Private Integration Token)** dentro il sub-account del cliente (Settings → Private Integrations)
    6. Collega PIT + Location ID in piattaforma (Connessioni → GoHighLevel) e verifica che la pipeline di acquisizione riconosciuta sia quella giusta

    Guida step-by-step tecnica su GHL: [Setup landing agenzia — GHL](/integrazioni/ghl/setup-agenzia-landing).
  </Step>

  <Step title="7. Landing page personalizzata (Vercel)">
    Ogni cliente ha la sua landing su un dominio tipo `nomeagenzia.vercel.app`, generata da un template Mattone.

    <Note>
      **Landing campagne ≠ sito vetrina.** Questa fase è la **landing delle campagne**: serve alle ads Meta e ha un solo obiettivo, far lasciare i dati al proprietario. Il **sito vetrina** è un'altra cosa: presenta lo studente (chi è, cosa fa, dove, contatti) a chi non ha un sito. Il sito lo facciamo noi con le risposte del questionario e la zona dove opera; è un modello uguale per tutti con poche personalizzazioni; si fa quando lo studente ha compilato il questionario, zona compresa. Protocollo: [Sito vetrina one page](/delivery/sito-vetrina-one-page).
    </Note>

    **Template repo**: `mattone-landing-template` (l'URL esatto è nel repo interno)

    L'owner Acquisizione per ogni nuovo cliente:

    1. Su GitHub → clicca "Use this template" sul template repo → nome nuovo repo `nomeagenzia`
    2. Modifica **solo** `lib/config.ts` (dal web GitHub, no terminale):
       * `nomeAgenzia`, `città`, `nomeAgente`
       * **`coloreAccent`** + `coloreAccentHover` (hex del brand cliente — cambiano bottoni e titoli evidenziati; il resto rimane bianco/blu)
       * Numeri stats reali (`ourImmobili`, `anniEsperienza`, `ratingMedio`, `ratingReviews`)
       * Testimonianze (min 3, max 6)
       * Case study opzionale (nome cliente, tipologia immobile, risultato)
       * **`ghlFormEmbedHtml`** ← iframe del form GHL cliente (dal passo 6 GHL)
       * **`bookingEmbedHtml`** ← iframe calendario GHL/Calendly per la TYP (dal passo 6 GHL, tab Calendars)
       * `instagramUrl` + `pdfLeadMagnetUrl` opzionali (se compilati appare sezione follow-up sulla TYP)
       * Contatti (`telefono`, `email`)
    3. Va su [https://vercel.com/new](https://vercel.com/new) → import repo appena creato → Deploy
    4. **Rendi pubblico il progetto della landing**: Project Settings → Deployment Protection → Vercel Auth OFF. Vale **solo** per i progetti landing, che devono essere raggiungibili da chiunque: su un progetto che serve la piattaforma o un tool interno la Deployment Protection non si tocca mai.
    5. Landing live su `nomeagenzia.vercel.app` in \~90 sec
    6. TYP live su `nomeagenzia.vercel.app/grazie` — questa URL va incollata nel Redirect URL del form GHL (passo 8 della guida GHL)

    ### Cosa include il template

    **Landing (`/`)** — stile brandato Mattone (bianco + accent viola del cliente, Plus Jakarta Sans):

    * Hero con headline "Stai perdendo fino al 50%..." + CTA rotondo
    * Sezione problema (5 pain point affitto tradizionale)
    * Sezione benefit (6 card "cosa ottieni con noi")
    * Sezione dark "Servizio all-inclusive" (8 checklist)
    * Testimonianze (3-6 card con rating)
    * Case study opzionale
    * Form GHL embed inline
    * FAQ accordion (4 domande)
    * Footer minimal

    **Thank You Page (`/grazie`)** — stessa palette:

    * Hero grazie + 🎉
    * "Cosa succede ora" (3 step 01/02/03: email conferma → analisi → chiamata)
    * **Booking embed** GHL/Calendly per prenotare subito (skippare la queue) — 20-30% conversion extra
    * Prova sociale (testimonianze mini + rating)
    * Social/PDF opzionali (Instagram + lead magnet)
    * Contatti veloci (dark)

    Lo stile e le sezioni restano identici per tutte le agenzie — coerenza di brand Mattone + velocità di rollout.

    Guida step-by-step completa GHL (form, embed, PIT, redirect, booking): [Setup landing agenzia — GHL](/integrazioni/ghl/setup-agenzia-landing).
  </Step>
</Steps>

## Diagramma flusso

```
Cliente attiva Marketing in Admin Overview
    │
    ▼
[FASE 1] Piattaforma genera link questionario
    │
    ▼
Cliente compila Business Anamnesi (6 sezioni)
    │
    ▼
[FASE 2] Link booking → call con l'owner Acquisizione (~45 min)
    │
    ├── Se prerequisiti Mattone 1-2 mancano → attendi + guida
    │
    ▼
[FASE 3] Prerequisiti OK
    │
    ▼
[FASE 4] Cliente invita Mattone al suo BM Meta
    │
    ▼
[FASE 5] L'owner Acquisizione prepara grafiche + script (3 template canonici)
    │
    ▼
[FASE 6] L'owner Acquisizione setup GHL (snapshot + form + PIT)
    │       └── PIT nella dashboard Mattone → cliente vede lead
    │
    ▼
[FASE 7] Landing personalizzata su nomeagenzia.vercel.app
    │
    ▼
Campagne live → lead entrano in pipeline GHL
```

## Chi fa cosa

| Cosa | Chi |
| - | - |
| Compila questionario | Cliente |
| Prenota call | Cliente |
| Verifica prerequisiti Mattone 1-2 | owner Acquisizione |
| Crea BM Meta | Cliente |
| Invito Mattone al BM | Cliente |
| Grafiche + script ads | owner Acquisizione |
| Sub-account creato dallo snapshot «Mattone V2» | owner Acquisizione |
| Form GHL creato | owner Acquisizione |
| PIT preso e collegato in dashboard | owner Acquisizione |
| Landing Vercel creata (fork template + config) | owner Acquisizione |
| Deploy Vercel | owner Acquisizione (2 click) |
| Lancio campagne Meta | owner Acquisizione |
| Gestione lead (chiamate, follow-up) | Cliente |

## Note operative

* **Un cliente per città**: se un secondo cliente della stessa zona operativa chiede l'attivazione, ci si ferma prima e si decide caso per caso.
* **Periodo di prova**: il servizio marketing parte con un periodo di prova, poi passa al pagamento ricorrente; durata e condizioni le dice il contratto. La dashboard interna deve identificare chi ha finito la prova (vedi task billing dedicata).
* **Priorità queue**: gli onboarding marketing entrano nella queue dell'owner Acquisizione. Se ha già 3+ setup in corso, si comunica al cliente attesa realistica prima di partire.

## Riferimenti

* [Template Ads Mattone](/delivery/marketing-template-ads) — i 3 template canonici (Pain Affitto, Offerta Diretta, Presenza Territorio) + hook
* [Setup landing agenzia — GHL](/integrazioni/ghl/setup-agenzia-landing) — step-by-step tecnico
* [PIT + Location GHL](/integrazioni/ghl/pit-location) — come prendere e collegare il PIT


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.