Reseñas de Google: pedirlas después de cada visita

La integración de Reseñas de Google del club de fidelización de Connect Manager trae cada día al panel las reseñas de Google de cada local y, cuando un socio paga en el TPV Ágora, le pide una reseña con un enlace directo a la ficha del local, con un filtro opcional que recoge en privado las valoraciones bajas. Este manual es para el técnico que lo deja configurado: qué identificador de Google hace falta, dónde se pone, cómo funciona por dentro y cómo comprobarlo.

Qué hace la integración#

• Importa las reseñas de Google de cada local todos los días a las 05:30 (hora de Madrid), a través de Outscraper: nota, texto, autor, fecha, respuesta del dueño y enlace a la reseña. La importación es incremental: solo pide lo publicado desde la última reseña que ya tiene, menos un día de margen, y no duplica nada.
• Importa a demanda desde la lista de locales: «Sincronizar reseñas» (lo nuevo) e «Importar histórico» (reseñas antiguas, con un tope que se elige).
• Pide una reseña tras la visita: al cerrar en Ágora una factura con socio, si el club lo tiene activado, a partir de un número mínimo de visitas y sin repetir antes de unos días. Le llega por correo con un botón «Dejar mi reseña».
• Filtra antes de mandar a Google, si se activa: el enlace lleva primero a una página propia donde el socio puntúa con estrellas. A partir del umbral elegido (3, 4 o 5 estrellas) se le lleva a escribir la reseña en Google; por debajo, su comentario se queda en privado en «Opiniones privadas».
• Genera enlaces y QR por local para poner en las mesas, con el mismo filtro; lo que entra por ahí sale como anónimo.
• Propone una respuesta a cada reseña con IA (o con una plantilla según la nota, si no hay IA configurada), para copiarla y pegarla en Google.
• Enseña la nota media de Google y el número de reseñas en la portada de la tienda online propia del grupo.
• Da acceso de solo lectura a las reseñas del grupo para otros sistemas (por ejemplo, Power BI) con una clave de API.

Qué no hace#

• No publica las respuestas en Google: el borrador se copia y se pega en la ficha de Google.
• No deja cambiar el texto del correo de petición desde el panel: sale siempre el texto de serie.
• No pide reseña por notificación: aunque la comunicación tiene un canal de notificación, el portal no llega a suscribir el navegador, así que la petición solo llega por correo. Un socio sin correo no la recibe.
• No recupera solo lo que no entró en la primera carga: la importación diaria avanza hacia delante. Para lo antiguo está «Importar histórico».
• No pide reseñas de ventas sin socio: solo de facturas que llegan a Connect Manager por la fidelización de Ágora.
• No manda a Google a quien puntúa alto si el local no tiene identificador de Google: le da las gracias y ya.

Requisitos#

• La clave de Outscraper en el servidor (cuenta de Connect Manager, la mantiene FOS). Sin ella no se importa nada y los botones de importar no aparecen. Outscraper cobra por reseña descargada.
• El identificador de Google de cada local: el Place ID (ChIJ…), el CID o un enlace de Google Maps.
• La integración con el TPV funcionando, con la URL de envío de facturas puesta en Ágora (ver Fidelización: conectar el club con Ágora): la petición de reseña sale al registrar la factura.
• Socios con correo y el proveedor de correo del club funcionando (ver Proveedores de envío de correo).
• Para los borradores con IA, un proveedor de IA configurado en el servidor (si no, se usa la plantilla).
• Permisos en el panel: «Fidelización: Configurar integración por local» para los locales y «Fidelización: Reputación» para «Reseñas de Google» y «Opiniones privadas».

Quién hace qué. FOS mantiene la clave de Outscraper y la de IA. El técnico pone el identificador de cada local, lanza la primera importación y activa la petición. El cliente decide si pide reseñas, a partir de qué visita, cada cuánto y si usa el filtro.

Datos que necesitamos#

Configuración paso a paso#

1. En Google: el identificador del local#

1. Busca el local con el buscador de Place ID de Google y copia el identificador que empieza por ChIJ, o copia el enlace del local en Google Maps.
2. Para la petición de reseña conviene el Place ID: con él el enlace abre directamente el cuadro de «escribir reseña». Con un CID se abre la ficha del negocio y el socio tiene que pulsar él «Escribir reseña».

2. En Connect Manager: el local#

1. Elige el grupo en el selector de la cabecera y ve a Configuración → Locales.
2. Pulsa Configurar en el local y pega el identificador en «Google Place ID / enlace (reseñas)». Acepta el Place ID, el CID o un enlace de Google Maps o de las reseñas: al guardar se extrae el identificador.
3. Guarda. En la lista, la columna «Reseñas» del local pasa a marcada («Google Place ID configurado · importación de reseñas activa»).
4. Para traer las reseñas antiguas, en «Más opciones» pulsa Importar histórico y pon «Máx. reseñas a importar» (se recomienda empezar con 200–500; 0 = todas, y se cobran todas). Tarda unos minutos.
5. A partir de ahí la importación es diaria. Sincronizar reseñas trae lo nuevo en el momento.

3. En Connect Manager: la petición tras la visita#

Ve a Configuración → Portal público de clientes, abre el club y entra en Fidelización, sección «Reseñas (petición tras la visita)»:

1. «Pedir reseña automáticamente tras la visita»: enciéndelo.
2. «Pedir a partir de la visita nº»: 1 = desde la primera; súbelo para pedir solo a clientes recurrentes.
3. «No volver a pedir antes de (días)»: el periodo mínimo entre dos peticiones al mismo socio.
4. «Filtrar antes de pedir reseña pública (gating)» y «Estrellas mínimas para mandar a Google»: 3 ★ o más, 4 ★ o más o Solo 5 ★.
5. Guarda. La petición solo sale en los locales que tienen identificador de Google.

4. Los QR de las mesas#

1. Elige el grupo en el selector de la cabecera.
2. Ve a Reputación → Opiniones privadas y pulsa Enlaces para QR.
3. Para cada local salen su enlace y su QR, con un PNG grande para imprimir. Los enlaces van firmados y no caducan, así que el QR impreso sigue valiendo.

5. Lo que se ve en el panel#

• Reputación → Reseñas de Google: fecha, local, valoración, autor, reseña, si está respondida y fuente, con filtros por valoración, respuesta y local. Acciones: «Ver en Google», «Ver completa» y «Sugerir respuesta».
• Reputación → Opiniones privadas: fecha, local, cliente (o anónimo), valoración, si se mandó a Google y comentario.
• Si el cliente no lo tiene contratado, se puede quitar del menú en la subpágina Fidelización del club, «Módulos visibles en el menú» («Reseñas de Google» y «Opiniones privadas»). Solo afecta al menú.

6. Opcional: acceso desde Power BI u otro sistema#

En Configuración → Integraciones crea una clave para el grupo y abre «Ver credenciales»: muestra la URL, la clave, un ejemplo de cURL y la consulta para Power BI. Los puntos de acceso, de solo lectura y limitados al grupo de la clave, son GET /api/loyalty/reviews (con per_page, locale_id, min_rating y since), GET /api/loyalty/reviews/summary y GET /api/loyalty/locales, con la clave en la cabecera X-API-KEY. Admiten 120 peticiones por minuto.

7. Opcional: la tienda online propia#

La portada de la tienda enseña sola la nota media de Google del grupo cuando hay reseñas importadas. Para pedir la reseña al entregar un pedido, cada local tiene su campo en Delivery propio → Configuración → Locales → Ubicación y contacto, sección «Reseñas», «Enlace para dejar una reseña en Google» (tiene que empezar por https://).

Cómo funciona#

Importación diaria#

A las 05:30 una tarea recorre los locales con identificador de Google. Para cada uno pide a Outscraper las reseñas más recientes desde la fecha de corte (la última reseña guardada menos un día). Si Outscraper responde que la tarea va en segundo plano, se le pregunta cada 15 segundos hasta que termina. Cada reseña se guarda o se actualiza por su identificador, así que reimportar no duplica y recoge las respuestas del dueño de las reseñas que vuelven a entrar. Si un local falla, se anota y se sigue con el siguiente.

sequenceDiagram
    participant T as Tarea diaria
    participant CM as Connect Manager
    participant O as Outscraper
    participant G as Google Maps
    T->>CM: Locales con identificador de Google
    CM->>O: Reseñas del local desde la fecha de corte
    O->>G: Lee las reseñas públicas
    O-->>CM: Reseñas o tarea en segundo plano
    CM->>O: Consulta el resultado cada 15 segundos
    CM->>CM: Guarda o actualiza cada reseña

Petición de reseña tras la visita#

Cuando Ágora envía a Connect Manager la factura de un socio y se acepta, se suma la visita y se mira si toca pedir reseña: el local tiene identificador de Google, el club tiene la petición encendida, el socio llega al mínimo de visitas y no se le ha pedido dentro del plazo (esta comprobación se reserva de forma que dos tickets a la vez no mandan dos correos). Si toca, se encola el correo con el enlace: el de la página de filtro, firmado y válido 30 días, si el filtro está activo, o el directo de Google si no. Un fallo aquí nunca impide aceptar la factura.

sequenceDiagram
    participant TPV as TPV Ágora
    participant CM as Connect Manager
    participant S as Socio
    participant G as Google
    TPV->>CM: Factura con socio
    CM->>CM: Comprueba visitas, plazo e identificador del local
    CM->>S: Correo con el enlace de reseña
    S->>CM: Puntúa con estrellas en la página de filtro
    alt Nota igual o superior al umbral
        CM-->>S: Le lleva a escribir la reseña
        S->>G: Publica la reseña
    else Nota inferior
        CM->>CM: Guarda la opinión privada
        CM-->>S: Página de agradecimiento
    end

El filtro y los QR#

Cada valoración queda registrada en «Opiniones privadas», con la marca de si se mandó a Google; el comentario solo se guarda cuando no se manda. Si el mismo socio vuelve a valorar el mismo local, se corrige su valoración en vez de sumar otra. En los QR de mesa no hay socio: la valoración entra como anónima y el mismo navegador corrige la suya si vuelve a enviar.

Coste y reintentos#

• La importación diaria pide como mucho 50 reseñas por local; «Sincronizar reseñas», 200. Outscraper solo cobra las que superan la fecha de corte.
• La importación desde el panel va en segundo plano: 2 intentos, con 3 minutos de margen (10 en el histórico).
• El correo de petición se reintenta hasta 3 veces si el proveedor de correo falla.

Comprobar que funciona#

1. El local tiene marcada la columna «Reseñas» en Configuración → Locales.
2. Pulsa «Sincronizar reseñas» y, en unos minutos, mira Reputación → Reseñas de Google filtrando por el local.
3. Con un socio de prueba que tenga correo, pon «Pedir a partir de la visita nº» en 1 y cierra en Ágora una factura con ese socio en un local con identificador de Google. Debe llegarle el correo y, en su ficha, pestaña «Comunicaciones», aparecer «Petición de reseña».
4. Con el filtro activo, abre el enlace y puntúa con 2 estrellas: la opinión aparece en «Opiniones privadas». Vuelve a abrirlo y puntúa con 5: se abre Google para escribir la reseña.
5. Escanea uno de los QR de mesa y comprueba que la opinión entra como anónima.
6. En una reseña, pulsa «Sugerir respuesta» y revisa el borrador.

Errores frecuentes y solución#

Preguntas frecuentes#

¿Cómo conecto las reseñas de Google de mi restaurante con Connect Manager?#

Pega el Place ID o el enlace de Google Maps del local en Configuración → Locales → Configurar, «Google Place ID / enlace (reseñas)». Desde ese momento las reseñas se importan cada día.

¿Cómo pido reseñas de Google a los clientes que pagan en Ágora?#

Activa «Pedir reseña automáticamente tras la visita» en la subpágina Fidelización del club. Al cerrar en Ágora una factura con socio, se le manda un correo con el enlace a la reseña del local.

¿Se pueden contestar las reseñas de Google desde el panel?#

No se publican desde el panel: «Sugerir respuesta» prepara un borrador, con IA si está configurada, que se copia y se pega en Google.

¿Qué hace el filtro de reseñas (gating)?#

Antes de mandar al socio a Google le pide una nota con estrellas en una página propia. Si llega al umbral, va a Google; si no, su opinión se guarda en privado en «Opiniones privadas».

¿Cuánto tarda en aparecer en el panel una reseña nueva de Google?#

Como mucho hasta la importación de las 05:30 del día siguiente; con «Sincronizar reseñas» aparece en unos minutos.

¿Dónde encuentro el Place ID de mi local?#

En el buscador de Place ID de Google (enlace abajo). También vale pegar el enlace del local en Google Maps: Connect Manager extrae el identificador al guardar.

Referencias#

• Ficha de Reseñas de Google en el catálogo
• Fidelización: conectar el club con Ágora
• Proveedores de envío de correo
• Place ID de Google y buscador de Place ID
• Outscraper