Cómo crear un chatbot de FlowHunt AI para Shopify

Esta guía te lleva paso a paso para conectar FlowHunt con tu tienda de Shopify, añadir un flujo de chatbot preconstruido para Shopify, publicarlo e incrustar el chatbot en tu escaparate.

Requisitos previos

• Una tienda de Shopify con acceso de administrador
• Una cuenta de FlowHunt con acceso al workspace: https://app.flowhunt.io/
• Importante: Usa el mismo correo electrónico en tu cuenta de FlowHunt y en tu cuenta de administrador de Shopify.

1) Integra Shopify con FlowHunt (a través de la Shopify App Store)

1. Abre la Shopify App Store y busca “FlowHunt”.
2. Haz clic en Instalar y, si se solicita, selecciona la tienda correcta.
3. Revisa los permisos solicitados y haz clic en Instalar app / Autorizar.

Después de la instalación, serás redirigido a Shopify y/o FlowHunt. La conexión se crea a través del flujo de instalación del marketplace.

2) Instala la app de FlowHunt en tu tienda de Shopify

1. En la pantalla de autorización de Shopify, revisa los permisos solicitados.
2. Haz clic en Instalar app para completar la instalación.

3) Confirma que la integración de Shopify está habilitada

Tras la instalación exitosa, vuelve a FlowHunt → Integraciones. Deberías ver Shopify marcado como Conectado/Habilitado.

Si no está habilitado, haz clic en Conectar de nuevo y sigue el flujo de autorización.

4) Añade un chatbot de Shopify desde la Flow Library

1. En FlowHunt, ve a Flow Library.
2. Busca “Shopify Chatbot”.
3. Abre la plantilla y haz clic en Añadir al workspace.

Esto añadirá un flujo de chatbot de Shopify listo para usar a tu espacio de trabajo.

5) Personaliza el chatbot para tu marca

Abre el flujo que acabas de añadir y ajusta:

• Prompt del sistema y tono: Define la voz y límites de tu marca.
• Fuentes de conocimiento: Conecta tu catálogo de productos, FAQ, políticas u otros documentos.
• Herramientas y acciones: Opcionalmente habilita búsqueda de pedidos, comprobaciones de estado o actualizaciones de CRM si tu plan y configuración lo permiten.
• UI/branding: Configura el nombre del widget, saludos y cualquier etiqueta visible más adelante en la sección de Chatbots.

Cuando termines, guarda los cambios.

6) Publica el flujo

Haz clic en Publicar en el flujo para que esté disponible y pueda ser usado por un chatbot en tu sitio web/tienda.

7) Crea un nuevo Código de Integración (Chatbot)

1. Ve a Chatbots en FlowHunt.
2. Haz clic en Nuevo Código de Integración.
3. Selecciona el flujo publicado que creaste anteriormente.
4. Configura las opciones del widget (tema, posición, comportamiento de apertura, idioma, lista blanca de dominios, etc.).
5. Guarda. FlowHunt generará un fragmento de código (tu Código de Integración).

Guarda este fragmento—lo pegarás en tu tema de Shopify en el siguiente paso.

8) Incrusta el chatbot en tu escaparate de Shopify

Puedes añadir el Código de Integración de dos maneras. Elige la opción que mejor se adapte a tus necesidades.

Opción A — Añadir a theme.liquid (en todo el sitio)

Este método añade el chatbot a todas las páginas de tu tienda. Sigue estos pasos detallados:

Paso 1: Ve a tu panel de administración de Shopify y accede a Tienda online > Temas

Paso 2: Haz clic en el botón Personalizar junto a tu tema activo
Paso 3: Haz clic en los 3 puntos (⋯) en la parte superior izquierda y selecciona Editar código

Paso 4: Localiza tu archivo theme.liquid en la carpeta Layout (/layout/theme.liquid)

Paso 5: Añade el Código de Integración justo antes de la etiqueta de cierre </body>
Paso 6: Guarda los cambios presionando Ctrl + S (o Cmd + S en Mac)

Después de guardar, visita tu escaparate y actualiza la página. El chatbot debería aparecer en todas las páginas.

Notas importantes:

• Pegar antes de </body> asegura que el widget se cargue en cada página
• Mantén el fragmento de FlowHunt intacto y sin modificar
• El chatbot aparecerá en todas las páginas de tu tienda

Opción B — Añadir mediante una sección Custom Liquid (páginas específicas)

Este método te permite mostrar el chatbot solo en páginas o plantillas específicas. Perfecto si quieres el chatbot solo en páginas de productos o landing pages concretas.

Paso 1: Ve a Tienda online > Temas y haz clic en Personalizar junto a tu tema activo

Paso 2: Ve a la plantilla específica donde quieres añadir el chatbot (por ejemplo, páginas de producto, de colección o una página concreta)

Paso 3: Haz clic en Añadir sección o Añadir bloque (según tu tema)
Paso 4: Busca y selecciona Custom Liquid entre las opciones disponibles
Paso 5: Pega tu Código de Integración de FlowHunt en el área de contenido de Custom Liquid

Paso 6: Haz clic en Guardar y luego en Vista previa para probar el chatbot en esa plantilla específica

Notas importantes:

• Este método te da control preciso sobre dónde aparece el chatbot
• Deberás repetir estos pasos para cada plantilla donde quieras el chatbot
• Es ideal para probar el chatbot en páginas específicas antes de implementarlo en todo el sitio
• El chatbot solo aparecerá en las plantillas que hayas configurado

Verificación y pruebas

• Abre tu escaparate en una ventana de incógnito/privada para evitar recursos en caché.
• Haz preguntas comunes (envíos, devoluciones, disponibilidad de productos) para validar el flujo.
• Revisa los registros de conversación en FlowHunt (activa Verbose si es necesario) para ver qué documentos o herramientas se usaron.

Solución de problemas

• El chatbot no aparece: Asegúrate de que el Código de Integración esté incluido en la página, tu tema esté publicado y el dominio esté permitido en la configuración de Chatbots.
• Widgets duplicados: Elimina fragmentos duplicados y mantén solo un Código de Integración activo.
• Respuestas faltantes: Verifica las Fuentes de Conocimiento y la configuración de Document Retriever en tu flujo, luego vuelve a publicar.
• Error de permisos de Shopify: Reconecta Shopify en FlowHunt → Integraciones y reinstala si se solicita.