← Alle integrasjoner
Theme app extension

Shopify, åpent dokumentert.

Installerer Saazly-widgeten i butikkens tema. Denne versjonen leser ingen ordrer og ber ikke om ordretilganger.

Utviklingsinstallasjon

Teknisk kandidat klar for verifisering i development store.

Plattformgjennomgang

Sendt til Shopify og venter på godkjenning.

Offentlig oppføring

Ikke publisert. Tilgjengelighet oppgis først etter godkjenning fra Shopify.

01 / Fra null til widget

Installasjon

Installer appen i en Shopify development store eller via installasjonslenken Saazly tilbyr.

Åpne den innebygde appen i Shopify Admin. Shopify-økten verifiseres, og installasjonens offline-token opprettes eller roteres.

Velg Koble til studio. Et nytt førstepartsvindu hos Saazly krever en innlogget administrator og viser bare aktive widgeter i valgt studio.

Velg widget og godkjenn tilkoblingen.

Åpne temaredigereren via aktiveringslenken, aktiver Saazly Chat og lagre temaet.

02 / Minste tilgang

Tilganger og scopes

Admin API-scopes

Ingen i widgetversjonen. Konfigurasjonen bruker en tom scope-liste.

Ordredata

Ingen ordredata leses eller skrives. Ordretilganger er ikke inkludert.

Butikkidentitet

Shopify session token identifiserer butikk og brukerøkt. Den gir aldri alene rett til å velge Saazly-studio.

03 / Datakontrakt

Leste og skrevne data

Leses fra Shopify

Butikkdomene og signerte øktkrav. På butikksiden leser widgeten en nettleserrapportert handlekurv fra butikkens egen cart.js.

Skrives til Shopify

Ingen forretningsdata. Forhandleren aktiverer selv appens innebygging og lagrer Widget ID i temainnstillingen.

Skrives hos Saazly

Butikkdomene, kryptert offline access token, kryptert refresh token, utløpstid, studio-id og widget-id. Alle tilkoblinger er avgrenset til studioet.

04 / Hendelser

Webhooks

app/uninstalled

Fjerner aktiv tokentilgang og markerer installasjonen som avinstallert.

customers/data_request

Verifiseres og registreres. Widgetinstallasjonen lagrer ingen Shopify-kundeprofil.

customers/redact

Verifiseres og registreres. Widgetinstallasjonen har ingen Shopify-kundeprofil å slette.

shop/redact

Sletter installasjonsoppføringen og eventuelle fremtidige Shopify-katalogdata for det tilkoblede studioet.

05 / Hemmeligheter

Tokenlagring

Ved lagring

Access token og refresh token krypteres med AES 256 GCM før de skrives til databasen. Klienter får aldri tokenverdier.

Rotasjon

Offline-tokens som utløper, roteres med refresh token fem minutter før utløp. Databasens updated_at brukes som optimistisk rotasjonslås.

Tilbakekalling

Shopify tilbakekaller tilgangen ved avinstallasjon. Webhooken tømmer deretter begge de krypterte tokenfeltene og den aktive tilgangen lokalt.

06 / Ren fjerning

Avinstallasjon

Avinstaller Saazly Chat i Shopify Admin.

Shopify tilbakekaller appens tilgang og sender app/uninstalled.

Saazly sletter krypterte tokens og markerer installasjonen som avinstallert.

Fjern eller deaktiver Saazly Chat under App embeds dersom temaet fortsatt viser en lagret innebygging.

07 / Når noe stopper opp

Feilsøking

Appen viser at økten mangler

Åpne appen på nytt fra Shopify Admin. Kontroller at tredjepartsskript fra cdn.shopify.com ikke blokkeres.

Ingen widget vises

Kontroller at en aktiv widget er tilkoblet, at appens innebygging er aktivert, og at temaet er lagret.

Feil studio vises

Lukk tilkoblingsvinduet, velg riktig studio i Saazly og åpne en ny tilkoblingslenke fra Shopify Admin.

Fortsatt fastlåst?

Send butikkens domene, tidspunkt og feilmelding. Send aldri token eller passord.

Kontakt kundestøtte
Shopify-integrasjon | Saazly-dokumentasjon