Agregar comentarios a sitios Shopify
FastComments está disponible en la Tienda de aplicaciones de Shopify. Instala la aplicación y añade bloques de FastComments a cualquier entrada del blog, página de producto o página personalizada desde el editor de temas de Shopify. No se requiere editar código.
Cuando instalas la aplicación, Shopify crea y configura tu cuenta de FastComments, enlaza el dominio de tu tienda y conecta la facturación automáticamente. No necesitas registrarte por separado en fastcomments.com.
Las páginas de esta guía cubren cada bloque de FastComments que proporciona la aplicación, cómo funciona el inicio de sesión único para tus clientes de Shopify y cómo importar los comentarios existentes de Shopify antes de realizar el cambio.
Instalar la aplicación FastComments 
Instalar desde la Tienda de aplicaciones de Shopify
- Abre el listado de FastComments en la Tienda de aplicaciones de Shopify.
- Haz clic en Add app y elige el plan que quieras durante el flujo de instalación.
- Shopify te redirige de vuelta al administrador de FastComments dentro de Shopify cuando se completa la instalación.
Esa es toda la instalación. No hay nada que pegar en los archivos de tu tema.
Qué se configura por ti
La instalación ejecuta todo lo que, de otro modo, harías a mano:
- Se crea un tenant de FastComments para tu tienda y se vincula a tu dominio de tienda.
- La URL de la tienda se agrega a los dominios autorizados del tenant, para que los comentarios se carguen sin error de dominio.
- Se escribe un metafield de tienda
fastcomments.tenant_idpara que cada bloque sepa contra qué tenant debe renderizarse. - El inicio de sesión único para tus clientes de Shopify se habilita por defecto.
- La facturación se realiza a través de los Precios gestionados por Shopify. Los cargos aparecen en tu factura habitual de Shopify. Actualiza, degrada o cancela desde Configuración > Aplicaciones y canales de venta > FastComments en tu administrador de Shopify.
Si tu tienda ya era cliente de FastComments antes de instalar la app, la instalación reutiliza el tenant existente en lugar de crear uno nuevo.
El administrador integrado
Cuando abres la app de FastComments desde tu administrador de Shopify, llegas a un panel con mosaicos de un solo clic hacia el backend completo de FastComments:
- Panel: ajustes de cuenta, uso y detalles de suscripción.
- Cola de moderación: aprobar, rechazar y responder comentarios en toda tu tienda.
- Personalizar: ajustar colores del widget, fuentes, reglas de moderación y configuración.
- Asistente de calificaciones y reseñas: configurar valoraciones con estrellas y preguntas de reseña si deseas usar el bloque Resumen de reseñas.
Cada mosaico abre FastComments con un enlace de inicio de sesión de un solo uso, por lo que no necesitas una sesión separada.
Siguiente: agrega bloques a tu tienda
Abre el editor de temas de Shopify (Tienda online > Temas > Personalizar), abre la plantilla a la que quieres añadir comentarios o reseñas, y haz clic en Add block. Los bloques de FastComments aparecen bajo Aplicaciones. El resto de esta guía cubre cada uno.
Agregar comentarios a publicaciones de blog y productos
El FastComments block es el widget principal de comentarios. Agrégalo a las plantillas de entradas del blog, plantillas de producto o cualquier otra página donde quieras un hilo de discusión o un chat en vivo.
Agregar el bloque
- Abre el editor de temas de Shopify (Tienda online > Temas > Personalizar).
- Elige la plantilla en la que quieres que aparezcan los comentarios: Entrada de blog, Producto, o cualquier otra plantilla de página o sección.
- En la sección donde quieres que aparezcan los comentarios, haz clic en Agregar bloque.
- Bajo Apps, selecciona FastComments.
- Haz clic en Guardar.
El bloque aparece de inmediato. No hay un Tenant ID que introducir; el tenant de tu tienda se configura automáticamente cuando instalas la aplicación.
Configuración
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Anula con qué tenant de FastComments procesa el bloque. Déjalo en blanco para usar el tenant configurado automáticamente de la tienda. Encuentra un manual tenant ID en fastcomments.com/auth/my-account/api-secret. | (vacío) |
| SSO | Inicia sesión automáticamente al visitante como su cuenta de cliente de Shopify antes de comentar. Ver Inicio de sesión automático de clientes de Shopify. | Activado |
| Commenting Style | Threaded para respuestas anidadas y votos, o Streaming para un feed de chat en tiempo real. | Threaded |
| Custom URL ID | Anula el identificador de página detectado automáticamente. Úsalo cuando quieras que dos URL compartan un mismo hilo de comentarios. | (detectado automáticamente) |
Cómo se elige el identificador de la página
Cada hilo de comentarios está identificado por un URL ID. El bloque selecciona uno automáticamente:
- Plantilla de entrada de blog:
shopify-article-{article.id}, que es estable frente a cambios en el slug y el título. - Plantilla de producto:
shopify-product-{product.id}, que es estable frente a cambios en el slug y el título. - Otras plantillas: la ruta de la petición.
Si configuras Custom URL ID, se usará ese valor en su lugar. Usa el mismo Custom URL ID en varios bloques (por ejemplo, en una variante localizada de una página de producto) para compartir un solo hilo de comentarios.
Threaded vs Streaming
Threaded es el valor predeterminado. Los visitantes se responden entre sí, votan y las herramientas de moderación funcionan como se espera. Es ideal para entradas de blog y reseñas de productos.
Streaming elimina el threading y muestra los comentarios nuevos en tiempo real a medida que se publican, como un feed de chat. Es ideal para lanzamientos de producto, eventos en vivo y páginas comunitarias.
Múltiples bloques en la misma página
El bloque se puede añadir más de una vez a la misma plantilla. Por ejemplo, un resumen de reseñas en la parte superior de una página de producto y un bloque FastComments en la parte inferior. Los bloques comparten un URL ID, por lo que el resumen refleja los comentarios de abajo.
Consejos
- El bloque se oculta en la vista previa del editor de temas con un aviso amarillo si no encuentra un tenant. Si eso aparece en tu tienda en vivo, reinstala la aplicación FastComments.
- Para una página de producto, el bloque FastComments funciona también como tu widget de reseñas de producto. Combínalo con FastComments - Reviews Summary para un resumen de calificaciones con estrellas en la parte superior de la página.
Agregar una insignia de recuento de comentarios
El bloque FastComments - Comment Count muestra un pequeño contador de comentarios para una sola página. Úsalo en listas de entradas de blog, tarjetas de producto o cualquier plantilla que enlace a una página con comentarios, para que los visitantes puedan ver la actividad de cada hilo antes de hacer clic.
Añadir el bloque
- Abre el editor de temas de Shopify.
- Abre la plantilla donde quieres que aparezca el contador. Por ejemplo, la plantilla Blog (la lista de entradas) o una sección de listado de productos.
- Haz clic en Add block en la sección que muestra cada elemento.
- En Apps, selecciona FastComments - Comment Count.
- Haz clic en Save.
Ajustes
| Ajuste | Qué hace | Valor por defecto |
|---|---|---|
| Tenant ID (opcional) | Sobrescribe de qué tenant de FastComments lee el contador. Déjalo en blanco para usar el tenant configurado automáticamente de la tienda. | (en blanco) |
| Custom URL ID | Sobrescribe el identificador de página que busca el contador. Úsalo cuando el contador esté en una página diferente al bloque de FastComments que rastrea. | (detectado automáticamente) |
Cómo el contador coincide con el hilo de comentarios
El bloque Comment Count usa la misma lógica de detección automática que el bloque FastComments:
- Plantilla de entrada de blog:
shopify-article-{article.id} - Plantilla de producto:
shopify-product-{product.id} - Otras plantillas: la ruta de la solicitud
Si estableces un Custom URL ID en el bloque FastComments de una página, establece el mismo Custom URL ID en el bloque Comment Count para que apunten al mismo hilo.
Consejos
- Los contadores de todos los elementos de la página se obtienen en una sola solicitud, por lo que añadir el bloque a cada elemento de una lista larga no tiene coste adicional de ida y vuelta.
- Un bloque Comment Count por artículo o producto en un listado es el uso esperado; el bloque puede añadirse tantas veces como necesites.
Agregar un feed de comentarios recientes
The FastComments - Recent Comments block muestra los comentarios más recientes de toda tu tienda. Úsalo para mostrar actividad reciente en una barra lateral, pie de página o sección de la página de inicio.
Añadir el bloque
- Abre el editor de temas de Shopify.
- Abre la plantilla donde quieres el feed. Una sección de barra lateral, la página de inicio o el índice del blog funcionan bien.
- Haz clic en Add block en la sección que debe contenerlo.
- Bajo Apps, selecciona FastComments - Recent Comments.
- Haz clic en Save.
Configuración
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Anula de qué tenant de FastComments proviene el feed. Déjalo en blanco para usar el tenant configurado automáticamente para la tienda. | (vacío) |
| Number of comments | Cuántos comentarios recientes mostrar. Rango de 1 a 50. | 5 |
Consejos
- Cada comentario enlaza a la página donde se publicó, por lo que el bloque también funciona como una pista de navegación de "sobre qué está hablando la gente ahora".
- El feed abarca toda la tienda. Para mostrar comentarios recientes de una sola página, usa el bloque FastComments en esa página en su lugar.
Agregar un feed de discusiones recientes
El bloque FastComments - Recent Discussions muestra las páginas de tu tienda con la actividad de comentarios más reciente, una entrada por página. Úsalo cuando quieras que los visitantes descubran hilos activos en lugar de comentarios individuales.
Añadir el bloque
- Abre el editor de temas de Shopify.
- Abre la plantilla donde quieras el feed, como una barra lateral, el pie de página, el índice del blog o una sección de la página de inicio.
- Haz clic en Add block en la sección que deba contenerlo.
- En Apps, selecciona FastComments - Recent Discussions.
- Haz clic en Save.
Configuración
| Configuración | Qué hace | Valor predeterminado |
|---|---|---|
| Tenant ID (opcional) | Permite sobrescribir de qué tenant de FastComments lee el feed. Déjalo en blanco para usar el tenant configurado automáticamente para la tienda. | (vacío) |
| Number of comments | Cuántas discusiones recientes mostrar. Rango de 1 a 50. | 20 |
Recent Discussions vs Recent Comments
Ambos bloques obtienen los mismos datos, pero muestran vistas diferentes:
- Recent Comments: una lista plana de los últimos comentarios individuales. Ideal para "qué se acaba de decir".
- Recent Discussions: una entrada por página, ordenada por la actividad más reciente. Ideal para "qué hilos están activos ahora mismo".
Puedes usar ambos en la misma tienda. Por ejemplo, Recent Comments en la barra lateral del blog y Recent Discussions en la página de inicio.
Agregar una lista de páginas principales
El bloque FastComments - Top Pages muestra las páginas de tu tienda con más actividad de comentarios en general. Úsalo para destacar tus publicaciones o productos más comentados.
Agregar el bloque
- Abre el editor de temas de Shopify.
- Abre la plantilla donde quieras la lista, como una barra lateral, el pie de página o la sección de índice de blog.
- Haz clic en Add block en la sección que debería contenerlo.
- Under Apps, selecciona FastComments - Top Pages.
- Haz clic en Save.
Configuración
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
| Tenant ID (opcional) | Anula de qué tenant de FastComments lee la lista. Déjalo en blanco para usar el tenant configurado automáticamente de la tienda. | (vacío) |
Top Pages vs Recent Discussions
- Top Pages ordena por el engagement total, por lo que las mismas publicaciones tienden a permanecer en la parte superior durante un tiempo. Bueno para una barra lateral de "publicaciones populares".
- Recent Discussions ordena por la actividad más reciente, por lo que la lista cambia con frecuencia. Bueno para un panel de "lo que está de moda ahora".
Agregar un resumen de reseñas
El bloque FastComments - Reviews Summary muestra una valoración media de estrellas y un desglose de reseñas para una página. Combínalo con el bloque FastComments en las plantillas de producto para el diseño estándar de reseñas: resumen arriba, formulario de reseñas y reseñas abajo.
Requisito previo: configurar Ratings & Reviews
El bloque Reviews Summary muestra las preguntas de valoración que configuraste para tu tienda. Configúralas primero:
- Abre la aplicación FastComments en tu administrador de Shopify.
- Haz clic en el mosaico Ratings & Reviews Helper (o abre directamente Ratings & Reviews Helper).
- Añade las preguntas que quieres que responda cada reseñador (valoración general de estrellas, "cómo fue el ajuste", etc.).
Sin preguntas configuradas, el bloque de resumen no tiene nada que agregar.
Añadir el bloque
- Abre el editor de temas de Shopify.
- Abre la plantilla Product (o la plantilla de página donde quieras el resumen).
- Haz clic en Add block cerca de la parte superior de la sección de página, por encima de donde estará el bloque FastComments.
- En Apps, selecciona FastComments - Reviews Summary.
- Añade un bloque FastComments más abajo en la misma página si aún no lo has hecho, para que los visitantes puedan dejar reseñas.
- Haz clic en Save.
Ajustes
| Ajuste | Qué hace | Valor predeterminado |
|---|---|---|
| Tenant ID (opcional) | Sobrescribe de qué tenant de FastComments lee el resumen. Déjalo en blanco para usar el tenant configurado automáticamente de la tienda. | (en blanco) |
| Custom URL ID | Sobrescribe el identificador de página contra el que agrega el resumen. Úsalo cuando el resumen esté en una página diferente al bloque FastComments que refleja. | (detectado automáticamente) |
Cómo el resumen coincide con las reseñas
El bloque Reviews Summary usa la misma lógica de detección automática que el bloque FastComments:
- Plantilla de producto:
shopify-product-{product.id} - Plantilla de entrada de blog:
shopify-article-{article.id} - Otras plantillas: la ruta de la solicitud
En una página de producto normal, el resumen y el hilo de comentarios comparten automáticamente un URL ID, sin necesidad de configuración.
Consejos
- El resumen es de solo lectura. Para recopilar reseñas, necesitas un bloque FastComments en la misma página.
- Si cambias las preguntas de valoración en Ratings & Reviews Helper después de recopilar reseñas, el resumen se recalcula con el nuevo conjunto de preguntas.
Inicio de sesión automático para clientes de Shopify
El bloque de FastComments admite el inicio de sesión único (SSO) para que tus clientes de Shopify puedan comentar como ellos mismos sin necesidad de crear una cuenta de FastComments separada.
Cómo funciona
Cuando un visitante que ha iniciado sesión en tu tienda abre una página con el bloque de FastComments:
- El bloque detecta el objeto
customerde Shopify. - Envía el nombre y el correo electrónico del cliente a FastComments a través de una solicitud firmada de app proxy.
- FastComments crea o encuentra un usuario identificado por
shopify-{customerId}, de modo que el mismo cliente siempre se corresponde con el mismo usuario de FastComments entre sesiones y reinstalaciones. - El nombre del visitante aparece en sus comentarios. No se le solicita iniciar sesión de nuevo.
Si el visitante no ha iniciado sesión en la tienda, el bloque recurre a los comentarios anónimos (o al flujo de inicio de sesión de FastComments, dependiendo de la configuración de tu widget).
Desactivar SSO
SSO está activado por defecto en cada bloque de FastComments. Para desactivarlo en un bloque específico:
- Abre el editor de temas de Shopify.
- Abre la plantilla que contiene el bloque y haz clic en el bloque para seleccionarlo.
- Desmarca SSO.
- Haz clic en Guardar.
Desactiva SSO si quieres que los comentaristas elijan una identidad separada para la conversación. Por ejemplo, una página de comunidad interna donde el personal comenta con un nombre para mostrar diferente.
Qué recibe FastComments
La carga de SSO enviada para cada cliente contiene:
- Un ID de usuario derivado del ID del cliente de Shopify (
shopify-{customerId}). - El correo electrónico del cliente (usado para identificar al usuario; no se muestra públicamente).
- El nombre para mostrar del cliente (usado como su nombre de autor de comentario).
No se envía ningún historial de pedidos, datos de pago ni de dirección. La carga está firmada en el servidor; el navegador del cliente nunca ve una credencial.
Enlaces de inicio y cierre de sesión
Cuando SSO está activado, los enlaces de inicio y cierre de sesión del widget de comentarios apuntan a /account/login y /account/logout, las rutas estándar de cuentas de cliente de Shopify. No hay nada que configurar. Los enlaces funcionan en cualquier tienda con cuentas de cliente habilitadas.
Importar comentarios existentes
Si ya tienes comentarios en las entradas de tu blog de Shopify y quieres conservarlos, impórtalos a FastComments antes de desactivar los comentarios nativos de Shopify.
La importación debe ejecutarse mientras los comentarios nativos de Shopify sigan activos y visibles. Una vez que los desactives, FastComments ya no podrá leerlos.
Cómo iniciar una importación
- Asegúrate de que la aplicación FastComments esté instalada en tu tienda.
- Deja los comentarios nativos de Shopify habilitados por ahora.
- Abre un ticket de soporte e indícanos qué blogs importar.
La importación se completa en menos de un día.
Una vez que tus comentarios existentes estén en FastComments, añade el bloque FastComments a la plantilla de tus entradas del blog y elimina o desactiva los comentarios nativos de Shopify. Consulta Añadir comentarios a entradas de blog y productos.
Si no necesitas conservar los comentarios existentes, puedes omitir esta página.
Personalización
Los colores, las fuentes, las reglas de moderación, el HTML permitido y los comentarios anónimos se pueden configurar para que coincidan con la imagen de marca de tu tienda.
Abre la app FastComments en el administrador de Shopify y haz clic en el mosaico Personalizar para abrir la pantalla de personalización del widget. Usa un enlace de inicio de sesión de un solo uso, por lo que no necesitas un inicio de sesión separado.
Para ver la lista completa de opciones de personalización, consulta la Guía de personalización y configuración.
Errores de dominio
Si instalaste FastComments desde la Shopify App Store, el dominio de tu tienda se añade automáticamente a los dominios autorizados del tenant y no deberías ver un error de dominio. Esta página se aplica si seguiste la ruta de instalación manual, o si tu tienda se sirve en un dominio personalizado que no estaba registrado con Shopify en el momento en que se instaló la aplicación.
Puedes recibir un error de autorización como el siguiente:
Esto significa que FastComments no reconoce el dominio en el que se está cargando el widget como autorizado para tu tenant.
Para solucionarlo, añade el dominio a tu cuenta de FastComments: Configurar dominios.
Instalación manual (avanzada)
Si no puedes instalar la aplicación de Shopify App Store, aún puedes añadir FastComments editando tu tema. Esta vía es útil cuando quieres conectar un tenant de FastComments que ya posees, o cuando estás insertando en una tienda de Shopify donde la aplicación no es una opción.
La instalación mediante la app es la vía recomendada para la mayoría de tiendas. Recurre a esto solo si la app no encaja.
Paso 1: Desactivar los comentarios nativos de Shopify
En tu administrador de Shopify, ve a Entradas del blog > Administrar blogs, abre cada blog y configura Los comentarios están desactivados en el panel derecho. Guardar.
Esto evita que el sistema de comentarios integrado de Shopify se muestre junto a FastComments.
Paso 2: Abre la plantilla del tema del blog
En tu administrador de Shopify:
- Ve a Tienda online > Temas.
- Bajo tu tema actual, haz clic en Acciones > Editar código.
- En el explorador de archivos a la izquierda, abre Sections y haz clic en
main-article.liquid.
Esta es la plantilla que Shopify renderiza para un solo artículo del blog.
Paso 3: Pega el fragmento de FastComments
Desplázate hasta aproximadamente la línea 100 de main-article.liquid, justo después del cierre </div> del cuerpo del artículo. Pega el siguiente fragmento:
Reemplaza "demo" con tu propio Tenant ID desde fastcomments.com/auth/my-account/api-secret. Haz clic en Guardar.
Paso 4: Autoriza el dominio de tu tienda
Abre una entrada del blog en tu tienda en vivo. Si ves un error de autorización en lugar del widget de comentarios, FastComments necesita saber que tu tienda tiene permiso para usar este tenant. Consulta Errores de dominio.
Añadir FastComments a otras páginas
El mismo fragmento funciona en cualquier plantilla Liquid, incluidas las páginas de producto, páginas personalizadas y la página de inicio. Pégalo donde quieras que aparezcan los comentarios y ajusta urlId si quieres un identificador estable por página (por ejemplo, urlId: "{{ product.id }}" en una plantilla de producto).
Agregar encuestas a tu tienda Shopify
Una vez que FastComments está en tu tienda Shopify, también puedes ejecutar encuestas en vivo directamente en los comentarios. Activa Enable Polls en la configuración de personalización de tu widget y aparecerá un botón de encuesta en la barra de herramientas de los comentarios. Las encuestas admiten de 2 a 10 opciones, los resultados se actualizan en tiempo real para todos en la página, y tú decides quién puede crear encuestas y si votar requiere iniciar sesión. No hay nada más que instalar en Shopify.
Prueba la demostración de encuestas en vivo o lee la documentación de encuestas para configurarlas.