Collegare la scheda Google Business Profile
Come collegare via OAuth la Scheda Google Business Profile, leggere stat e analisi sentiment+topic AI, generare risposte assistite con linee guida brand e ricevere alert per recensioni basse, risposte pending e cambi scheda.
La Scheda Google Business Profile (GBP) di Miraqo tiene sotto controllo la presenza locale del progetto: rating, recensioni, cambi alla scheda, sentiment AI dei testi e generazione assistita delle risposte. Una sola scheda per progetto.
Questa pagina copre la reputazione e le recensioni. Per la posizione su Google Maps (griglia punto-per-punto) vedi Mappa ranking locale.
Collegare la scheda (OAuth Google)
Dal progetto → sidebar gruppo Local SEO → Scheda GBP. Se nessuna scheda è ancora collegata, vedi un empty-state con Connetti account Google.
- Clicca Connetti account Google — vieni reindirizzato all’OAuth Google.
- Miraqo chiede lo scope
business.managein sola lettura sui dati della scheda. Nessun post, risposta o modifica viene mai scritto in automatico. - Tornato su Miraqo, se l’account ha più di un Google Business Account compare un dropdown per scegliere quello giusto.
- Vedi la lista delle schede disponibili nella pagina Scegli la scheda Google da monitorare, con l’account collegato in alto: per ogni scheda titolo, indirizzo, categoria, telefono. Una scheda senza
placeIdpubblico viene marcata con ⚠ — il monitoraggio recensioni su quel tipo di scheda potrebbe non funzionare. - Seleziona la scheda e clicca Collega scheda.
Da quel momento Miraqo sincronizza la scheda una volta a settimana in automatico (snapshot profilo + recensioni nuove + diff).
Una sola scheda per progetto. Puoi cambiarla in qualunque momento (Scollega → Connetti di nuovo).
La pagina Scheda GBP
Hero
In alto, una card con:
- Titolo della scheda, categoria principale e indirizzo
- ★ Rating medio + numero recensioni totali
- Link 🌐 Sito, 📞 telefono, Apri su Google Maps ↗
- Account Google collegato (email)
- In alto a destra: ⚙️ Linee guida brand, 🔌 Scollega e ← Local SEO
Se la scheda è appena stata collegata e il rating non è ancora arrivato, vedi “Rating non ancora sincronizzato — torna dopo il prossimo aggiornamento settimanale.”
Le 5 stat card
- Rating — media stelle (su 5)
- Recensioni totali — numero totale recensioni Google
- Foto — foto pubblicate sulla scheda (titolare + clienti)
- % con risposta — percentuale di recensioni a cui il titolare ha già risposto, con il dettaglio “X su Y”
- Tempo medio risposta — ore medie tra recensione e risposta titolare
Come ti trovano su Google (30 giorni)
Cinque numeri presi dalle statistiche della scheda, sull’ultimo mese. Su Ricerca e Su Maps contano le volte in cui la scheda è stata mostrata nei due contesti; Click al sito, Chiamate e Indicazioni contano invece cosa ha fatto chi l’ha vista. Il rapporto tra i primi due e gli altri tre è la domanda utile: tante impressioni e zero azioni non dicono che sei poco visibile, dicono che quello che la scheda mostra non convince.
Dati della scheda
I dati pubblici così come risultano su Google all’ultima sincronizzazione: nome, categoria principale e secondarie, indirizzo, telefono, sito, area servita, descrizione, orari di apertura e attributi come «Offre appuntamenti online».
Leggila come una checklist. Un trattino «—» significa che il dato sulla scheda non c’è o non è ancora stato sincronizzato, e i campi vuoti più frequenti — orari e descrizione — sono proprio quelli che Google usa per decidere quando mostrarti. Si compilano in cinque minuti. Fa eccezione l’indirizzo delle attività che lavorano su area servita: lì è nascosto per scelta e il trattino è corretto.
Analisi recensioni (sentiment + topic AI)
Sotto le stat, una card con:
- Ripartizione sentiment (Positive / Neutre / Negative) con conteggio per ognuno
- Punti di forza — i topic ricorrenti emersi nelle recensioni positive (es. “personale”, “qualità”, “prezzo”), con chip “+N”
- Aree critiche — gli stessi topic emersi nelle recensioni negative, con chip “−N”
L’estrazione di sentiment e topic è fatta da AI sui testi delle recensioni — è il modo più rapido per capire cosa apprezzano e cosa lamentano i clienti, senza leggere tutte le recensioni una per una. Se non ci sono topic negativi ricorrenti, la colonna dice Nessuna criticità ricorrente.
Sotto, se hai almeno 2 snapshot settimanali, un grafico trend: andamento del rating medio e del numero recensioni nel tempo (linea ★ + linea #).
Da rispondere (inbox)
Colonna sinistra: inbox delle recensioni non ancora risposte dal titolare. Per ognuna:
- Autore, stelle, data
- Badge sentiment AI
- Testo della recensione (troncato a 4 righe)
- Eventuali chip topic con polarità (verde positivo / rosso negativo)
- Bottone ✨ Genera risposta (per ruoli con permesso edit) → apre il modal “Risposta assistita”
Soglia “recensione bassa”. Quando arriva una nuova recensione ≤ 3 stelle, Miraqo invia un’email di alert agli utenti dell’organizzazione che hanno attivato
receive_gbp_alerts(vedi Notifiche email in Il tuo account).
Modifiche scheda (diff log)
Colonna destra, sotto i dati della scheda: variazioni rilevate tra una sync e l’altra (titolo, categoria, indirizzo, telefono, sito, orari, ecc.) con valore precedente → valore attuale e data del rilevamento. Finché non cambia nulla la card dice Nessuna modifica rilevata finora. Utile per accorgersi di modifiche non autorizzate, sospensioni o variazioni fatte dal cliente senza preavviso.
Quando vengono rilevati cambi alla scheda parte un’email di alert (
gbp_profile_changed).
Recensioni recenti
In fondo, elenco completo delle ultime recensioni raccolte (anche quelle già risposte). Per ognuna: autore, stelle, data, sentiment, eventuale ✓ risposto + risposta del titolare in blocco evidenziato.
Risposta assistita dall’AI
Dal bottone ✨ Genera risposta in inbox si apre un modal con:
- Contesto: autore + stelle della recensione
- Selettore Tono (Formale, Amichevole, Empatico, Conciso) — sovrascrive per questa volta il tono di default delle Linee guida brand
- Bottone 🔄 Rigenera con un counter “Rigenerazioni: X/max” (il limite per recensione è configurato a livello piano). La prima bozza viene generata all’apertura del modal
- Textarea con la bozza generata, modificabile a mano
- Bottone 📋 Copia & apri Google — copia il testo nella clipboard e apre la scheda su Google in nuova scheda così puoi incollarlo nella risposta ufficiale
L’AI non risponde mai in automatico. Miraqo ha solo accesso in lettura: la pubblicazione della risposta su Google la fai sempre tu, a mano. Questo per due motivi: (1) la responsabilità del testo finale resta sotto il tuo controllo; (2) Google non concede a tool di terze parti il permesso di pubblicare risposte automatiche su account altrui.
Linee guida brand
Dal bottone ⚙️ Linee guida brand in alto a destra apri il form di configurazione. Sono le istruzioni che Miraqo passa all’AI ogni volta che genera una bozza:
- Tono e stile — descrizione libera (“rispondiamo per nome, niente emoji, max 4 righe, evitiamo formalità eccessive…”)
- Tono di default — tono preselezionato nel modal Risposta assistita
- Lingua override (ISO) —
it,en, ecc. Vuoto = stessa lingua della recensione - Firma — stringa aggiunta in fondo (es. “Il team di Pizzeria Roma”)
- Frasi/parole vietate — una per riga (es. rimborso, sconto); l’AI le eviterà nella bozza
Le linee guida sono per-progetto e si aggiornano subito: le bozze generate dopo il salvataggio le rispettano. Si confermano con Salva linee guida.
Sincronizzazione e disconnessione
- Cadenza: settimanale automatica (snapshot scheda + recensioni nuove + diff). Non c’è un bottone di sync manuale dedicato.
- 🔌 Scollega — bottone in alto a destra. Revoca il refresh token e disabilita le sync. Lo storico già raccolto resta visibile (recensioni, snapshot, diff): se ricolleghi più avanti, riprende da dove aveva interrotto.
Email di alert
Tre tipi di notifica vengono inviate agli utenti dell’org che hanno attivato receive_gbp_alerts nelle preferenze account:
- Nuova recensione bassa (
gbp_new_low_review) — recensione con ≤ 3 stelle. - Risposte in attesa (
gbp_reply_pending) — recap periodico delle recensioni non ancora risposte. - Cambi alla scheda (
gbp_profile_changed) — variazioni rilevate sui campi della scheda (titolo, indirizzo, categoria, ecc.).
Disattivabili individualmente da Il tuo account → Notifiche email.
Errori frequenti
- “OAuth Google non configurato” — l’amministratore di Miraqo non ha impostato le credenziali OAuth GBP per la tua istanza. Contattalo.
- Nessuna scheda trovata sotto questo account — hai fatto login con un account Google che non ha accesso a nessuna scheda Google Business. Verifica di avere l’account giusto (e che la scheda sia confermata su Google).
- Scheda senza placeId pubblico — alcune categorie di scheda (service-area business non confermati, schede in revisione) non hanno placeId pubblico. Il monitoraggio recensioni può non funzionare; meglio collegare una scheda confermata.
- Le sync sono ferme — il refresh token è stato revocato (cambio password Google, scollegamento app dall’Account Google, scadenza). Scollega + ricollega dal bottone in alto.
Vedi anche:
- Mappa ranking locale → per la griglia di posizionamento su Google Maps
- Citazioni → per la presenza sulle directory e le recensioni Trustpilot e TripAdvisor, che stanno lì e non in questa pagina
- Il tuo account → per gestire le notifiche email GBP
Ultimo aggiornamento: 4 settembre 2026