Shopify

En theme.liquid, con los datos del cliente logueado.

Antes de empezar

  • Acceso al editor de código del tema

1. Editar el tema

  1. En el panel de Shopify, entrá a Tienda online, Temas.
  2. En tu tema activo, abrí el menú y elegí Editar código.
  3. Abrí layout/theme.liquid.
  4. Pegá el snippet justo antes de </body> y guardá.
layout/theme.liquid
<script>  window.TinkaySettings = {    token: "pk_live_xxx"{% if customer %},    visitor: {      email: {{ customer.email | json }},      name: {{ customer.name | json }},      orders_count: {{ customer.orders_count | json }},      total_spent: {{ customer.total_spent | money_without_currency | json }}    }{% endif %}  };</script><script src="https://cdn.tinkay.app/widget.js" async></script></body>

El filtro json de Liquid escapa los valores: no uses comillas manuales alrededor.

2. Conectá la app de Shopify

Además del widget, conectá Shopify desde Apps en tu workspace. Así tu equipo ve los pedidos del cliente en el panel lateral y Tinkay AI puede responder consultas de estado de pedido.

Verificar la instalación

Entrá a Configuración, Instalación en tu workspace, pegá la URL pública del sitio y tocá Probar instalación. Tinkay busca el script y valida que el dominio esté permitido.

  1. Abrí tu sitio en una pestaña nueva y confirmá que aparece el botón flotante.
  2. En la consola del navegador, escribí window.Tinkay y verificá que devuelve un objeto.
  3. Escribí un mensaje de prueba y confirmá que llega al Inbox.

Errores frecuentes

  • El widget no aparece: el dominio no está en Configuración, Dominios. Agregalo y recargá.
  • Aparece en desarrollo pero no en producción: agregá también el dominio de producción, incluida la variante con www.
  • Content Security Policy: permití https://cdn.tinkay.app en script-src y https://app.tinkay.app en frame-src y connect-src.
  • El tema usa secciones: si theme.liquid no tiene </body> visible, buscá el layout alternativo (layout/checkout.liquid no admite scripts en planes sin Shopify Plus).

Cómo saber que quedó bien

  • El botón aparece en la tienda
  • Con un cliente logueado el Inbox muestra su email