Connetti il tuo CRM (OAuth)

La connessione al CRM è ciò che trasforma GodSetter da dialer a macchina per fissare appuntamenti: il CRM (GoHighLevel) è dove vivono i tuoi contatti, i calendari e gli appuntamenti. GodSetter si collega tramite OAuth — autorizzi una volta sola a livello di agenzia, senza chiavi API da incollare — e da quel momento i tuoi sub-account entrano automaticamente come clienti.

Passo 1 — Avvia il flusso OAuth

Apri Connessioni e individua la card GoHighLevel ("CRM — contatti, calendari, prenotazioni."). Clicca "Connetti GoHighLevel". Vieni portato alla schermata di consenso del Marketplace.

Avviare il flusso richiede l'accesso editor sull'area Connessioni: il titolare, un admin o un collaboratore a cui un admin ha dato i diritti di editor.

Passo 2 — Scegli l'account agenzia

Se richiesto, accedi nella schermata di consenso. Quando il Marketplace chiede su quale account installare, scegli il tuo account agenzia — non un singolo sub-account. La connessione deve essere a livello di agenzia perché GodSetter possa vedere tutti i tuoi sub-account; un'installazione limitata a una singola location viene rifiutata e non viene salvato nulla.

Poi approva i permessi richiesti — contatti, calendari, campi personalizzati e le altre capacità che GodSetter usa per fissare appuntamenti e riscrivere i dati delle chiamate.

Passo 3 — Verifica la connessione

Vieni riportato alla pagina Connessioni:

• Successo → "GoHighLevel connesso con successo." e lo stato della card passa a connesso.
• Errore → "Connessione a GoHighLevel non riuscita. Riprova." La causa più comune è aver scelto un sub-account invece dell'agenzia nel passaggio precedente — clicca di nuovo "Connetti GoHighLevel" e seleziona l'account agenzia.

Passo 4 — Importa i tuoi sub-account

Una volta connesso, i sub-account del tuo CRM vengono importati automaticamente una volta al giorno come clienti. Non devi aspettare: apri Clienti e clicca "Sincronizza sub-account" per importarli subito.

Finché non hai importato nulla, la pagina Clienti mette in primo piano "Importa i sub-account da GoHighLevel" e il pulsante Sincronizza sub-account invece di una tabella vuota: i tuoi clienti esistono già nel CRM, quindi importarli è il modo normale di crearli.

Quando invece crei un cliente a mano, il form elenca le tue location GoHighLevel e i calendari di quella location in due selettori — non incolli mai degli ID, a meno che GoHighLevel non sia collegato o non sia raggiungibile: in quel caso il form ripiega sugli ID manuali e ti dice perché.

I clienti importati arrivano attivi e senza un calendario proprio: prenotano sul calendario predefinito dell'agente che li chiama (editor agente → Identità e routing), cercato per nome in ogni sub-account — una scelta sola copre tutti i clienti dello stesso snapshot. Apri un cliente solo per dargli un calendario diverso, o per disattivarlo. Un cliente compare "da configurare" solo quando non ha un calendario e nessun agente outbound attivo ne ha uno predefinito.

Da qui in poi la connessione si tiene allineata a GoHighLevel da sola, senza aspettare il giro giornaliero e senza collegare nessun workflow: un nuovo sub-account viene importato come cliente appena lo crei, uno rinominato viene rinominato anche qui, e uno cancellato o che disinstalla l'app viene disattivato (riga, lead e storico chiamate restano, e le chiamate ancora in coda per lui vengono scartate). Lo stesso vale per i contatti: se cambi numero, nome o fuso orario di un contatto nel CRM, il lead si aggiorna da solo — una chiamata già in coda compone il numero corretto, non quello con cui era nata.

Quando serve riconnettere

I permessi che la tua connessione porta con sé sono fissati al momento del consenso. Se in futuro GodSetter aggiunge funzionalità che richiedono nuovi permessi, la connessione esistente non li avrà finché non riautorizzi: usa "Riconnetti GoHighLevel" sulla stessa card per rieseguire il flusso e acquisire i nuovi permessi. Riconnettere non tocca i clienti importati né lo storico delle chiamate.

C'è un secondo motivo, e questo ti viene a cercare: la Dashboard mostra «Connessione GoHighLevel interrotta - riconnettila da Connessioni» sotto Attenzione richiesta. GodSetter lo segnala quando ha provato a rinnovare il token del tuo CRM e GoHighLevel l'ha rifiutato — di solito perché l'app è stata disinstallata dall'account agenzia, l'autorizzazione è stata revocata, oppure il token salvato non è più valido.

C'è un terzo segnale, ed è il più rapido: se l'app viene rimossa da GoHighLevel, è GoHighLevel stesso ad avvisare GodSetter subito — non serve aspettare il primo rinnovo del token che fallisce. La card passa a non connesso e la tua Dashboard mostra «L'app GodSetter è stata rimossa da GoHighLevel - ricollegala da Connessioni» sotto Attenzione richiesta. Se è un singolo sub-account a rimuovere l'app, viene disattivato solo quel cliente: la sua riga, i suoi lead e il suo storico chiamate restano esattamente dove sono, pronti per una reinstallazione.

Finché non riconnetti:

• Le chiamate in corso non si fermano, e il dialer continua a chiamare per i clienti che hanno un calendario proprio.
• Tutto ciò che tocca il CRM fallisce: prenotazione, disdetta e spostamento durante la chiamata, tag di esito e note, il write-back post-chiamata sui custom field e l'importazione giornaliera dei sub-account.
• I clienti senza un calendario proprio — quelli che prenotano sul calendario predefinito dell'agente che chiama, cercato per nome dentro il sub-account — non riescono a risolvere alcun calendario: i loro lead vengono parcheggiati e ritentati invece di essere chiamati.

Si risolve con lo stesso pulsante: «Riconnetti GoHighLevel» sulla card Connessioni, scegliendo di nuovo l'account agenzia. Due cose da non fraintendere: la card continua a dire connesso (le credenziali sono salvate, è GoHighLevel che le rifiuta), e il banner non è una spia in tempo reale — sparisce 24 ore dopo l'ultimo errore e le ripetizioni sono limitate, quindi conferma la riparazione con una prenotazione vera o un lead di prova, non guardando il banner scomparire.

Prossimi passi

1. Collega il workflow del CRM all'agente — la configurazione che fa davvero partire le chiamate.
2. La checklist di onboarding spiegata — vedi a che punto sei nel complesso.