← Kaikki integraatiot
Teemaan upotettava sovelluslaajennus

Shopify, avoimesti dokumentoituna.

Asentaa Saazly-chatin kaupan teemaan. Tämä versio ei lue tilauksia eikä pyydä tilauksiin liittyviä käyttöoikeuksia.

Kehitysympäristöön asennus

Tekninen versioehdokas on valmis tarkistettavaksi development storessa.

Alustan tarkistus

Lähetetty Shopifylle ja odottaa hyväksyntää.

Julkinen listaus

Ei julkaistu. Saatavuudesta ilmoitetaan vasta Shopifyn hyväksynnän jälkeen.

01 / Nollasta widgetiin

Asennus

Asenna sovellus Shopify development storeen tai Saazlyn toimittaman asennuslinkin kautta.

Avaa upotettu sovellus Shopify Adminissa. Shopify-istunto vahvistetaan ja asennuksen offline token luodaan tai vaihdetaan.

Valitse Yhdistä studio. Saazlyn omaan verkkotunnukseen avautuva uusi ikkuna edellyttää kirjautunutta ylläpitäjää ja näyttää vain valitun studion aktiiviset chatit.

Valitse chat ja hyväksy yhdistäminen.

Avaa teemaeditori aktivointilinkistä, ota Saazly Chat käyttöön ja tallenna teema.

02 / Vähimmäiskäyttöoikeudet

Käyttöoikeudet ja scopet

Admin API -käyttöoikeudet

Ei käyttöoikeuksia chat-versiossa. Määrityksessä käytetään tyhjää käyttöoikeusluetteloa.

Tilaustiedot

Tilaustietoja ei lueta eikä kirjoiteta. Tilauksiin liittyviä käyttöoikeuksia ei pyydetä.

Kaupan tunnistaminen

Shopify session token tunnistaa kaupan ja käyttäjäistunnon. Se ei koskaan yksinään anna oikeutta valita Saazly-studiota.

03 / Datasopimus

Luettava ja kirjoitettava data

Shopifysta luettavat tiedot

Kaupan verkkotunnus ja allekirjoitetut istuntoväitteet. Kaupan sivulla chat lukee selaimen ilmoittaman ostoskorin kaupan omasta cart.js-tiedostosta.

Shopifyhin kirjoitettavat tiedot

Ei liiketoimintatietoja. Kauppias ottaa itse sovellusupotuksen käyttöön ja tallentaa Widget ID:n teeman asetuksiin.

Saazlylle tallennettavat tiedot

Kaupan verkkotunnus, salattu offline access token, salattu refresh token, vanhenemisaika, studio id ja widget id. Kaikki yhteydet rajataan studiokohtaisesti.

04 / Tapahtumat

Webhookit

app/uninstalled

Poistaa aktiivisen token-pääsyn ja merkitsee asennuksen poistetuksi.

customers/data_request

Vahvistetaan ja kirjataan. Chat-asennus ei tallenna Shopifyn asiakasprofiilia.

customers/redact

Vahvistetaan ja kirjataan. Chat-asennuksella ei ole poistettavaa Shopifyn asiakasprofiilia.

shop/redact

Poistaa asennustietueen ja mahdolliset yhdistetyn studion tulevat Shopify-katalogitiedot.

05 / Salaisuudet

Tokenien säilytys

Levossa

Access token ja refresh token salataan AES 256 GCM -menetelmällä ennen tietokantaan kirjoittamista. Token-arvoja ei koskaan luovuteta asiakassovelluksille.

Vaihtaminen

Vanhenevat offline tokenit vaihdetaan refresh tokenilla viisi minuuttia ennen vanhenemista. Tietokannan updated_at-kenttää käytetään optimistisena vaihtolukkona.

Käyttöoikeuden peruminen

Shopify peruu käyttöoikeuden, kun sovellus poistetaan. Webhook tyhjentää sen jälkeen molemmat salatut token-kentät ja poistaa aktiivisen paikallisen käyttöoikeuden.

06 / Siisti poisto

Asennuksen poisto

Poista Saazly Chat Shopify Adminissa.

Shopify peruu sovelluksen käyttöoikeuden ja lähettää app/uninstalled-tapahtuman.

Saazly tyhjentää salatut tokenit ja merkitsee asennuksen poistetuksi.

Poista Saazly Chat käytöstä tai kokonaan App embeds -kohdassa, jos tallennettu upotus näkyy teemassa edelleen.

07 / Kun jokin pysähtyy

Vianmääritys

Sovellus ilmoittaa, että istunto puuttuu

Avaa sovellus uudelleen Shopify Administa. Tarkista, ettei cdn.shopify.com-verkkotunnuksen kolmannen osapuolen komentosarjoja estetä.

Chat ei näy

Tarkista, että aktiivinen chat on yhdistetty, sovellusupotus on käytössä ja teema on tallennettu.

Näkyvissä on väärä studio

Sulje yhdistämisikkuna, valitse oikea studio Saazlyssa ja avaa uusi yhdistämislinkki Shopify Administa.

Vieläkö jumissa?

Lähetä verkkokaupan verkkotunnus, ajankohta ja virheilmoitus. Älä koskaan lähetä tokenia tai salasanaa.

Ota yhteyttä tukeen
Shopify-integraatio | Saazlyn dokumentaatio