Instalar el widget de chat en Shopify
Añade la burbuja de chat de intoCHAT a tu tienda Shopify pegando una etiqueta script en theme.liquid y conecta la tienda para que el agente busque productos.
En Shopify, la app de intoCHAT añade la burbuja de chat como inserción de aplicación: la activas en el editor de temas sin tocar el código del tema. La burbuja y la búsqueda de productos también funcionan sin la app, con los datos públicos de tu tienda y sin clave API; en ese caso pegas una sola etiqueta script en tu tema. Para que el agente pueda consultar pedidos, instala la app de Shopify.
Activarla con la app de Shopify (sin código)
Si instalas la app de Shopify, no necesitas editar tu tema:
- En la pestaña Share del agente, en Website, haz clic en Turn on in your theme en la tarjeta Your Shopify store (el mismo botón está en la tarjeta Orders de la pestaña Actions). Shopify abre el editor de temas con Burbuja de chat de intoCHAT activada en Inserciones de aplicaciones.
- Haz clic en Guardar. La burbuja aparece en todas las páginas de tu tienda.
También la encuentras en Tienda online → Temas → Personalizar → Inserciones de aplicaciones. La inserción muestra el agente en el que instalaste la app; para otro agente, pega su ID en el ajuste ID del agente. Se mantiene al actualizar el tema y desaparece si desinstalas la app.
Sin la app, pega el snippet, como se explica abajo.
Copiar el código
Abre la pestaña Share de tu agente. En la tarjeta Shopify, haz clic en Copy Code. Es el mismo script que el de la tarjeta Bubble Chat y ya incluye el ID de tu agente:
<script src="https://www.intochat.ai/api/embed.js" data-chatbot-id="YOUR_AGENT_ID"></script>
Añadirlo a tu tema
- En la administración de Shopify, ve a Tienda online → Temas.
- Junto a tu tema actual, haz clic en ⋯ y elige Editar código.
- En la carpeta Layout, abre
theme.liquid. - Pega el código justo encima de
</body>y haz clic en Guardar. - Abre tu tienda. La burbuja de chat aparece en la esquina inferior de cada página que usa este layout, con los colores y la posición de la pestaña Appearance.
Justo encima de </body> es el lugar recomendado, pero el código también funciona en la sección <head> de theme.liquid. Si acaba dos veces en el tema, solo aparece una burbuja.
Dejar que el agente busque tus productos
- Abre la pestaña Actions (Acciones) y elige Connect your website.
- Pega la dirección de tu tienda. intoCHAT detecta Shopify y añade dos acciones: Search products, con hasta cinco resultados por búsqueda, y Get product details, con variantes, precios y stock.
- Prueba en el Playground: pregunta por un producto, un precio o si algo está en stock. Las respuestas muestran tarjetas de producto con imagen, precio y enlace a la página del producto.
Los productos se buscan en directo mientras el visitante chatea, así que los productos nuevos y los cambios de precio aparecen sin volver a entrenar. Esta conexión solo lee datos públicos de productos. No ve pedidos, carritos ni datos de clientes, y el agente no puede completar compras en el chat; en su lugar, lleva al cliente a la página adecuada. Para consultar pedidos hace falta la app de Shopify.
Si tu tienda está protegida con contraseña, el agente no ve sus productos. Quita la contraseña en Tienda online → Preferencias y vuelve a conectarla. Más detalles en Conectar tu tienda.
Instalar la app de Shopify
La app de intoCHAT para Shopify da a tu agente acceso de lectura a los pedidos de tu tienda, para que pueda responder a preguntas como «¿Dónde está mi pedido?». Es independiente de la burbuja de chat y de la búsqueda de productos descritas arriba, que siguen funcionando sin ella.
- Abre la pestaña Actions de tu agente y busca la tarjeta Orders.
- Escribe la dirección de Shopify de tu tienda:
your-storeoyour-store.myshopify.com. La encontrarás en la administración de Shopify, en Configuración → Dominios. Tu propio dominio, comoyourstore.com, no sirve aquí. - Haz clic en Install on Shopify. Shopify abre la administración de tu tienda y muestra el acceso que pide intoCHAT.
- Aprueba la instalación. Shopify te devuelve a la pestaña Actions, que indica si ha funcionado.
Solo el propietario de la cuenta y los administradores pueden instalar la app, porque guarda el acceso a tu tienda. En Shopify necesitas permiso para instalar apps. Cada agente se conecta a una tienda; instalar la app en otra tienda sustituye la conexión actual del agente.
En la tarjeta Orders eliges qué hace el agente con los pedidos, por ejemplo recoger peticiones de devolución.
Qué acceso pide la app
- Read orders (
read_orders): para consultar el estado, los artículos, el envío y el seguimiento de un pedido cuando un cliente pregunta por él en el chat.
Nada más. La app no puede crear, cambiar, cancelar ni reembolsar pedidos, y no pide tus productos, tu lista de clientes, tus pagos ni la configuración de tu tienda. Shopify permite a las apps con este acceso leer los pedidos de los últimos 60 días, así que el agente no puede consultar pedidos más antiguos.
Pagar intoCHAT a través de Shopify
Cuando tu cuenta tiene la app instalada, tu plan se cobra a través de Shopify en lugar de con tarjeta. En Settings → Billing, elige Starter o Pro, mensual o anual: Shopify abre el admin de tu tienda para aprobar el cargo, que luego aparece en tu factura de Shopify. La prueba gratuita de 7 días de Starter funciona igual. Para cambiar de plan, elige otro y apruébalo en Shopify; para dejar de pagar, elige Free. Los precios están en dólares estadounidenses y Shopify los convierte a la moneda de facturación de tu tienda. Un plan que ya pagas con tarjeta sigue en tu tarjeta.
También puedes empezar desde Shopify: al abrir intoCHAT desde el admin de Shopify inicias sesión (o creas una cuenta) y la app se instala en tu agente más reciente, o en un agente nuevo para tu tienda si aún no tienes ninguno.
Desinstalar la app
En la administración de Shopify, ve a Configuración → Aplicaciones, abre intoCHAT y elige Desinstalar. Shopify avisa a intoCHAT al momento, e intoCHAT borra la conexión con la tienda y las peticiones de devolución guardadas desde chats con esa tienda. La burbuja de chat y la búsqueda de productos no se ven afectadas. Para volver a conectar, instala la app desde la tarjeta Orders.
intoCHAT renueva por sí mismo el acceso de la app mientras el agente la usa. Si el agente no consulta ningún pedido durante 90 días, Shopify pone fin a ese acceso y la tarjeta Orders te pide que vuelvas a instalar la app.
Cómo trata intoCHAT los datos de tu tienda
- Se guarda: la dirección de tu tienda, el acceso que aprobaste y los tokens de acceso de la app, cifrados.
- No se guarda: pedidos ni fichas de clientes. El agente lee un pedido de Shopify mientras responde en el chat y no guarda ninguna copia.
- Peticiones de devolución: si dejas que el agente las recoja, cada petición se guarda con la dirección de correo y el número de pedido del cliente, y se te envía.
- Transcripciones del chat: lo que escriben los clientes se conserva con tus demás conversaciones en la pestaña Activity, donde puedes eliminar una conversación.
Shopify transmite las solicitudes de privacidad a las apps instaladas en tu tienda, e intoCHAT las gestiona así:
- Un cliente pide sus datos: intoCHAT te envía a ti, el propietario de la cuenta, un correo con lo que tiene sobre esa persona, para que puedas responder. Shopify te pide que respondas en un plazo de 30 días.
- Un cliente pide que se borren sus datos: intoCHAT borra sus peticiones de devolución de tu tienda.
- Se borran los datos de tu tienda (Shopify lo pide 48 horas después de que desinstales la app): intoCHAT borra todo lo que quede de la tienda.
Entrenar al agente con el contenido de tu tienda
En la pestaña Knowledge (Conocimiento), escribe la dirección de tu tienda y elige tus páginas de envíos, devoluciones y preguntas frecuentes. Sube guías de tallas o condiciones como archivos y añade pares de preguntas y respuestas para las respuestas que deben tener una redacción exacta.
Solución de problemas
- No aparece la burbuja en la tienda. Comprueba que editaste el tema publicado y no una copia, y que el código está encima de
</body>entheme.liquid. - "Chatbot not found." en la consola del navegador. El ID del agente en el código no es correcto. Cópialo de nuevo desde la pestaña Share.
- "Connect your website" falla. Comprueba que la dirección es la de tu tienda pública y que no está protegida con contraseña.
- "Install on Shopify" dice que la dirección no es válida. Usa la dirección
.myshopify.comde Configuración → Dominios, no tu propio dominio. - "Shopify app wasn't installed". El mensaje indica el motivo. Si la instalación tardó más de 10 minutos, o cambiaste de cuenta de intoCHAT entretanto, vuelve a empezar desde la tarjeta Orders.
Encontrarás más casos en Solución de problemas. Lo que puede hacer el agente en una tienda Shopify se explica en la página de la integración con Shopify.