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.

  1. Clicca Connetti account Google — vieni reindirizzato all’OAuth Google.
  2. Miraqo chiede lo scope business.manage in sola lettura sui dati della scheda. Nessun post, risposta o modifica viene mai scritto in automatico.
  3. Tornato su Miraqo, se l’account ha più di un Google Business Account compare un dropdown per scegliere quello giusto.
  4. Vedi la lista delle schede disponibili: titolo, indirizzo, categoria, telefono. Una scheda senza placeId pubblico viene marcata con ⚠ — il monitoraggio recensioni su quel tipo di scheda potrebbe non funzionare.
  5. 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 e 🔌 Scollega

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

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.

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: variazioni rilevate tra una sync e l’altra (titolo, categoria, indirizzo, telefono, sito, orari, ecc.) con valore precedente → valore attuale e data del rilevamento. 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 — 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)
  • 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.

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:

  1. Nuova recensione bassa (gbp_new_low_review) — recensione con ≤ 3 stelle.
  2. Risposte in attesa (gbp_reply_pending) — recap periodico delle recensioni non ancora risposte.
  3. 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:

Ultimo aggiornamento: 24 maggio 2026