comprar

Importante: La integración de Shopify te permite incorporar un empleado de IA en tu tienda Shopify para atender las consultas de los clientes, brindar recomendaciones de productos, ayudar con los pedidos y mejorar la experiencia de compra.

​

🔢 Tabla de contenidos

1. Overview
2. Prerequisites
3. Installation Steps
4. Configuring Your AI Employee
5. Customization Options
6. Common Use Cases
7. Troubleshooting
8. Best Practices

​

1. Descripción general

​

Qué hace esta integración

• Hacer preguntas sobre productos.
• Obtener información sobre tamaños y especificaciones.
• Seguimiento del estado del pedido
• Solicitar devoluciones o cambios
• Obtener recomendaciones de compras
• Reciba soporte instantáneo 24 horas al día, 7 días a la semana

​

Características clave

• Fácil instalación: agregue con una simple etiqueta de script
• Widget personalizable: combina la marca de tu tienda
• Responsivo para dispositivos móviles: funciona en todos los dispositivos
• Conocimiento del producto: conecte almacenes de datos con información del producto
• Integración de pedidos: se puede integrar con las API de Shopify (a través de la herramienta HTTP)
• Captura de clientes potenciales: recopile información del cliente
• Multilingüe: admite varios idiomas

​

Requisitos técnicos

• Tienda Shopify activa (cualquier plan)
• Acceso al editor de código de tema.
• Empleado de ZappWay AI creado y configurado
• Conocimiento básico de HTML (útil pero no obligatorio)

​

2. Requisitos previos

​

Antes de comenzar

1. Vaya a Empleados de IA
2. Haga clic en “Crear empleado de IA”
3. Configurar ajustes e instrucciones
4. Consulte la Guía para empleados de IA para obtener más detalles.

• Descripciones de productos
• Guías de tallas
• Políticas de envío
• Políticas de devolución
• Preguntas frecuentes

1. Open AI Employee settings
2. Go to Tools tab
3. Add Datastore Tool
4. Select your product datastore
5. Save configuration

1. Open your AI Employee in the dashboard
2. Copy the Agent ID from the URL or settings
3. Keep this handy for installation

​

3. Pasos de instalación

​

Paso 1: acceder al editor de código de tema

1. Log in to your Shopify Admin dashboard
2. Navigate to Online Store → Themes
3. Find your current active theme
4. Click Actions → Edit code

​

Paso 2: Copiar el script de integración

​

Paso 3: Insertar script en el tema

1. In the theme code editor, locate the theme.liquid file in the Layout folder
2. Find the closing </head> tag (usually near the top of the file)
3. Paste the script above the </head> tag
4. Click Save in the top-right corner

​

Paso 4: Verificar la instalación

1. Visit your Shopify store in a new browser tab
2. Look for the chat bubble in the bottom-right corner
3. Click the bubble to open the chat widget
4. Send a test message to your AI Employee
5. Verify responses are working correctly

​

4. Configurando su empleado de IA

​

Instrucciones recomendadas para Shopify

​

Conexión de datos del producto

1. Go to Datastores
2. Click “Create Datastore”
3. Name it “Product Catalog” or similar
4. Add datasources:
   • Product descriptions (copy from Shopify product pages)
   • Sizing guides (PDF or text)
   • Shipping policy
   • Return policy
   • FAQs

1. Open AI Employee → Tools tab
2. Add Datastore Tool
3. Select “Product Catalog” datastore
4. Save

​

Opcional: Integración de seguimiento de pedidos

1. Add HTTP Tool to AI Employee
2. Configure endpoint: https://your-store.myshopify.com/admin/api/2024-01/orders.json
3. Add authentication (Shopify API key)
4. Update instructions to mention order tracking capability

​

5. Opciones de personalización

​

Apariencia del widget

​

Mostrar en páginas específicas

• Páginas de productos: /products/
• Páginas de colección: /collections/
• Página del carrito: /cart
• Pagar: /checkout
• Todas las páginas: (sin condiciones)

​

Ocultar en el móvil

​

6. Casos de uso comunes

​

Recomendaciones de productos

• Almacén de datos de productos con descripciones detalladas.
• Instrucciones para hacer preguntas de calificación.
• Conocimiento de categorías de productos.

​

Seguimiento de pedidos

• Herramienta HTTP configurada con Shopify API
• Credenciales API con permiso de lectura de pedidos
• Instrucciones para la gestión de consultas de pedidos.

​

Asistencia con el tamaño

• Guía de tallas cargada en el almacén de datos.
• Instrucciones para hacer preguntas aclaratorias.
• Información de tallas específica del producto.

​

Devoluciones y cambios

• Política de devolución en el almacén de datos.
• Herramienta de formulario para recopilar detalles de devolución
• Instrucciones para el proceso de devolución.

​

Recuperación de carrito abandonado

• Activador de mensajes proactivo (implementación personalizada)
• Instrucciones para la recuperación del carrito.
• Conocimiento de las promociones vigentes.

​

7. Solución de problemas

​

La burbuja de chat no aparece

1. Verify Agent ID is correct:
   • Check for typos in the script
   • Ensure Agent ID matches your dashboard
2. Check script placement:
   • Must be before </head> tag
   • Not inside any other script tags
   • Saved correctly in theme.liquid
3. Clear browser cache:
   • Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
   • Try incognito/private browsing mode
4. Check browser console for errors:
   • Open DevTools (F12)
   • Go to Console tab
   • Look for error messages
   • Common error: “Failed to load module”
5. Verify theme file:
   • Ensure you edited the active theme
   • Check that changes were saved
   • Preview theme before publishing

​

La IA no responde

1. Test AI Employee directly:
   • Go to AI Employee in ZappWay dashboard
   • Use test chat interface
   • If it works there, issue is with integration
2. Check AI Employee status:
   • Ensure AI Employee is not disabled
   • Verify instructions are configured
   • Check that datastores are connected
3. Review rate limits:
   • Check if rate limits are exceeded
   • See Rate Limit Guide
4. Check datastore status:
   • Ensure datastores are processed (not “Processing”)
   • Verify content is indexed

​

Problemas de estilo de widgets

1. Customize colors:

   theme: {
     primaryColor: '#YOUR_BRAND_COLOR',
   }

2. Adjust position:

   theme: {
     position: 'left',  // or 'right'
     bottom: 30,
     left: 30,
   }

3. Change widget size:

   window: {
     height: 700,
     width: 450,
   }

​

Script cargando lentamente

• Retraso en la carga de CDN (raro)
• Conexión de red lenta
• Bloqueo de otros scripts

1. Use async loading:

   
     import Chatbox from 'https://cdn.jsdelivr.net/npm/@zappway/embeds@latest/dist/chatbox/index.js';
     Chatbox.initBubble({ agentId: 'YOUR_AGENT_ID' });
   

2. Self-host the script (advanced):
   • Download library from CDN
   • Upload to Shopify theme assets
   • Update script src to point to local file

​

8. Mejores prácticas

​

Estrategia de contenido

• Actualizar el almacén de datos cuando los productos cambian.
• Incluir información de productos de temporada.
• Agregar nuevos productos al almacén de datos inmediatamente
• Eliminar productos descatalogados

• Información de precios desactualizada
• Productos que ya no están en stock.
• Descripciones de productos inconsistentes

• Descripciones detalladas de los productos.
• Materiales y especificaciones
• Instrucciones de cuidado
• Tablas de tallas (con medidas)
• Opciones y variaciones de color.
• Casos de uso y beneficios del producto.
• Comentarios y testimonios de clientes.
• Comparación con productos similares

​

Configuración de empleados de IA

​

Experiencia del cliente

• La IA debería responder en 2-3 segundos
• Si el procesamiento es más prolongado (por ejemplo, llamadas API), muestra el indicador de escritura
• Proporcionar actualizaciones de estado para consultas complejas

​

Análisis y mejora

• Preguntas más comunes de los clientes.
• Productos frecuentemente preguntados sobre
• Puntos de entrega en conversaciones.
• Preguntas que la IA no pudo responder

• Verificar registros de conversaciones
• Identificar lagunas de conocimiento
• Actualizar el almacén de datos con información faltante

• Analizar las consultas sobre productos principales.
• Actualizar instrucciones de IA según las tendencias.
• Agregar nuevas preguntas frecuentes al almacén de datos

• Gran revisión de la base de conocimientos.
• Revisar y perfeccionar la personalidad de la IA.
• Prueba A/B de diferentes enfoques.

​

Seguridad

• No almacenar información de pago en el chat
• No solicites datos sensibles (contraseñas, números completos de tarjetas)
• Cumplir con las normas de privacidad (GDPR, CCPA)
• Utilice únicamente conexiones seguras (HTTPS)

​

📞 Soporte y recursos

​

Obteniendo ayuda

• Botón de ayuda en el panel de ZappWay
• Chat en vivo (disponible en planes Pro+)

• Documentación del tema de Shopify
• Lenguaje de plantilla líquida

• Guía para empleados de IA
• Configuración del almacén de datos
• Personalización de widgets

​

Comentario

• Correo electrónico: support@zappway.ai
• Incluye:
  • URL de la tienda Shopify
  • Identificación del agente
  • Capturas de pantalla del problema
  • Errores de la consola del navegador (si los hay)

​

✅ Referencia rápida

​

Lista de verificación de instalación

​

Plantilla de secuencia de comandos

​

Personalizaciones comunes