Vouch — Guía del Usuario

Un recorrido práctico de la plataforma de reputación Vouch, desde la configuración de la plataforma hasta ejecutar tu primera campaña de reseñas asistida por IA. Escrito para usuarios de marketing y operaciones — no se requiere experiencia técnica.

Aviso: Esta guía describe la aplicación web administrativa en https://vouch-admin-web.<tu-entorno>.azurecontainerapps.io. Inicia sesión con tus credenciales de Azure AD / corporativas, o con el correo + contraseña que tu administrador de plataforma configuró para ti.

Tabla de Contenidos

1. Qué Hace Vouch
2. Roles y Quién Hace Qué
3. Configuración Inicial (Admin de Plataforma)
4. Dentro de un Inquilino: Configuración de Marca
5. Agregar Ubicaciones
6. Importar Contactos
7. Cumplimiento y Política de Envío
8. Plantillas: Lo Que Verán Tus Destinatarios
9. Referencia de Variables
10. Campañas: Cómo se Organizan los Envíos
11. Enviar una Solicitud de Reseña
12. Leer la Pestaña de Historial
13. Bandeja: Respuestas, Reseñas y Clasificación
14. El Asistente IA
15. Aprobaciones, Automatización, Recomendaciones, Experimentos
16. Referencia de Configuración
17. Preguntas Comunes y Solución de Problemas

Qué Hace Vouch

Vouch ayuda a negocios con múltiples ubicaciones (restaurantes, consultorios médicos, servicios a domicilio, tiendas minoristas, etc.) a recopilar más reseñas en Google / Yelp / Facebook — y responder más rápido — sin violar los términos de las plataformas de reseñas o las leyes anti-spam.

El flujo general:

1. Agregas tus ubicaciones y contactos de clientes.
2. Creas (o generas con IA) una plantilla amigable de solicitud de reseña.
3. Lanzas una campaña. Vouch envía la solicitud por correo, SMS o WhatsApp en el momento correcto, por el canal correcto, con el saludo personal correcto.
4. Los clientes hacen clic para dejar una reseña en Google o Yelp.
5. Vouch recupera esas reseñas, califica tu reputación y muestra la Bandeja IA para que puedas responder desde un solo lugar.
6. El Asistente IA sugiere próximos pasos — borradores de respuestas, señala feedback negativo, recomienda seguimientos, ejecuta experimentos.

La plataforma maneja las partes que son fáciles de hacer mal: horarios de silencio, límites de frecuencia, cumplimiento de cancelación de suscripción, supresión de contactos, renderizado de variables de plantilla, seguimiento de enlaces y registro de auditoría.

Roles y Quién Hace Qué

A lo largo de esta guía, cualquier cosa marcada como 🔒 Admin de Plataforma solo es visible para cuentas de admin de plataforma. Todo lo demás está disponible para admins de inquilino (y la mayoría también para usuarios de inquilino).

Configuración Inicial (Admin de Plataforma)

🔒 Admin de Plataforma

Crear el inquilino

1. Inicia sesión y haz clic en Inquilinos en la barra lateral izquierda (bajo el grupo Admin).
2. Haz clic en + Nuevo Inquilino.
3. Completa:
   • Nombre — cómo llamarás al cliente (ej. "Restaurantes Acme").
   • Slug — un identificador corto compatible con URLs (minúsculas, guiones). Usado en URLs internas y exportaciones — no se puede cambiar después.
   • Plan — starter, growth o enterprise. Controla algunas funcionalidades pero no se aplica a nivel API.
   • Marca inicial — cada inquilino necesita al menos una marca. Proporciona un nombre y slug de marca. Puedes agregar más marcas después.
   • Primer admin (opcional) — dirección de correo de la persona que administrará el inquilino día a día. Resolveremos su cuenta en tu directorio y le otorgaremos admin de inquilino.
4. Haz clic en Crear. Serás llevado a la página de detalle del inquilino.

Recorrido de la página de detalle del inquilino

La página del inquilino (/admin/tenants/<id>) es el tablero operacional para un cliente. Tiene, de arriba abajo:

• Encabezado — nombre + slug + plan + estado (Activo / Pausado).
• Tarjetas de estadísticas — totales de Usuarios, Contactos, Solicitudes, Integraciones. Actualizados en vivo.
• Detalles del Inquilino — nombre editable, menú desplegable de plan, estado con botones Pausar/Reanudar. Pausar solicita una razón y detiene todos los envíos salientes hasta que reanudes.
• Marcas — una tarjeta de editor por marca. Ver Dentro de un Inquilino: Configuración de Marca.
• Ubicaciones — lista con agregar / carga masiva / editar / enriquecer con IA. Ver Agregar Ubicaciones.
• Configuración de Correo — Dirección remitente, dominio remitente, estado DKIM/DMARC. Configurar en Configuración → Correo y DKIM en la vista de inquilino.
• Miembros del Equipo — invitar usuarios + administrar rol + eliminar.

Pausar vs Eliminar

Intencionalmente no hay botón "Eliminar inquilino". Para detener la actividad de un cliente, Pausar. El inquilino permanece en la base de datos (para auditoría + retención GDPR), todos los envíos se detienen inmediatamente, y los usuarios reciben un aviso amigable de "inquilino suspendido" en el próximo inicio de sesión. Reanudar simplemente cambia el estado de vuelta.

La eliminación permanente está reservada para contextos de cumplimiento y se ejecuta como un script de operador separado.

Dentro de un Inquilino: Configuración de Marca

Cada inquilino tiene al menos una marca. La mayoría de los clientes tiene una. Los clientes multi-marca (ej. un grupo hotelero con 3 conceptos de restaurante distintos) pueden crear varias. Los campos a nivel marca son heredados por las ubicaciones que no los sobrescriben.

Qué vive a nivel marca

• Identidad: nombre, sitio web, dirección corporativa.
• Voz y Tono:
  • Voz de marca — profesional / amigable / casual / lujo…
  • Tono de marca — cálido / formal / empático / divertido…
  • Descripción de marca — 1–3 oraciones que los agentes IA leen al redactar plantillas y respuestas.
• Perfiles de reseña predeterminados:
  • URL de Google My Business + ID de lugar
  • URL de Yelp + ID de negocio
  • URL de página de Facebook + ID de página

Estos actúan como respaldos para ubicaciones. Si una ubicación particular no establece su propia URL de Google, se usa la URL de la marca.

Cómo editar

1. Abre la página de detalle del inquilino → desplázate a Marcas.
2. Cada marca tiene una tarjeta de editor. Actualiza los campos que desees y haz clic en Guardar Marca.
3. La tarjeta permanece expandida para que puedas seguir ajustando sin perder contexto.

Consejo: Una Descripción de marca clara y específica mejora drásticamente la calidad de las plantillas y respuestas generadas por IA. "Panadería familiar en Brooklyn, conocida por masa madre y servicio cálido pero directo" supera a "una panadería" cada vez.

Agregar Ubicaciones

Las ubicaciones son las unidades en las que los clientes piensan al dejar una reseña: "el local de Austin", "la clínica de Cherry Creek". Cada campaña se envía desde una ubicación, cada reseña se adjunta a una ubicación, cada puntuación se desglosa por ubicación.

Encontrarás la sección Ubicaciones dentro de la página de detalle del inquilino.

Cuatro formas de agregar una ubicación

1. Auto-Buscar Ubicaciones (Descubrimiento IA)

La forma más rápida de empezar. Haz clic en Auto-Buscar Ubicaciones en la sección Marca (página de detalle del inquilino para admins de plataforma, o Configuración → Perfil de Marca para usuarios de inquilino).

Qué hace:

• Usa IA para descubrir todas las ubicaciones de tu negocio basándose en el nombre de marca, URL del sitio web y dirección corporativa.
• Para cadenas/franquicias, se enfoca en la sede y ubicaciones emblemáticas principales (usa importación masiva para cobertura completa).
• Devuelve detalles completos de dirección, información de contacto, zonas horarias e intenta encontrar IDs de Google Place y URLs de plataformas de reseñas.
• Crea recomendaciones para cada ubicación descubierta — revísalas en la sección Recomendaciones, luego aprueba para crear las ubicaciones reales.

Ideal para:

• Empezar rápidamente con un nuevo inquilino
• Negocios con 1–10 ubicaciones
• Encontrar sede y tiendas emblemáticas para cadenas

Cómo funciona:

1. Completa el nombre de marca, URL del sitio web y dirección corporativa en la sección Marca.
2. Haz clic en Auto-Buscar Ubicaciones.
3. Espera 10–30 segundos mientras la IA busca en la web.
4. Navega a Recomendaciones para revisar las ubicaciones descubiertas.
5. Aprueba las que se vean correctas; rechaza o edita cualquiera que necesite corrección.
6. Las ubicaciones aprobadas se crean automáticamente.

Consejo: La IA verifica las direcciones contra tu información de marca para evitar devolver la "Pizzería de Joe" equivocada en una ciudad diferente. Si el descubrimiento devuelve menos ubicaciones de las esperadas, intenta agregar una dirección corporativa más completa o usa carga masiva para cobertura total.

2. Una a la vez

Haz clic en Agregar Ubicación. Completa:

• Nombre (requerido)
• Línea de dirección 1 / ciudad / estado / código postal / país
• Teléfono, correo, sitio web

Marca Auto-completar detalles faltantes después de crear (activado por defecto) y el agente IA de Vouch investigará tu negocio en la web — perfil de Google, Yelp, Facebook, ID de lugar — y completará cualquier cosa que dejaste en blanco. Los valores existentes nunca se sobrescriben.

3. Carga masiva CSV

Haz clic en Carga Masiva CSV. Coloca una hoja de cálculo con una ubicación por fila.

Columna requerida: name. Columnas opcionales (mezcla y combina — el estilo del encabezado no importa, insensible a mayúsculas y separadores):

Límites: 1000 filas / 5 MB por carga. Si necesitas más, divide en lotes.

Marca Auto-completar detalles faltantes después de cargar y el agente IA investiga cada ubicación recién creada en segundo plano. La carga devuelve inmediatamente con un mensaje "X enriquecimientos en cola"; actualiza la tabla después de un minuto para ver los campos completados.

4. Enriquecer por fila en ubicaciones existentes

Haz clic en Enriquecer en cualquier fila de la tabla de ubicaciones. El agente IA ejecuta 3–6 búsquedas web, verifica la dirección contra fragmentos y completa campos en blanco. Aparece un mensaje emergente con lo que se completó (y lo que se preservó).

Por qué verificamos la dirección: "Panadería Acme" existe en Austin, Brooklyn y Portland. Sin verificación, el modelo podría devolver alegremente la URL de la tienda equivocada. El agente rechaza coincidencias que no alinean en ciudad / dirección / teléfono.

Editar una ubicación

Haz clic en el nombre de la ubicación (en azul) o el botón Editar. El modal agrupa campos en secciones:

• Identidad — nombre
• Dirección — líneas de dirección, ciudad, estado, código postal, país
• Contacto — teléfono, correo, sitio web
• Perfiles de reseña — URL de Google + ID de lugar, URL de Yelp + ID de negocio, URL de Facebook + ID de página. Nota en línea explica el orden de resolución de {{review.link}}.

Cómo se resuelve {{review.link}}

Cuando usas {{review.link}} en una plantilla, Vouch elige la primera URL no vacía de esta cadena:

1. Sobrescritura por envío (raramente usado)
2. URL de Google My Business de la ubicación
3. URL de Yelp de la ubicación
4. URL de Facebook de la ubicación
5. URL de Google de la marca
6. URL de Yelp de la marca
7. URL de Facebook de la marca
8. Sitio web de la ubicación
9. Página de feedback de Vouch (último recurso)

Establece la URL una vez a nivel marca para perfiles compartidos, luego sobrescribe por ubicación solo donde difiera.

Importar Contactos

Los contactos son los destinatarios de tus campañas. Cada contacto pertenece a un inquilino y puede tener correo, teléfono, ambos o ninguno. Sin al menos uno de correo o teléfono no pueden recibir nada.

Entrada manual

Contactos → + Nuevo Contacto → completar. Útil para agregar individuos durante una campaña.

Importación CSV

Contactos → Importar CSV. Mismas reglas de encabezado tolerante que la carga de ubicaciones:

Límite: 5000 filas por importación. ¿Listas más grandes? Divide, o contacta a soporte — podemos ejecutar una importación masiva única del lado del servidor.

Por qué importa el nombre/apellido

Sin firstName, tu variable {{contact.firstName}} se renderiza vacía:

Estimado , gracias por visitar...

Tres formas de evitar esto:

1. Incluye columnas firstName / lastName en tu importación.
2. Usa un valor predeterminado en tu plantilla: {{contact.firstName | "cliente"}} → Estimado cliente,
3. Deja que Vouch derive un nombre del correo. Si un contacto no tiene firstName pero tiene ej. sathya.krishnamurthy@gmail.com, Vouch saluda automáticamente "Estimado Sathya,". Buzones genéricos (info@, noreply@) se omiten. Sobrescribe estableciendo un firstName explícito.

Supresión y consentimiento

• Contactos suprimidos se marcan mediante isSuppressed = true. Un cliente que marca tu correo previo como spam, o que hace clic en Cancelar suscripción, se auto-suprime. Los contactos suprimidos nunca recibirán envíos; el motor de políticas devuelve "Contacto está en la lista de supresión".
• Registros de consentimiento rastrean la aceptación por canal (granted, revoked, pending). Impulsa la distinción "sin consentimiento de correo en archivo" vs "destinatario canceló suscripción" en tu pestaña Historial.

Cumplimiento y Política de Envío

Incluso una plantilla perfecta será bloqueada si ignoras la política. Los valores predeterminados son conservadores — puedes ajustarlos en Configuración → Cumplimiento → Política de Envío.

Qué se aplica en cada envío

Los tiempos se interpretan en la zona horaria del destinatario (o la de la ubicación, si el contacto no tiene una).

Modo Seguro para Salud

Activar/desactivar en Configuración → Cumplimiento → Salud. Cuando está activo:

• Elimina PII de mensajes salientes (sin nombres en líneas de asunto).
• Aplica patrones de plantilla seguros para HIPAA.
• Bloquea variables que podrían filtrar información de salud protegida en encabezados.

Usa esto si algún inquilino opera en contexto de salud. Se puede establecer por inquilino, así que un cliente multi-marca puede mezclar.

GDPR / CCPA

• Exportación de Datos — genera un reporte PII completo para un contacto con un clic. Va a un archivo JSON descargable.
• Eliminación de Datos — borra permanentemente los datos de un contacto. Registrado en auditoría. Requiere escribir "DELETE" para confirmar.

Ambos están activados por defecto. Deshabilita si tu jurisdicción no los requiere y prefieres no exponer los botones.

Plantillas: Lo Que Verán Tus Destinatarios

Las plantillas viven en la sección Plantillas. Cada plantilla tiene:

• Nombre — etiqueta interna
• Canal — email, sms o whatsapp (elegido en creación, inmutable después)
• Locale — por defecto en-US
• Asunto (solo correo)
• Cuerpo de texto plano
• Cuerpo HTML (solo correo)

El editor

El cuerpo HTML usa un editor de texto enriquecido con:

• Pestaña Visual — escribe y formatea como un documento.
• Pestaña HTML — para pegar desde Mailchimp / diseños ajustados a mano.
• Pestaña Vista previa — renderiza el correo en un iframe aislado.

La paleta de chips en la parte inferior inserta variables comunes con un clic.

Validación de variables en vivo

Mientras escribes, el editor escanea variables no reconocidas. Si escribes mal {{contat.firstName}} verás una advertencia naranja sobre el botón Guardar:

⚠ 1 variable no reconocida — estas se enviarán literalmente en el correo. {{contat.firstName}} Consejo: proporciona un respaldo para valores vacíos — {{contact.firstName | "cliente"}} renderiza cliente cuando el contacto no tiene nombre.

Vista previa con datos de muestra

Después de guardar, haz clic en Vista previa con datos de muestra. Vouch renderiza la plantilla contra un contexto de muestra (Jane Smith / Ubicación Downtown / Negocio Acme). Lo que ves en la vista previa es exactamente lo que ve un destinatario — menos el intercambio de personalización. Detecta variables faltantes, HTML roto y campos vacíos.

Versiones y aprobación (opcional)

• Guardar crea o actualiza el borrador actual.
• Para industrias reguladas: habilita Requerir Aprobación en Configuración → Cumplimiento. Las plantillas entonces inician en borrador y necesitan un rol de Aprobador para cambiarlas a aprobadas antes de poder vincularse a una campaña.

Traducciones de plantillas (soporte multiidioma)

Si sirves a clientes en múltiples idiomas, puedes crear variantes de traducción de cualquier plantilla. Vouch las agrupa para que puedas administrar todos los idiomas en un solo lugar.

Cómo funciona:

1. Crea tu plantilla principal (ej. en inglés, locale en-US).
2. Haz clic en Agregar traducción debajo del nombre de la plantilla (en la vista de lista o vista de detalle).
3. Elige tu idioma destino del menú desplegable — es-MX (Español - México), fr-CA (Francés - Canadá), zh-CN (Chino - Simplificado), etc.
4. Haz clic en Traducir. La IA de Vouch traduce el asunto, cuerpo de texto y contenido HTML mientras preserva todas las variables ({{firstName}} permanece exactamente igual).
5. La nueva plantilla aparece como hermana de traducción. Verás insignias de locale (ej. 🇺🇸 en-US, 🇲🇽 es-MX) vinculando todas las variantes.
6. Haz clic en cualquier insignia para navegar a esa variante de locale.
7. Edita la traducción si necesitas refinar la salida de la IA — ajusta tono, corrige fraseo regional, etc.

Dónde ocurre la traducción:

• Envíos de campaña: cuando un contacto tiene un campo locale establecido (ej. es-MX), Vouch auto-resuelve a esa variante de plantilla si existe. Recurre al locale predeterminado si no hay coincidencia.
• Vinculaciones de plantilla: puedes vincular locales específicos a campañas, o dejar que Vouch elija basándose en el locale del destinatario.

Beneficios:

• Traducción IA de un clic — sin copiar/pegar en Google Translate.
• Preservación de variables — los campos de personalización permanecen intactos.
• Gestión agrupada — todas las traducciones vinculadas, fáciles de encontrar y actualizar.
• Enrutamiento automático de locale — envía el idioma correcto al destinatario correcto sin ramificación manual.

Patrón común:

1. Importa contactos con una columna locale (en-US, es-MX, fr-CA).
2. Crea tu plantilla en inglés.
3. Agrega traducciones en español y francés.
4. Vincula las tres a una campaña.
5. Envía — Vouch elige el locale correcto por destinatario automáticamente.

Consejo: El traductor IA respeta tu voz y tono de marca. Si tu marca está establecida en casual y divertida, la traducción al español coincidirá con ese estilo. Actualiza tu descripción de marca para mejores resultados.

Referencia de Variables

Las variables son marcadores de posición que se completan por destinatario en el momento del envío. Vouch es generoso sobre cómo las deletreas — mayúsculas, espacios en blanco y variantes comunes funcionan.

Contacto

Ubicación y Marca

Enlaces

Otros

Predeterminados — la sintaxis de barra vertical

Cualquier variable puede tomar un respaldo para cuando el campo subyacente esté vacío:

Hola {{contact.firstName | "cliente"}},

Se renderiza como Hola Jane, si firstName = "Jane", de lo contrario Hola cliente,.

Los predeterminados entre comillas ("cliente"), comillas simples ('cliente') y palabras sueltas ({{firstName | amigo}}) funcionan.

Campañas: Cómo se Organizan los Envíos

Una campaña es un contenedor nombrado y reportable para una secuencia de envíos de solicitud de reseña. Casi siempre quieres una por caso de uso ("Solicitud de reseña post-visita — Junio 2026") para que el Historial y las métricas se agrupen limpiamente.

Tipos de campaña

Secuencias

La mayoría de las campañas envían una sola solicitud. Las campañas de goteo y continuas pueden tener una secuencia: paso 1 envía el día 0, paso 2 envía el día 3, paso 3 envía el día 7, etc. Cada paso tiene su propio canal + plantilla.

Configurar en la pestaña Secuencia de la campaña.

Vinculaciones de plantilla

Una campaña necesita al menos una plantilla vinculada a ella. Vincular en Campaña → sección Plantillas → + Vincular Plantilla. Elige:

• La plantilla
• El canal
• (Opcional) Locale, clave de variante, prioridad, ventana activa

Cuando presionas Enviar sin elegir una plantilla explícitamente, Vouch elige la vinculación activa para el canal elegido. Si existen múltiples vinculaciones (pruebas A/B), elige la marcada como isControl primero, luego por priority descendente.

Política de plantilla estricta: Vouch se niega a enviar sin una plantilla resoluble. Verás uno de:

• NO_TEMPLATE — sin vinculación para este canal
• TEMPLATE_NOT_FOUND — vinculación apunta a una plantilla eliminada
• TEMPLATE_CHANNEL_MISMATCH — plantilla vinculada es para SMS pero estás enviando correo
• TEMPLATE_EMPTY — los campos de asunto + cuerpo de la plantilla están todos en blanco

No se crean solicitudes cuando la validación falla — el operador ve un claro 400 en la pestaña Enviar.

Enviar una Solicitud de Reseña

Abre tu campaña → pestaña Enviar. Hay dos rutas.

Ruta A — a contactos existentes en tu base de datos

Usa esto cuando ya has importado / construido una lista de contactos en Vouch.

1. Elige una Ubicación (impulsa variables de dirección, resolución de review-link, zona horaria para horarios de silencio).
2. Elige un Canal — email, sms o whatsapp.
3. Opcionalmente elige una Plantilla. Si se deja en blanco, Vouch auto-resuelve desde la vinculación de la campaña.
4. Haz clic en Enviar ahora.

El panel de resultados muestra:

• X mensajes en cola, Y bloqueados por política, Z fallidos de N.
• La plantilla que se usó (con una pista "(auto-resuelto desde vinculación)" cuando aplica).
• Errores por destinatario si los hay.

Ruta B — Cargar y enviar CSV

Usa esto para campañas únicas donde los contactos no están ya en Vouch o la lista es lo suficientemente pequeña para vivir en una hoja de cálculo.

1. Haz clic en Cargar y enviar CSV sobre el formulario.
2. Coloca tu archivo. Misma coincidencia de encabezado tolerante que la importación de contactos. Requerido:
   • email (para canal de correo) o phone (para SMS / WhatsApp)
   • firstName (recomendado)
3. Marca Auto-completar detalles faltantes si quieres que la IA complete espacios en blanco (raramente necesario para envíos — principalmente útil al cargar nuevas ubicaciones, no contactos).
4. Haz clic en Enviar.

Cada fila pasa por:

• Actualización/inserción de contacto (si correo/teléfono coincide con un contacto existente, ese registro se reutiliza; de lo contrario se crea uno nuevo)
• Verificación de política (supresión, consentimiento, límites de frecuencia, horarios de silencio)
• Resolución de plantilla
• Despacho de proveedor

Qué bloquea un envío

Las negativas de política más comunes que verás:

Todos estos aparecen bajo la fila BLOQUEADA en Historial con una explicación de una línea apuntando a la configuración correcta.

Leer la Pestaña de Historial

Abre tu campaña → pestaña Historial. Verás:

• Conteos de estado en la parte superior: X ENVIADO, Y FALLIDO, Z PENDIENTE, W BLOQUEADO.
• Una fila por destinatario, más reciente primero, con:
  • Icono de canal (📧 correo / 💬 sms / 💬 whatsapp)
  • Destinatario (nombre apellido, o correo si el nombre está vacío)
  • Insignia de estado
  • Marca de tiempo de envío
  • Para filas BLOQUEADAS: la razón de política en línea debajo
  • Para filas FALLIDAS: el error del proveedor en línea debajo
• Botón Actualizar — trae las últimas 200 filas.

Significados de estado

Filtrado y exportación

El historial está limitado a las últimas 200 filas en la UI. Para historial completo o exportaciones filtradas usa la API: GET /v1/campaigns/<id>/solicitations?limit=500.

Bandeja: Respuestas, Reseñas y Clasificación

La Bandeja es donde llegan las reseñas y respuestas de clientes. Es el panel único de cristal para "alguien dijo algo — ¿qué hago?"

Qué fluye dentro

• Reseñas — sincronizadas desde Google / Yelp / Facebook por el trabajo de sincronización de reseñas de Vouch (se ejecuta cada hora).
• Respuestas a tus correos/SMS salientes — cuando está configurado, las respuestas llegan a un webhook de vuelta a Vouch y se convierten en elementos de bandeja.
• Envíos de feedback — cuando un cliente completa la página de feedback alojada (típicamente usado para capturar feedback negativo privadamente antes de que se convierta en una reseña pública de 1 estrella).

Vistas de clasificación

• Todos — feed cronológico
• Negativos — marcados por sentimiento (≤3 estrellas o etiquetados negativos por NLP)
• Sin responder — cualquier cosa que no haya recibido una respuesta
• Por ubicación — filtrar a un puesto

Redactar respuestas

Haz clic en cualquier elemento. El panel del lado derecho ofrece:

• Respuesta redactada por IA — Claude lee la reseña + tu voz de marca + configuración de tono + respuestas pasadas similares, luego propone una respuesta. Puedes editar, regenerar con tono diferente o enviar tal cual.
• Respuesta manual — escribe la tuya; la IA ofrece revisión de ortografía y sugerencias de consistencia de voz de marca.
• Notas internas — comentarios privados visibles solo para tu equipo.

Seguimiento de SLA

En Configuración → Reglas SLA puedes definir objetivos de tiempo de respuesta ("todas las reseñas respondidas dentro de 24 horas, negativas dentro de 4"). La bandeja muestra una insignia de reloj junto a elementos acercándose a su SLA, y escala vía webhook (o correo) cuando uno se incumple.

El Asistente IA

Superior izquierda de cada pantalla. Haz clic en el chip Asistente IA (o presiona /) para abrir una barra lateral donde puedes hacer preguntas o iniciar acciones de múltiples pasos. Todo lo visible para tu rol está en alcance.

Qué puede hacer

El Asistente es un coordinador que delega a agentes especialistas:

• Insight de Reputación — "¿Por qué está bajando la puntuación de la ubicación de Austin este mes?". Trae datos de tendencia, resume temas de reseñas recientes.
• Estratega de Campaña — "Sugiere 3 campañas de solicitud de reseña para Q3 basadas en nuestras 5 ubicaciones más lentas". Devuelve borradores listos para lanzar.
• Generador de Plantillas — "Escribe una solicitud de reseña amigable y casual para clientes leales de Panadería Acme". Respeta la voz/tono de la marca.
• Diseñador de Experimentos — "Configura una prueba A/B entre dos líneas de asunto en la campaña de Reseña de Verano". Configura vinculaciones, divisiones, objetivos.
• Crítico de Cumplimiento — "¿Pasará esta plantilla el Modo Seguro para Salud?" Lee plantillas y señala riesgos PHI antes de guardar.
• Copiloto de Operador — atajos operacionales, ej. "Pausa todos los envíos para la ubicación Cherry Creek durante las próximas 48h".
• Optimización — "¿Cuál es nuestra plantilla con mejor desempeño por tasa de respuesta? ¿Deberíamos promoverla a control?".

Cómo elige respuestas

El Asistente usa Claude (Sonnet 4.6) con una paleta de herramientas que incluye la API de Vouch. Cada acción pasa por las mismas verificaciones de autorización que la UI — el agente no puede hacer nada que tú no puedas hacer con tu rol.

Búsqueda web

El agente tiene búsqueda web integrada. Útil para:

• "Encuentra la URL de Yelp de Panadería Acme Brooklyn" (también expuesto como el botón Enriquecer por ubicación)
• "¿Qué dicen los competidores sobre tiempos de espera largos?" — trae reseñas de competidores de fuentes públicas.

Descargos

• El Asistente redacta — no auto-envía. Tu clic es requerido para cualquier cambio de estado.
• Las respuestas redactadas por IA están claramente marcadas como tales en la Bandeja hasta que las edites o aceptes.
• El registro de auditoría captura cada acción iniciada por el Asistente con el razonamiento que dio el modelo.

Aprobaciones, Automatización, Recomendaciones, Experimentos

Cuatro superficies adyacentes en la barra lateral.

Aprobaciones

Cuando Requerir Aprobación está activo, cada nueva plantilla y cambio de campaña va aquí. Los aprobadores ven una cola con diferencias y pueden aprobar / solicitar cambios. Una vez aprobado, la plantilla/campaña entra en vivo.

Automatización

Configuración → Reglas de Automatización te permite construir "cuando X sucede, hacer Y":

• Disparador — reseña entrante (filtrada por calificación / palabra clave), nuevo contacto, hora programada, evento de integración…
• Condiciones — canal, ubicación, sentimiento, etc.
• Acción — enviar una campaña, escalar a bandeja, publicar en Slack, ejecutar un agente IA, empujar a un webhook.

Reglas comunes:

• Auto-responder a reseñas de 5 estrellas con un agradecimiento
• Notificar #canal-reseñas para cualquier reseña de 1 o 2 estrellas
• Disparar la campaña post-visita 2 horas después de un evento de venta PDV

Recomendaciones

La vista Recomendaciones es la cola en ejecución de la IA de "cosas que deberías considerar". Cada elemento tiene un botón aceptar / rechazar. Impulsado por el agente de Optimización — mina patrones de tus datos por la noche y muestra oportunidades ("Plantillas con líneas de asunto de emoji tienen 23% más clics — ¿promover 'Reseña de Verano' a control?").

Experimentos

Superficie de pruebas A/B. Vincula múltiples plantillas a una campaña con diferentes valores de variantKey, define una métrica principal (tasa de apertura, tasa de clics, tasa de conversión de reseña), y Vouch:

• Divide el tráfico por variante
• Rastrea resultados
• Llama a significancia estadística
• Muestra una recomendación cuando una variante gana

El agente Diseñador de Experimentos puede armar esto desde una descripción de una línea.

Referencia de Configuración

Cada configuración vive en Configuración en la barra lateral.

Correo y DKIM — el que más gente hace mal

Para alta entregabilidad necesitas DKIM y DMARC verificados en tu dominio remitente.

1. Configuración → Correo y DKIM.
2. Elige un dominio remitente (ej. mail.acme.com — un subdominio que controles, no acme.com).
3. Vouch te muestra 3 registros DNS para agregar en tu registrador de dominios.
4. Espera 10–60 minutos; haz clic en Verificar.
5. Las insignias de estado junto a DKIM y DMARC se ponen verdes.

Hasta que ambas estén verdes, tus correos funcionarán pero pueden caer en spam más a menudo. No omitas esto.

Preguntas Comunes y Solución de Problemas

"Envié 22 mensajes y 0 salieron — ¿qué pasó?"

Revisa la pestaña Historial. Los conteos de estado te dirán si fueron FALLIDOS, BLOQUEADOS o nunca se crearon.

• 0 creados (sin filas en Historial) → tu lista de contactos estaba vacía, o todas las filas en tu CSV faltaban correo/teléfono. Vuelve a revisar el panel de resultados de Enviar.
• Todos BLOQUEADOS → regla de política. Haz clic en una fila para ver cuál. Más común: horarios de silencio (reenvía después) o falta consentimiento de correo (desactiva el requisito, o importa consentimiento).
• Todos FALLIDOS → problema de proveedor. Haz clic en una fila para el error. Causas comunes: DKIM aún no verificado, discrepancia de dominio remitente, limitación ACS.

"Mi plantilla renderiza {{firstName}} literalmente"

El nombre de la variable está mal. Probablemente escribiste {{first.name}} o {{first name}} — Vouch es generoso con mayúsculas y espacios en blanco ({{ firstName }} funciona) pero la variable tiene que ser uno de los alias reconocidos. Abre el editor de plantillas; la advertencia naranja en la parte superior listará las variables no reconocidas.

"Mi saludo renderiza como Estimado ,"

El contacto no tiene firstName. Tres correcciones (en orden de preferencia):

1. Re-importa contactos con una columna firstName. El estilo del encabezado no importa (First Name / firstName / first_name todos funcionan).
2. Usa un predeterminado en la plantilla: Estimado {{contact.firstName | "cliente"}},
3. Confía en la derivación de nombre del correo (Vouch convierte jane.smith@… en "Jane Smith" automáticamente). No ayudará para buzones genéricos como info@.

"El enlace en mi correo apunta a localhost"

La API se desplegó sin API_BASE_URL establecida. Dile a tu admin de plataforma que redesplegue con la variable de entorno configurada. La corrección es un redespliegue; los correos ya enviados mantendrán su enlace malo.

"Hice clic en Enriquecer y obtuve No hay llave API de Google Places configurada"

Dos opciones:

1. Usa el agente IA — no necesita una llave de Places. Asegúrate de que tu admin de plataforma haya establecido ANTHROPIC_API_KEY en el servicio API. El botón Enriquecer usa IA por defecto cuando la llave está establecida.
2. Configura Google Places — en Configuración → Marca → Sincronización de Reseñas, pega tu llave API de Google Places. Mismo alcance por inquilino que la opción IA.

"Los clientes están recibiendo la misma solicitud de reseña dos veces"

Revisa:

1. La Secuencia de la campaña — si tiene pasos de recordatorio, eso es por diseño (secuencias de múltiples pasos envían 2–4 mensajes durante una semana).
2. Tus Límites de frecuencia en Política de Envío — por defecto 3/día, 5/semana. Baja estos si encuentras la cadencia demasiado alta.
3. Si ejecutaste el mismo envío de campaña dos veces manualmente. La tabla de solicitudes trata cada clic en Enviar como un nuevo intento; el motor de políticas depende del límite de frecuencia para deduplicar.

"Las reseñas no se sincronizan de vuelta a la bandeja"

Tres modos de falla:

1. ID de Google Place falta en la ubicación. El trabajo de sincronización necesita googlePlaceId para consultar la API de Google. Presiona Enriquecer en la ubicación.
2. Llave API de sincronización de reseñas no configurada a nivel marca. Configuración → Marca → Sincronización de Reseñas — pega tu llave de Google Places.
3. El trabajo de sincronización aún no se ha ejecutado. Se ejecuta cada hora. Haz clic en Sincronizar Ahora en la pestaña Reseñas de la ubicación para forzar la ejecución.

"El Asistente IA dice que no puede acceder a algo"

Dos posibilidades:

1. Tu rol no lo otorga. Un tenant_user no puede pausar el inquilino; un tenant_admin sí puede.
2. El agente no tiene una herramienta para eso. Algunas operaciones (como eliminar directamente usuarios) intencionalmente no están expuestas a agentes.

Si es la segunda, pregunta a tu admin de plataforma — pueden otorgar al agente esa capacidad o ejecutar la operación directamente.

"Auto-Buscar Ubicaciones no encontró ninguna ubicación"

Posibles causas:

1. Presencia en línea limitada — negocio muy nuevo o sin sitio web.
2. Nombre de marca demasiado genérico — "Tienda de Pizza" vs "Pizzería de Joe Brooklyn".
3. Sitio web no accesible — detrás de un login o página de construcción.

Soluciones:

1. Agrega una dirección corporativa más completa en la sección Marca.
2. Prueba diferentes variaciones del nombre de marca.
3. Usa el flujo de trabajo Agregar Ubicación + Enriquecer por ubicación en su lugar.
4. Recurre a carga masiva CSV con tu lista interna de ubicaciones.

"Auto-Buscar Ubicaciones encontró ubicaciones incorrectas/inexactas"

Por qué sucede:

• Múltiples negocios con nombres similares en diferentes ciudades.
• Información desactualizada en la web.
• Error de inferencia IA (alucinación).

Soluciones:

1. Revisa recomendaciones antes de aprobar — por eso las ubicaciones pasan por el flujo de trabajo de Recomendaciones primero.
2. Edita detalles en la recomendación antes de aprobar.
3. Rechaza recomendaciones malas y agrega manualmente ubicaciones correctas.
4. Si una cadena tiene cientos de ubicaciones, Auto-Buscar es mejor para encontrar la sede — usa CSV masivo para la lista completa.

"Mi plantilla traducida tiene variables rotas"

No debería suceder — el traductor IA está diseñado para preservar todas las {{variables}} exactamente. Si ves esto:

1. Revisa la plantilla original — ¿estaba la variable malformada allí también?
2. Re-traduce — haz clic en Agregar traducción de nuevo (no duplicará si el locale ya existe; necesitarás eliminar la traducción mala primero).
3. Corrige manualmente la variable en el editor.

Reporta a soporte si la IA rompe variables consistentemente — eso es un bug.

"Las traducciones no se están usando cuando envío"

Revisa:

1. El contacto tiene un campo locale — sin él, Vouch usa por defecto en-US.
2. Existe traducción para ese locale — si el contacto es fr-CA pero solo tienes traducciones en-US y es-MX, obtienen el predeterminado.
3. Vinculación de plantilla de campaña — si elegiste explícitamente un ID de plantilla al enviar (en lugar de auto-resolver), eso sobrescribe el enrutamiento de locale.

Corrección:

• Importa contactos con una columna locale.
• Crea traducciones para todos los locales que necesites.
• Deja que Vouch auto-resuelva la plantilla (no codifiques un ID).

Dónde Obtener Ayuda

• Tooltips en la aplicación — pasa el cursor sobre los iconos ⓘ junto a cualquier campo para orientación en línea.
• Asistente IA — "¿Cómo configuro una campaña de goteo?" a menudo supera leer el manual.
• Registro de auditoría — Configuración → Cumplimiento → Registro de Auditoría muestra todo lo que cualquiera (humano o agente) ha hecho en tu inquilino. Útil cuando algo cambió y no sabes quién lo hizo.
• Soporte — tu contacto de Vouch, o support@<tu-dominio-vouch>.

Bienvenido a Vouch — ve a enviar algunas reseñas.