Este artículo reúne respuestas rápidas a las dudas más habituales sobre la instalación, configuración, funcionamiento y resolución de problemas de Brilliant.
Instalación y acceso
-
¿Cómo instalo Brilliant en mi tienda?
Puedes instalar Brilliant a través de la Shopify App Store.
-
¿Dónde puedo instalar Brilliant?
Puedes instalar Brilliant en cualquier tienda que utilice la plataforma Shopify.
-
¿Qué permisos solicita la app durante la instalación?
Brilliant solicita únicamente los permisos necesarios para analizar tu catálogo y ofrecer recomendaciones precisas:
-
read_inventory: Para leer el inventario de tus productos. -
read_locales: Para conocer los idiomas disponibles en tu tienda. -
read_publications: Para ver dónde están publicados los productos (canales). -
read_translations: Para ver las traducciones de los productos. -
read_themes: Para leer el estado de activación de Brilliant en el tema actual. -
read_content: Para leer los blogs y páginas de tu tienda y usarlos como base de conocimiento del asistente. -
read_online_store_navigation: Para entender cómo se organizan y categorizan tus productos en la navegación de tu tienda. -
read_orders: Para que el asistente pueda responder a tus clientes sobre el estado y el seguimiento de sus pedidos. -
write_markets: Para añadir metadatos a los mercados. -
write_products: Para añadir metadatos a los productos. -
write_metaobject_definitions: Para crear definiciones de metaobjetos. -
write_metaobjects: Para crear o editar los metaobjetos necesarios por Brilliant.
-
-
¿Por qué Brilliant me pide aprobar nuevos permisos si ya tenía la app instalada?
Algunas funcionalidades nuevas, como la sincronización de blogs y páginas o la consulta de pedidos, requieren permisos adicionales.
Si instalaste Brilliant antes de que estas funcionalidades estuvieran disponibles, verás un aviso en el panel con los nuevos permisos solicitados y su finalidad.
Haz clic en Continuar en Shopify para acceder a Shopify, revisar los permisos y aceptarlos. Hasta que no los apruebes, las funcionalidades que los requieren no estarán disponibles.
-
¿Cómo sé si la instalación se ha completado correctamente?
Al finalizar el proceso en Shopify, accederás al panel de control de Brilliant, donde un asistente de bienvenida te guiará durante los primeros pasos.
En primer lugar, deberás activar Brilliant Control Center en el tema de tu tienda.
-
¿Cómo activo Brilliant en mi tema de Shopify?
En el asistente de bienvenida, haz clic en Activar en Shopify. Accederás al editor de temas con Brilliant Control Center activado.
Haz clic en Guardar y vuelve a Brilliant para continuar con la instalación.
Esta configuración solo es necesaria una vez y permite que el asistente pueda mostrarse en tu tienda. Tus clientes no verán Brilliant hasta que lo actives desde su panel.
-
¿Cómo sé que mi tienda está lista?
Una vez activado Brilliant Control Center en el tema, Brilliant comenzará a importar y procesar automáticamente tu catálogo
En Inicio, verás el mensaje "Estamos preparando tu tienda" y una barra con el progreso de los productos procesados.
Cuando finalice el procesamiento, aparecerá el mensaje "¡Brilliant ya está listo para activarse en tu tienda!" y podrás hacer clic en Activar Brilliant.
-
¿Puedo probar Brilliant antes de que lo vean mis clientes?
Sí. Desde Inicio, haz clic en Vista previa para abrir tu tienda y probar el asistente.
Durante la vista previa, solo tú podrás ver Brilliant. Tus clientes no lo verán hasta que lo actives.
La vista previa estará disponible cuando el catálogo haya terminado de procesarse y requiere que Brilliant esté activo en el tema de Shopify.
-
¿Cómo activo o desactivo Brilliant en mi tienda?
Desde Inicio, utiliza Activar Brilliant o Desactivar Brilliant.
Si lo desactivas, el asistente dejará de mostrarse en tu tienda, pero conservarás toda su configuración y podrás volver a activarlo cuando quieras.
-
¿Puedo usar Brilliant en varias tiendas?
Sí, puedes instalar Brilliant en todas las tiendas Shopify que gestiones de forma independiente.
Idiomas, mercados y monedas
-
¿Tengo que crear un agente por cada idioma y moneda?
No. Brilliant funciona de forma unificada para toda tu tienda, por lo que no necesitas crear agentes independientes para cada combinación de idioma y moneda.
La configuración de diseño, habilidades, entrenamiento y gestión de productos se realiza una sola vez y se aplica a toda la tienda.
-
¿En qué mercados se muestra Brilliant?
Brilliant detecta automáticamente los mercados configurados en Shopify y se muestra en todos los que estén activos.
Si creas, modificas o eliminas un mercado en Shopify, Brilliant se actualizará automáticamente.
-
¿En qué idioma responde Brilliant a mis clientes?
Brilliant adapta sus respuestas al idioma de cada cliente y utiliza las traducciones de los productos configuradas en Shopify.
Si añades o eliminas idiomas en tu tienda, Brilliant los detectará automáticamente.
-
¿Muestra Brilliant los precios en la moneda de cada mercado?
Sí. Brilliant muestra los productos y sus precios en la moneda correspondiente al mercado desde el que navega cada cliente.
-
¿Tengo que configurar Brilliant en cada idioma?
No. Puedes completar el entrenamiento de Brilliant en tu idioma.
El asistente adaptará sus respuestas al idioma de cada conversación, por lo que no necesitas añadir el mismo contenido en varios idiomas.
Catálogo y gestión de productos
-
¿Cuánto tiempo tarda Brilliant en procesar el catálogo?
El procesamiento inicial mediante Brilliant puede tardar desde unos minutos hasta varias horas, dependiendo del tamaño de tu catálogo.
Puedes consultar su progreso desde Inicio.
-
¿Qué hace Brilliant con mi catálogo durante el procesamiento?
Brilliant importa tus productos desde Shopify y los enriquece mediante inteligencia artificial.
Durante este proceso, categoriza los productos, genera descripciones y destacados, prepara preguntas frecuentes, identifica productos en las imágenes y calcula packs y combinaciones. También genera sugerencias de búsqueda basadas en tu catálogo.
-
¿Qué pasa si añado, modifico o elimino productos en Shopify?
Brilliant se sincroniza automáticamente con el catálogo de Shopify.
Los productos nuevos, las modificaciones y las eliminaciones se reflejarán en Brilliant sin que tengas que volver a importar el catálogo.
-
¿Qué productos muestra Brilliant?
Brilliant muestra únicamente los productos que están activos y publicados en tu ecommerce.
También puedes excluir determinados productos mediante la lista negra.
-
¿Puedo editar la taxonomía (estructura del catálogo) que la IA crea automáticamente?
Si. Desde "Configuración > Estructura del catálogo" puedes modificar los nombres de las categorías y las etiquetas de los atributos, como el color o la talla.
-
¿Puedo indicar las novedades de mi catálogo?
Si. Desde "Configuración > Estructura del catálogo" puedes añadir las etiquetas de Shopify que identifican tus productos nuevos.
Los productos que contengan alguna de estas etiquetas se mostrarán en la pantalla de inicio de Brilliant.
-
¿Puedo destacar productos de mi catálogo?
Si. Desde "Configuración > Estructura del catálogo" puedes añadir las etiquetas de los productos que quieras destacar.
Los productos que contengan alguna de estas etiquetas aparecerán en primera posición en los resultados de búsqueda.
-
¿Puedo excluir productos de mi catálogo?
Si. Desde "Configuración > Estructura del catálogo" puedes añadir a la lista negra las etiquetas de los productos que quieras excluir de Brilliant.
Los productos con estas etiquetas no aparecerán en las búsquedas ni en las recomendaciones, y Brilliant tampoco podrá interactuar con ellos en tu tienda.
-
¿Puedo usar mis metacampos (metafields) de Shopify?
Si. Brilliant utiliza automáticamente la información básica de tus productos, como el título o la descripción.
Además, desde "Entrena tu IA > Metadatos" puedes seleccionar los metacampos adicionales que Brilliant tendrá en cuenta para mejorar sus respuestas y recomendaciones.
Solo se mostrarán los tipos de metacampos compatibles.
Entrena tu IA
-
¿Cómo puedo enseñarle a Brilliant información sobre mi tienda?
Desde "Entrena tu IA > Base de conocimiento" puedes añadir información que Brilliant utilizará para responder a tus clientes, como políticas de envío y devoluciones, guías de tallas o preguntas frecuentes.
Puedes añadir:
- Textos: información escrita directamente en el panel.
- URLs: páginas web cuyo contenido analizará Brilliant. Puedes configurar un nuevo rastreo diario, semanal o desactivarlo.
- Archivos: documentos TXT, DOCX, MD o PDF de hasta 5 MB.
Puedes añadir hasta cinco contenidos de cada tipo. Los cambios pueden tardar unos minutos en reflejarse en el asistente.
-
¿Puede Brilliant usar los blogs y páginas de mi tienda Shopify?
Sí. Desde las pestañas Blogs y Páginas de la base de conocimiento puedes seleccionar hasta 50 artículos de blog y 50 páginas de tu tienda
Brilliant sincronizará automáticamente estos contenidos para utilizarlos en sus respuestas.
-
¿Qué significa que un contenido de la base de conocimiento tenga estado “Error”?
Significa que Brilliant no ha podido procesarlo. Esto puede ocurrir, por ejemplo, si una URL ya no existe, requiere iniciar sesión o apunta a un archivo que Brilliant no puede leer, como una imagen o un vídeo.
Pasa el cursor sobre el estado para consultar el motivo del error. Después, puedes corregir la entrada o utilizar Reintentar procesamiento.
-
¿Puedo definir cómo se comporta y responde Brilliant?
Sí. Desde "Entrena tu IA > Comportamiento" puedes configurar:
- Directrices: añade hasta 10 instrucciones para definir el tono y el estilo de Brilliant, así como aquello que debe o no debe hacer.
- Estilo de respuesta: selecciona la extensión de las respuestas “concisa”, “equilibrada” o “detallada” y su formato “sencillo”, “estructurado” o “enriquecido”.
-
¿Para qué sirve el perfil del negocio?
Desde "Entrena tu IA > Perfil del negocio" puedes indicar qué vende tu tienda, a qué público se dirige y cuál es tu sector.
Esta información proporciona a Brilliant más contexto sobre tu negocio y tus clientes para adaptar sus recomendaciones y respuestas.
Habilidades y diseño
-
¿Qué habilidades ofrece Brilliant?
Desde Habilidades puedes consultar y gestionar las capacidades del asistente:
- Búsqueda inteligente: interpreta el lenguaje natural del cliente y muestra los productos más relevantes.
- Análisis de productos: responde preguntas sobre las características, materiales y usos de los productos.
- Productos similares: muestra alternativas similares en estilo o características.
- Productos que combinan: recomienda productos complementarios.
- Packs de productos: propone combinaciones de productos en packs.
- Comparativa: compara varios productos para ayudar al cliente durante su decisión.
- Buscar por imagen: permite subir una imagen y encontrar productos similares o combinaciones.
- Productos en imágenes del catálogo: permite seleccionar elementos visibles en las imágenes de tus productos.
- Preguntar por mi pedido: permite al cliente consultar el estado, seguimiento y detalles de sus pedidos.
Las habilidades Búsqueda inteligente y Análisis de productos son necesarias para el funcionamiento del asistente y no pueden desactivarse.
-
¿Puedo mostrar carruseles o preguntas sugeridas en mis páginas de producto?
Sí. Desde el editor de temas de Shopify puedes añadir los siguientes bloques de Brilliant a tus páginas de producto:
- Carrusel de productos similares.
- Carrusel de productos que combinan.
- Preguntas del producto.
Desde Habilidades también puedes hacer clic en Añadir en Shopify o Editar en Shopify para gestionarlos.
-
¿Puedo cambiar la posición de la burbuja del asistente?
Sí. Desde el editor de temas de Shopify, en Brilliant Control Center, puedes configurar la posición de la burbuja principal, sus márgenes y el z-index.
También puedes utilizar una configuración diferente para dispositivos móviles, activar un mensaje de bienvenida junto a la burbuja y configurar la burbuja que aparece sobre las tarjetas de producto.
-
¿Puedo personalizar el aspecto de Brilliant?
Sí. Desde Diseño puedes adaptar Brilliant a la identidad visual de tu marca configurando:
- Colores: define tu color primario para generar la paleta.
- Botones: radio del borde y transformación del texto
- Logo: sube el logo de tu tienda (PNG, JPG, JPEG, WebP o SVG, hasta 5 MB).
- Íconos: elige o sube el icono de la burbuja principal y de la burbuja de producto (SVG o PNG, hasta 500 KB).
- Tarjeta de producto: proporción de la imagen, forma de visualizarla, radio del borde y contorno.
Suedes consultar en la vista previa cómo se mostrarán los cambios en las diferentes pantallas del asistente. Cuando actives Brilliant, la fuente se adaptará automáticamente a la de tu tienda.
Analítica y conversaciones
-
¿Cómo puedo medir el impacto de Brilliant en mis ventas?
Desde Analítica puedes consultar métricas sobre el rendimiento de Brilliant, como las compras asistidas frente al total de tu tienda, la tasa de conversión, el ticket medio, el ROI, el embudo de compras o las conversaciones por dispositivo.
También puedes consultar qué elementos de Brilliant, como las burbujas, carruseles o preguntas sugeridas, generan más interacción.
-
¿Puedo conectar Brilliant con Google Analytics?
Sí. Desde “Configuración > Google Analytics” puedes habilitar la integración e introducir tu ID de Google Analytics para medir el rendimiento de Brilliant en tu tienda.
-
¿En qué idioma responde Brilliant a mis clientes?
Sí. Desde Inicio, en la tarjeta “Conversaciones de chat”, puedes consultar el número de conversaciones totales, de la última semana y del último día.
Haz clic en Descargar chats para descargar las conversaciones.
-
¿Muestra Brilliant los precios en la moneda de cada mercado?
Sí. Brilliant muestra los productos y sus precios en la moneda correspondiente al mercado desde el que navega cada cliente.
Plan y límites
-
¿Qué incluye mi plan?
Puedes consultar el uso de tu plan desde Inicio, en la tarjeta “Uso del plan”.
Cada plan incluye un número máximo de productos en el catálogo y de conversaciones al mes.
-
¿Qué pasa si alcanzo el límite de conversaciones?
Brilliant dejará de mostrarse en tu tienda hasta que se restablezca el límite.
El contador de conversaciones se reinicia automáticamente al principio de cada mes. En la tarjeta “Uso del plan” de Inicio puedes consultar los días restantes hasta el siguiente reinicio.
-
¿Qué pasa si mi catálogo supera el límite de productos de mi plan?
Brilliant mostrará un aviso en el panel indicando que tu tienda necesita un plan más avanzado.
Desde ese mismo aviso podrás solicitar acceso prioritario a los planes disponibles para catálogos más grandes.
Soporte y recursos adicionales
-
Brilliant no aparece en mi tienda, ¿qué puedo revisar?
Comprueba que:
- Brilliant Control Center está activado y los cambios están guardados en el tema publicado de Shopify.
- Brilliant está activado desde Inicio.
- El catálogo ha terminado de procesarse.
- No has alcanzado el límite de conversaciones de tu plan.
- El cliente está navegando desde un mercado activo de tu tienda.
Si has comprobado estos puntos y Brilliant sigue sin aparecer, contacta con Soporte.
-
¿Dónde puedo contactar con soporte?
Puedes escribirnos directamente a support@getbrilliant.ai para cualquier duda técnica o de configuración.
¿Quieres saber más?