Assessment Funnel · Documento di Bordo · Fase 1 di 7

Setup GHL — Field, Tag, Pipeline, Token

Prepari dentro GHL tutto ciò che il relay (Fase 3) e le Automation (Fase 4) useranno dopo. Non serve aspettare nessuno per iniziare questa fase.

Ruolo: IT Tempo stimato: 2-3 ore Dipende da: niente, parte subito
0 1 2 3 4 5 6 Knowledge Base
Prima di iniziare: apri il sub-account GHL corretto (quello dove vivrà questo funnel — confermalo con chi gestisce gli accessi in agenzia se non sei sicuro, in questo funnel pilota: Joe/Nicolò — non lavorare sul sub-account sbagliato). Tieni a portata questa pagina, andrai avanti e indietro tra GHL e questa checklist.
5 / 5 step
01
Crea i 23 Custom Field sul Contatto

Vai su Impostazioni → Custom Fields → Contact. Crea questi 23 campi, esattamente con questi nomi (li useremo identici nel codice, non rinominarli):

  • dm_assessment_version — Text
  • dm_assessment_completed_at — Date/DateTime
  • dm_assessment_score_overall — Number
  • dm_score_positioning — Number
  • dm_score_funnel — Number
  • dm_score_advertising — Number
  • dm_score_tracking — Number
  • dm_score_optimization — Number
  • dm_score_operations — Number
  • dm_profile_code — Dropdown o Text (valori: P1_FOUNDATIONS, P2_ACQUISITION, P3_FOUNDER, P4_SCALE)
  • dm_profile_name — Text
  • dm_profile_risk — Number
  • dm_profile_secondary_code — Text
  • dm_profile_secondary_risk — Number
  • dm_risk_foundations — Number
  • dm_risk_acquisition — Number
  • dm_risk_founder — Number
  • dm_risk_scale — Number
  • dm_lowest_pillar — Text o Dropdown
  • dm_positive_answers — Number
  • dm_apply_status — Dropdown (valori: not_started, clicked, submitted, thank_you_viewed)
  • dm_apply_submitted_at — Date/DateTime
  • dm_apply_source — Text
Attenzione: mentre crei ognuno, GHL ti mostra un ID interno (tipo 1c0f — formato illustrativo, non un valore reale osservato) — annotalo in un file a parte (foglio Excel/Sheet), ti servirà identico in Fase 3 per il relay. Non si indovina dopo: recuperalo ora mentre lo crei, o in un secondo momento dal pannello del campo in GHL o via API (endpoint e versione esatti da verificare sulla documentazione ufficiale GHL al momento del build, non è detto restino gli stessi).
02
Crea i 9 Tag

Vai su Impostazioni → Tags (i percorsi di menu sono quelli disponibili al momento della stesura — verifica nell'interfaccia se non trovi la voce). Crea questi 9, testo libero, esattamente così incluso il carattere | — nomi verificati su architecture.html/GHL_IMPLEMENTATION.md nel repo del template (non "DM | Outcome | N", nome usato prima su questo sito ma mai nel codice reale):

  • DM | Assessment | Started — creato per completezza, il relay di Fase 3 non lo invia ancora (richiederebbe identificare il lead prima del Contatto, che oggi è l'ultimo step del quiz)
  • DM | Assessment | Completed
  • DM | Profile | P1 Foundations
  • DM | Profile | P2 Acquisition
  • DM | Profile | P3 Founder
  • DM | Profile | P4 Scale
  • DM | Apply | Clicked
  • DM | Apply | Submitted
  • DM | Apply | TY Viewed

I 4 tag Profile corrispondono ai 4 profili (P1_FOUNDATIONS, P2_ACQUISITION, P3_FOUNDER, P4_SCALE) — stessa corrispondenza codice↔tag ovunque nel sito, non invertirla.

03
Crea la Pipeline con gli 11 stadi

Vai su Opportunities → Pipelines → New Pipeline. Chiamala ad esempio "Assessment Funnel". Crea questi stadi, in quest'ordine esatto:

  1. Outcome 1
  2. Outcome 2
  3. Outcome 3
  4. Outcome 4
  5. Apply
  6. Lead Contattato
  7. Appuntamento Fissato
  8. Call Effettuata
  9. Proposta
  10. Vinta
  11. Persa
Prima di crearla: chiedi se Doc Marketing ha già una Sales Pipeline attiva in GHL — se sì, valuta con chi la gestisce se integrare questi 11 stadi lì invece di duplicare una pipeline nuova.
04
Crea il Private Integration Token

Vai su Impostazioni → Private Integrations → Create New Integration. Dai un nome tipo "Assessment Funnel Relay". Scope minimi da selezionare: lettura/scrittura contatti, scrittura opportunity (la lista esatta delle checkbox va confermata nell'interfaccia al momento — GHL la aggiorna nel tempo, seleziona tutto ciò che riguarda Contacts e Opportunities in scrittura).

Copia il token generato una sola volta (GHL di solito lo mostra solo alla creazione) e salvalo in un posto sicuro (password manager, non in chiaro in un file condiviso).

05
Recupera il Location ID

È visibile nell'URL quando sei dentro il sub-account (es. .../location/XXXXXXXXXXXXXXXXXXXX/...) oppure in Impostazioni → Business Info. Salvalo insieme al token.

Checklist di chiusura Fase 1

Fonte dati: GHL-Automations-Pipeline.md e GHL-API-Integration.md.

← Tutte le fasi Fase 2 · Copy e Placeholder →