Agregar comentarios a sitios de 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 del 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 conteo de comentarios
El bloque FastComments - Recuento de comentarios muestra un pequeño recuento de comentarios para una sola página. Úsalo en listas de entradas de blog, fichas de producto o cualquier plantilla que enlace a una página con comentarios, para que los visitantes puedan ver qué tan activo está cada hilo antes de hacer clic.
Añadir el bloque
- Abre el editor de temas de Shopify.
- Abre la plantilla donde quieras que aparezca el recuento. Por ejemplo, la plantilla Blog (la lista de entradas) o una sección de listado de productos.
- Haz clic en Añadir bloque en la sección que muestra cada elemento.
- En Apps, selecciona FastComments - Recuento de comentarios.
- Haz clic en Guardar.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Anula de qué tenant de FastComments se lee el recuento. Déjalo en blanco para usar el tenant configurado automáticamente para la tienda. | (vacío) |
| Custom URL ID | Anula el identificador de página que busca el recuento. Úsalo cuando el recuento esté en una página diferente del bloque FastComments que rastrea. | (detectado automáticamente) |
How the count matches the comment thread
El bloque Recuento de comentarios usa la misma lógica de detección automática que el bloque FastComments:
- Blog post template:
shopify-article-{article.id} - Product template:
shopify-product-{product.id} - Other templates: the request path
Si estableces un Custom URL ID en el bloque FastComments en una página, configura el mismo Custom URL ID en el bloque Recuento de comentarios para que apunten al mismo hilo.
Tips
- Los recuentos de todos los elementos de la página se obtienen en una sola petición, por lo que agregar el bloque a cada elemento de una lista larga no añade coste adicional de ida y vuelta.
- El uso esperado es un bloque Recuento de comentarios por artículo o producto en un listado; 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 enumera 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 quieres 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 debe contenerlo.
- Bajo Apps, selecciona FastComments - Recent Discussions.
- Haz clic en Save.
Configuración
| Configuración | Qué hace | Predeterminado |
|---|---|---|
| Tenant ID (optional) | Sobrescribe el tenant de FastComments del que se lee el feed. Déjalo en blanco para usar el tenant configurado automáticamente de la tienda. | (vacío) |
| Number of comments | Cuántas discusiones recientes mostrar. Rango 1 a 50. | 20 |
Recent Discussions vs Recent Comments
Ambos bloques obtienen datos del mismo origen, pero muestran vistas diferentes:
- Recent Comments: una lista plana de los comentarios individuales más recientes. Lo mejor para "lo que se dijo hace un momento".
- Recent Discussions: una entrada por página, ordenada por la actividad más reciente. Lo mejor 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 las páginas más populares
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 calificación agregada por 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.
Prerequisite: set up Ratings & Reviews
El bloque Reviews Summary muestra las preguntas de valoración que configuraste para tu tienda. Configúralas primero:
- Abre la app FastComments en tu administrador de Shopify.
- Haz clic en el mosaico Ratings & Reviews Helper (o abre Ratings & Reviews Helper directamente).
- Añade las preguntas que quieras que responda cada reseñador (calificación general por estrellas, "cómo te quedó", etc.).
Sin preguntas configuradas, el bloque de resumen no tiene nada que agregar.
Add the block
- 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 la página, por encima de donde irá el bloque FastComments.
- Bajo 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.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Anula de qué tenant de FastComments lee el resumen. Deja en blanco para usar el tenant configurado automáticamente de la tienda. | (en blanco) |
| Custom URL ID | Anula el identificador de página contra el que se agrega el resumen. Úsalo cuando el resumen esté en una página diferente del bloque FastComments al que hace referencia. | (detectado automáticamente) |
How the summary matches the reviews
El bloque Reviews Summary usa la misma lógica de detección automática que el bloque FastComments:
- Product template:
shopify-product-{product.id} - Blog post template:
shopify-article-{article.id} - Other templates: the request path
En una página de producto normal, el resumen y el hilo de comentarios comparten un ID de URL automáticamente, sin necesidad de configuración.
Tips
- 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 haber recopilado reseñas, el resumen se recalcula con el nuevo conjunto de preguntas.
Inicio de sesión automático para clientes de Shopify
El bloque FastComments admite inicio de sesión único (SSO) para que tus clientes de Shopify puedan comentar como ellos mismos sin crear una cuenta separada de FastComments.
How it works
When a visitor who is logged into your store opens a page with the FastComments block:
- The block detects the Shopify
customerobject. - It sends the customer's name and email to FastComments through a signed app proxy request.
- FastComments creates or matches a user keyed by
shopify-{customerId}, so the same customer always maps to the same FastComments user across sessions and re-installs. - The visitor's name shows up on their comments. They are not prompted to log in again.
If the visitor is not logged into the store, the block falls back to anonymous commenting (or the FastComments sign-in flow, depending on your widget configuration).
Turning SSO off
SSO is on by default for every FastComments block. To turn it off on a specific block:
- Open the Shopify theme editor.
- Open the template that contains the block and click the block to select it.
- Uncheck SSO.
- Click Save.
Turn SSO off if you want commenters to choose a separate identity for the conversation. For example, an internal community page where staff comment under a different display name.
What FastComments receives
The SSO payload sent for each customer contains:
- A user ID derived from the Shopify customer ID (
shopify-{customerId}). - The customer's email (used to identify the user; not displayed publicly).
- The customer's display name (used as their comment author name).
No order history, payment, or address data is sent. The payload is signed server-side; the customer's browser never sees a credential.
Login and logout links
When SSO is on, the comment widget's sign-in and sign-out links point at /account/login and /account/logout, the standard Shopify customer account routes. There is nothing to configure. The links work for any store with customer accounts enabled.
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).