← Todas las integraciones
Theme app extension

Shopify, documentada abiertamente.

Instala el widget de Saazly en el tema de la tienda. Esta versión no lee pedidos ni solicita permisos para acceder a ellos.

Instalación de desarrollo

Versión técnica candidata lista para verificarse en una development store.

Revisión de la plataforma

Enviada a Shopify y pendiente de aprobación.

Publicación pública

Aún no está publicada. Solo se anunciará su disponibilidad tras la aprobación de Shopify.

01 / De cero al widget

Instalación

Instala la aplicación en una Shopify development store o mediante el enlace de instalación facilitado por Saazly.

Abre la aplicación integrada en Shopify Admin. La sesión de Shopify se verifica y se crea o renueva el token offline de la instalación.

Selecciona Conectar estudio. Se abrirá una nueva ventana propia de Saazly que requiere iniciar sesión como administrador y solo muestra los widgets activos del estudio seleccionado.

Elige el widget y aprueba la conexión.

Abre el editor de temas desde el enlace de activación, activa Saazly Chat y guarda el tema.

02 / Acceso mínimo

Permisos y scopes

Permisos de Admin API

Ninguno en la versión del widget. La configuración utiliza una lista de permisos vacía.

Datos de pedidos

No se leen ni escriben datos de pedidos. No se incluyen permisos de pedidos.

Identidad de la tienda

El token de sesión de Shopify identifica la tienda y la sesión del usuario. Por sí solo, nunca concede permiso para elegir un estudio de Saazly.

03 / Contrato de datos

Datos leídos y escritos

Datos leídos de Shopify

El dominio de la tienda y las declaraciones de sesión firmadas. En la tienda, el widget lee el carrito comunicado por el navegador desde el cart.js propio de la tienda.

Datos escritos en Shopify

Ningún dato comercial. El comerciante activa personalmente la integración de la aplicación y guarda el Widget ID en la configuración del tema.

Datos escritos en Saazly

Dominio de la tienda, access token offline cifrado, refresh token cifrado, fecha de caducidad, studio id y widget id. Todas las conexiones están limitadas al estudio correspondiente.

04 / Eventos

Webhooks

app/uninstalled

Elimina el acceso mediante tokens activos y marca la instalación como desinstalada.

customers/data_request

Se verifica y registra. La instalación del widget no almacena perfiles de clientes de Shopify.

customers/redact

Se verifica y registra. La instalación del widget no contiene ningún perfil de cliente de Shopify que eliminar.

shop/redact

Elimina el registro de instalación y cualquier dato futuro del catálogo de Shopify para el estudio conectado.

05 / Secretos

Almacenamiento de tokens

En reposo

El access token y el refresh token se cifran con AES 256 GCM antes de guardarse en la base de datos. Los clientes nunca reciben los valores de los tokens.

Renovación

Los tokens offline con caducidad se renuevan mediante el refresh token cinco minutos antes de vencer. El updated_at de la base de datos se utiliza como bloqueo optimista para la renovación.

Revocación

Shopify revoca el acceso al desinstalar la aplicación. Después, el webhook borra los dos campos de tokens cifrados y el acceso activo local.

06 / Eliminación limpia

Desinstalación

Desinstala Saazly Chat desde Shopify Admin.

Shopify revoca el acceso de la aplicación y envía app/uninstalled.

Saazly elimina los tokens cifrados y marca la instalación como desinstalada.

Elimina o desactiva Saazly Chat en App embeds si el tema sigue mostrando una integración guardada.

07 / Cuando algo se bloquea

Resolución de problemas

La aplicación indica que no hay sesión

Vuelve a abrir la aplicación desde Shopify Admin. Comprueba que los scripts de terceros de cdn.shopify.com no estén bloqueados.

El widget no aparece

Comprueba que haya un widget activo conectado, que la integración de la aplicación esté activada y que se haya guardado el tema.

Aparece el estudio equivocado

Cierra la ventana de conexión, selecciona el estudio correcto en Saazly y abre un nuevo enlace de conexión desde Shopify Admin.

¿Sigue teniendo problemas?

Envíe el dominio de la tienda, la hora y el mensaje de error. Nunca envíe tokens ni contraseñas.

Contactar con soporte
Integración con Shopify | Documentación de Saazly