← Tutte le integrazioni
Theme app extension

Shopify, con documentazione pubblica.

Installa il widget Saazly nel tema del negozio. Questa versione non legge gli ordini e non richiede autorizzazioni per accedervi.

Installazione di sviluppo

Versione tecnica candidata pronta per la verifica in un development store.

Revisione della piattaforma

Inviata a Shopify e in attesa di approvazione.

Listing pubblico

Non ancora pubblicata. La disponibilità verrà comunicata solo dopo l'approvazione di Shopify.

01 / Da zero al widget

Installazione

Installa l'app in un Shopify development store oppure tramite il link di installazione fornito da Saazly.

Apri l'app incorporata in Shopify Admin. La sessione Shopify viene verificata e il token offline dell'installazione viene creato o ruotato.

Seleziona Collega studio. Si apre una nuova finestra proprietaria di Saazly, che richiede l'accesso come amministratore e mostra solo i widget attivi nello studio selezionato.

Seleziona il widget e approva il collegamento.

Apri l'editor del tema dal link di attivazione, attiva Saazly Chat e salva il tema.

02 / Accesso minimo

Autorizzazioni e scope

Ambiti Admin API

Nessuno nella versione del widget. La configurazione utilizza un elenco di ambiti vuoto.

Dati degli ordini

Non vengono letti né scritti dati degli ordini. Le autorizzazioni per gli ordini non sono incluse.

Identità del negozio

Il token di sessione Shopify identifica il negozio e la sessione utente. Da solo non autorizza mai la scelta di uno studio Saazly.

03 / Contratto dei dati

Dati letti e scritti

Dati letti da Shopify

Dominio del negozio e dichiarazioni di sessione firmate. Sul sito del negozio, il widget legge dal cart.js del negozio il carrello segnalato dal browser.

Dati scritti su Shopify

Nessun dato aziendale. Il commerciante attiva personalmente l'incorporamento dell'app e salva il Widget ID nelle impostazioni del tema.

Dati salvati da Saazly

Dominio del negozio, token di accesso offline crittografato, refresh token crittografato, scadenza, ID dello studio e ID del widget. Tutti i collegamenti sono circoscritti allo studio.

04 / Eventi

Webhook

app/uninstalled

Rimuove l'accesso tramite token attivo e contrassegna l'installazione come disinstallata.

customers/data_request

La richiesta viene verificata e registrata. L'installazione del widget non archivia profili cliente Shopify.

customers/redact

La richiesta viene verificata e registrata. L'installazione del widget non contiene profili cliente Shopify da cancellare.

shop/redact

Elimina il record dell'installazione ed eventuali futuri dati del catalogo Shopify relativi allo studio collegato.

05 / Credenziali segrete

Archiviazione dei token

A riposo

Il token di accesso e il refresh token vengono crittografati con AES 256 GCM prima di essere scritti nel database. I valori dei token non vengono mai forniti ai client.

Rotazione

I token offline in scadenza vengono ruotati tramite refresh token cinque minuti prima della scadenza. Il campo updated_at del database funge da blocco ottimistico per la rotazione.

Revoca

Shopify revoca l'accesso al momento della disinstallazione. Il webhook cancella quindi entrambi i campi dei token crittografati e l'accesso attivo locale.

06 / Rimozione completa

Disinstallazione

Disinstalla Saazly Chat da Shopify Admin.

Shopify revoca l'accesso dell'app e invia app/uninstalled.

Saazly cancella i token crittografati e contrassegna l'installazione come disinstallata.

Rimuovi o disattiva Saazly Chat nella sezione App embeds se il tema mostra ancora un incorporamento salvato.

07 / In caso di blocco

Risoluzione dei problemi

L'app segnala che manca la sessione

Riapri l'app da Shopify Admin. Verifica che gli script di terze parti provenienti da cdn.shopify.com non siano bloccati.

Il widget non è visibile

Verifica che sia collegato un widget attivo, che l'incorporamento dell'app sia attivo e che il tema sia stato salvato.

Viene mostrato lo studio sbagliato

Chiudi la finestra di collegamento, seleziona lo studio corretto in Saazly e apri un nuovo link di collegamento da Shopify Admin.

Sei ancora bloccato?

Invia il dominio del negozio, l’orario e il messaggio di errore. Non inviare mai token o password.

Contatta l’assistenza
Integrazione Shopify | Documentazione Saazly