Tabella di diagnosi
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| Dati lead non si aggiornano | PIT scaduto o eliminato da GHL | Vai in GHL → Settings → Private Integrations e verifica che l’integrazione “Mattone Platform” sia ancora attiva; se è stata eliminata, rigenera il PIT seguendo la procedura completa |
| ROAS mostra 0 o N/A | Opportunity value non compilato nel CRM GHL dello studente | Chiedi allo studente di verificare che tutte le opportunità in pipeline abbiano un valore numerico compilato in GHL; senza questo campo il calcolo del ROAS non è possibile |
| Campagna non attribuita | Campaign ID mancante sul contatto GHL, il tracking UTM non è configurato correttamente | Verifica nell’account GHL dello studente che l’integrazione campagne sia attiva e che i parametri UTM siano configurati sulle landing page e negli annunci |
| Rebilling non parte | Attivazione manuale non eseguita a fine mese 2 | Attiva manualmente il rebilling nell’account agenzia GHL per il sub-account dello studente; consulta la pagina Rebilling per i dettagli |
| Scopes insufficienti (403) | PIT creato con scope errati o incompleti al momento della generazione | Elimina il PIT attuale in GHL Settings e rigenera una nuova integrazione con gli scope corretti: Contacts Read, Opportunities Read, Campaigns Read; contatta il team tecnico per aggiornare la configurazione del token nella piattaforma |
Per verificare rapidamente se il PIT di uno studente è ancora valido senza aspettare un errore in produzione, vai in GHL → Settings → Private Integrations e controlla che l’integrazione denominata “Mattone Platform” sia presente e attiva. Se lo stato mostra “Active”, il token è operativo. Se la voce è assente, il token è stato eliminato e va rigenerato prima del prossimo ciclo di aggiornamento dati.
▷ Prompt Claude Code: Debug GHL · incolla in Claude Code:
Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri i repo giusti, `~/Projects/mattone-platform` (KPI marketing/
lead) e `~/Projects/ghl-mcp` (client GHL), e LEGGI le pagine mattone-docs
/troubleshooting/metodo e /integrazioni/ghl/troubleshooting; per i dati veri usa
l'MCP GHL. Poi procedi:
Applica il metodo di mattone-docs /troubleshooting/metodo a questo problema GHL:
[DESCRIVI IL SINTOMO, es. "KPI marketing vuoti" / "valore lead a zero"]. Leggi
i dati reali prima di concludere: verifica che il PIT della location sia valido
(header Authorization Bearer + Version 2021-07-28) e che le opportunità abbiano
un valore. Isola: PIT mancante/scaduto? spesa non inserita dal CSM? valore
opportunità assente in GHL? Proponi il fix (rigenera PIT / inserisci spesa /
valorizza le opportunità) e dimmi come verificarlo.
PIT & location
Rigenera il token
Lead & valore
Cosa legge la piattaforma