Instalar el chat en Shopify

En Shopify el chat se instala pegando la línea de código de tu agente en el archivo theme.liquid del tema, que es la plantilla que comparten las páginas de la tienda. Se pega una vez, justo antes de </body>, y el chat aparece en toda la tienda salvo en el pago. No existe una app de iAgentify en la tienda de aplicaciones de Shopify y no hace falta.

Antes de empezar

• El agente tiene que estar activo. Un agente en Borrador o En pausa no muestra el chat aunque el código esté pegado. Se activa con el botón Activar (o Reanudar, si estaba en pausa) de la página del agente.
• Necesitas poder editar el código del tema. Puede hacerlo quien es propietario de la tienda o una cuenta de empleado con permiso para gestionar los temas. Si no ves la opción Editar código, depende de tus permisos o de tu plan de Shopify: pídeselo a quien administra la tienda o consulta la ayuda de Shopify.
• El código se guarda en el tema. Si más adelante publicas otro tema, tendrás que pegarlo en el nuevo.

Copia el código de tu agente

1. En iAgentify, entra en Agentes y abre tu agente.

2. Abre la pestaña Widget y, dentro de ella, Instalación.

3. En Código de instalación, pulsa Copiar. Es una sola línea, como esta:

   <script src="https://backendiagentify.yarqat.com/widget.js" data-agent="clave-de-tu-agente" async></script>

Copia siempre la de la aplicación, no la de este artículo: la tuya lleva la clave pública de tu agente. Tienes más detalle en instalar el chat en tu web.

Pégalo en el tema de tu tienda

1. En el panel de administración de Shopify, entra en Tienda online › Temas.

2. Localiza el tema publicado, que es el que ven tus clientes, y abre su menú de los tres puntos.

3. Elige Duplicar. Shopify guarda una copia del tema tal como está ahora, por si necesitas volver atrás.

4. Abre otra vez el menú de los tres puntos del tema publicado y elige Editar código. Se abre el editor de código, que es donde Shopify deja tocar los archivos del tema.

5. Abre el archivo theme.liquid. Está en la carpeta layout; si no lo ves, escribe su nombre en el buscador de archivos del editor.

6. Baja hasta el final del archivo y busca la etiqueta </body>.

7. Pega la línea del chat en la línea de encima:

       <script src="https://backendiagentify.yarqat.com/widget.js" data-agent="clave-de-tu-agente" async></script>
     </body>
   </html>

8. Pulsa Guardar. El cambio se aplica a la tienda al momento, sin publicar nada más.

Comprueba que funciona

1. Abre tu tienda en una ventana privada del navegador. Mírala en su dirección pública, no dentro del editor de temas.

2. En una esquina inferior de la página aparece el botón del chat. Púlsalo.

3. Escribe una pregunta. La respuesta llega en unos segundos y la conversación aparece en Conversaciones, dentro de la aplicación.

Esa prueba es una conversación real: gasta créditos y cuenta en tu analítica.

Problemas habituales en Shopify

• Has editado un tema que no es el publicado. Si pegaste la línea en la copia o en un tema sin publicar, tus clientes no la reciben. Comprueba que está en el theme.liquid del tema publicado.
• El chat no sale en el pago. Las páginas de pago (checkout) no usan theme.liquid, así que el chat no aparece en ellas. Es el funcionamiento normal de Shopify, no un fallo de la instalación.
• La tienda está protegida con contraseña. La página que pide la contraseña usa otro archivo (password.liquid) y no muestra el chat. Entra con la contraseña y lo verás en el resto de la tienda.
• Hay páginas con otra plantilla. Una página que no use theme.liquid, como algunas páginas de aterrizaje creadas con aplicaciones de diseño, no lleva el chat.
• Has cambiado o actualizado el tema. Si publicas otro tema, pega la línea en el theme.liquid del nuevo. Después de actualizar el tema a una versión nueva, comprueba que la línea sigue ahí: los cambios hechos en el código pueden no pasar a la versión nueva.

Añade los dominios de tu tienda a los dominios permitidos

Mientras la lista de Dominios permitidos esté vacía, cualquier web que copie tu línea de código puede cargar tu chat y gastar tus créditos. En Agentes › tu agente › Widget › Instalación › Dominios permitidos, escribe el dominio de tu tienda, pulsa Añadir y después Guardar cambios. Un dominio como tuempresa.com incluye también www.tuempresa.com.

Si tu tienda todavía no tiene dominio propio y se ve en su dirección de Shopify, añade esa dirección completa, por ejemplo tu-tienda.myshopify.com. No uses un comodín como *.myshopify.com, que dejaría usar tu chat a cualquier tienda de Shopify. Si vendes en varios dominios, por país o por idioma, añádelos todos: en una dirección que no está en la lista el chat no aparece. Lo explica con detalle limitar el chat a tus dominios.

Si el chat no aparece

En Shopify lo más habitual es que la línea esté en un tema que no es el publicado, o que estés mirando una página que no usa theme.liquid. Después comprueba que el agente está activo y que el dominio de la tienda está en Dominios permitidos. La lista completa, con cómo comprobar cada causa, está en el chat no aparece en tu web.