Reseñas y reputación

El módulo de reputación cierra el ciclo después de cada servicio. Cuando una cita queda como completada, ConvertCore AI le pide al cliente una reseña — por email o por WhatsApp — y separa automáticamente las respuestas positivas (que van a tu Google Business Profile o Facebook) de las negativas (que se quedan en privado para que tu equipo haga seguimiento).

Lo positivo se ve en un widget que pegas en tu sitio. Lo negativo nunca sale a la luz pública.

Cuándo conviene activarlo

Cualquier negocio que reciba clientes que regresan: spas, salones, restaurantes, dentistas, talleres, abogados. Si tu reputación online te trae clientes (Google Business Profile, Facebook), el módulo te ayuda a multiplicar las reseñas positivas sin pedirlas a mano, y a tapar las negativas antes de que aparezcan en público.

Paso 1. Configura los enlaces públicos

Ve a Ajustes → Reseñas y reputación. En la sección Enlaces públicos de reseñas, pega al menos uno:

  • Google Business Profile: ve a tu ficha en Google, click en Pedir reseñas y copia la URL corta (la que empieza con https://g.page/r/...).
  • Facebook: la URL pública de la pestaña Reseñas de tu página.

Si llenas ambos, ConvertCore AI prioriza Google.

Paso 2. Define el gating de estrellas

En la misma página, sección Gating de estrellas, elige el umbral mínimo para que una calificación vaya al enlace público. El default y recomendado es 4 estrellas: 4-5★ van a Google/Facebook, 1-3★ caen al formulario privado.

Aviso legal: Google's terms of service desde 2018 prohíben explícitamente el "review gating" (filtrar quién deja reseñas según rating). ConvertCore AI te deja elegir el umbral, pero la responsabilidad del cumplimiento es tuya. Si no quieres correr el riesgo, configura el umbral en 2 estrellas (cualquier rating >= 2 va público) o ajusta el copy de la landing para que sea neutral.

Paso 3. Personaliza el email de solicitud

En la sección Email de solicitud, ajusta el asunto y el cuerpo. Soporta variables que se reemplazan al momento del envío:

  • {{contact.first_name}} — nombre del cliente.
  • {{contact.last_name}} — apellido.
  • {{contact.full_name}} — nombre completo.
  • {{workspace.name}} — nombre de tu negocio.
  • {{review_link}} — enlace único de calificación (debe ir en el cuerpo).

Justo debajo del editor ves una Vista previa que renderiza el HTML con un cliente sample. Si el texto se ve bien con "María González", se va a ver bien con cualquier cliente real.

El cuerpo se manda en HTML; los saltos de línea simples se convierten en <br/> y los párrafos en <p>.

Paso 4. (Opcional) Configura WhatsApp con plantilla Meta

Si quieres mandar reseñas por WhatsApp en lugar de email, necesitas una plantilla aprobada por Meta. Es un requisito de la Cloud API: no se puede mandar texto libre fuera de la ventana de 24 horas del cliente, solo plantillas pre-registradas.

Registrar la plantilla en Meta Business Manager

  1. Entra a Meta Business Suite → WhatsApp Manager → Message templates.
  2. Click Create template. Elige categoría Utility (no Marketing).
  3. Nombre del template: review_request_v1 (el nombre exacto que después configurarás en ConvertCore).
  4. Idioma: Spanish (es).
  5. Body del template, ejemplo:
    Hola {{1}}, gracias por tu visita a {{2}}. ¿Te tomas un minuto para contarnos cómo fue tu experiencia? {{3}}
    
    • {{1}} será el nombre del cliente.
    • {{2}} será el nombre del workspace.
    • {{3}} será el review_link.
  6. Sin botones, sin header. Submit para revisión.
  7. Meta revisa en 1-24 horas. Verás el estado en WhatsApp Manager → Message templates.

Sincronizar la plantilla con ConvertCore

Una vez aprobada (estado Approved en Meta):

  1. En ConvertCore, anda a Ajustes → Plantillas de WhatsApp.
  2. Click Sincronizar con Meta. ConvertCore baja la lista de templates aprobados de tu cuenta de Meta.
  3. Vuelve a Ajustes → Reseñas y reputación. En la sección WhatsApp, elige review_request_v1 del selector.
  4. Asegúrate que el campo variables_list del template tenga los paths correctos: contact.first_name, workspace.name, review_link. Si no, edita la plantilla desde Ajustes → Plantillas de WhatsApp.

Requisito previo: el workspace tiene que tener whatsapp_provider = 'meta_cloud' activo, no Twilio ni wa.me fallback. Ve a Comunicaciones para configurarlo.

Paso 5. Arma el workflow que dispara la solicitud

El módulo se integra con el motor de workflows. La forma normal de mandar reseñas es automática, no manual:

  1. Ve a Flujos y crea uno nuevo.
  2. Trigger: Cita completada (appointment_completed).
  3. Filtro opcional: por service_calendar_id si solo quieres pedir reseñas de ciertos servicios.
  4. Paso 1: Esperar (minutos). Recomendado: 120 (2 horas después de terminar la cita).
  5. Paso 2: Pedir reseña al cliente. Canal: whatsapp o email.
  6. Guarda y activa el workflow.

A partir de ese momento, cada vez que alguien marca una cita como completada en el calendar, el workflow corre y manda la solicitud automáticamente.

Tip: si no quieres bombardear al cliente justo cuando sale del local, una espera de 2-4 horas funciona bien. Si la cita fue por la tarde, el mensaje llega antes de dormir — buen momento para responder.

Cómo se ve para el cliente

El cliente recibe el email o WhatsApp con un enlace tipo https://app.tunegocio.com/r/abc123xyz. Al abrirlo:

  1. Ve una landing con tu logo, color y la pregunta "¿Cómo fue tu experiencia?" con 5 estrellas.
  2. Toca una estrella.
  3. Si elige 4-5★: ConvertCore lo redirige a tu enlace público (Google o Facebook). El cliente deja la reseña pública ahí.
  4. Si elige 1-3★: aparece un formulario privado con un textarea. El cliente cuenta qué no le gustó. Ese mensaje NUNCA se publica — se queda en tu dashboard interno como feedback privado con estado Nuevo.

El enlace tiene vigencia de 30 días por default (configurable en settings) y solo se puede usar una vez.

Moderar las reseñas públicas

Las reseñas 4-5★ caen en estado Pendiente. No aparecen en el widget hasta que las apruebes manualmente.

  1. Ve a Reputación → Reseñas públicas.
  2. Para cada row tienes 3 acciones:
    • Publicar: la marca como Publicada con consent. Aparece en el widget al instante.
    • Ocultar: la marca como Oculta. Sigue en la base, pero no aparece en el widget.
    • Eliminar: borra la row para siempre.

Una vez publicada, puedes volver a ocultarla en cualquier momento desde la misma tabla.

Atender el feedback privado

Las calificaciones 1-3★ caen en Reputación → Feedback privado. Cada row tiene:

  • Estado: NuevoEn cursoResuelto. Cambia el dropdown al avanzar.
  • Asignado a: elige al miembro del equipo que va a contactar al cliente.

Cuando alguien se llena de 1-3★ y deja un mensaje, lo mejor es llamarlo en menos de 24 horas. Una respuesta humana rápida convierte clientes molestos en clientes fieles. El equipo de estudio de Bain & Co calculó que recuperar un cliente molesto vale 5x más que conseguir uno nuevo.

Embebe el widget público en tu sitio

Una vez tengas algunas reseñas publicadas, las puedes mostrar en cualquier sitio externo (WordPress, Webflow, sitio custom, HTML estático). Solo necesitas pegar un script.

  1. Ve a Ajustes → Reseñas y reputación, baja hasta la sección Widget público para tu sitio.
  2. Elige Diseño (grid o carousel) y cantidad de reseñas a mostrar (1-24).
  3. Click Copiar snippet.
  4. Pega el snippet en tu sitio, justo antes de cerrar </body>.
  5. Reemplaza TU_API_KEY por una clave creada en Ajustes → Claves API. Si ya usas una para el widget de reservas, esa misma sirve.

El widget se adapta automáticamente al tema (claro u oscuro) según prefers-color-scheme del visitante. No carga ningún CSS externo — todo viene en el script.

Layouts disponibles

  • Grid: 3 columnas en desktop, se reduce a 1 columna en móvil. Bueno para una sección dedicada en tu home.
  • Carousel: scroll horizontal con snap. Bueno para mostrar más reseñas sin ocupar mucho vertical.

Configura el branding del widget

En la sección Widget público de testimonios del settings:

  • Título: lo que aparece arriba de las cards. Default: "Lo que dicen nuestros clientes".
  • Subtítulo: opcional, debajo del título.
  • Color de acento: hexadecimal #RRGGBB. Se usa en las estrellas y en el avatar placeholder.

Cualquier cambio aquí se refleja en el widget al siguiente fetch (el cache es de 60 segundos).

Verificación end-to-end

Para confirmar que todo está bien armado:

  1. Crea un contacto de prueba con tu propio email/teléfono.
  2. Agenda una cita ficticia con ese contacto en el calendar.
  3. Marca la cita como completada.
  4. Espera (o ajusta el workflow para que el wait_minutes sea 0 durante la prueba).
  5. Revisa tu inbox/WhatsApp — debería llegar la solicitud.
  6. Abre el enlace, deja 5★, completa el flujo a Google.
  7. Vuelve a Reputación → Reseñas públicas, aprueba la review.
  8. Abre tu sitio donde pegaste el widget, recarga — la reseña aparece.

Roadmap V2

Lo que viene en futuras iteraciones (no está en V1):

  • Sync entrante de Google Business Profile API: responder reseñas de Google directo desde ConvertCore.
  • Sync entrante de Facebook Reviews.
  • Respuestas redactadas por AI (Claude) con tono configurable (empático, optimista, formal).
  • Video testimonios nativos: captura webcam dentro de la landing, storage en Supabase.
  • Sentiment analysis con alertas automáticas para reseñas negativas.
  • Soporte multi-location para clientes con varias sucursales.

Cuando alguno de estos features entre en beta, lo anunciamos por email y se documenta acá.

Limitaciones conocidas

  • El email se manda desde el dominio configurado en RESEND_FROM. Si quieres usar tu propio dominio (en lugar de no-reply@convertcoreai.com), pide acceso al equipo de soporte.
  • WhatsApp requiere template Meta aprobada. No hay fallback a wa.me para reviews — es Meta Cloud API o nada.
  • Una solicitud por contacto por cita. No tenemos lógica anti-spam global todavía: si configuras dos workflows con el mismo trigger, el cliente recibe dos mensajes.

Si algo no te encaja, escribe a soporte y te ayudamos a armar el setup para tu negocio.