← Alle integrationer
Theme app extension

Shopify, åbent dokumenteret.

Installerer Saazly-widgetten i butikkens tema. Denne version læser ingen ordrer og anmoder ikke om ordreadgang.

Development-installation

Den tekniske kandidat er klar til verificering i en development store.

Platformsgodkendelse

Indsendt til Shopify og afventer godkendelse.

Offentlig listing

Ikke udgivet. Vi oplyser først om tilgængelighed efter Shopifys godkendelse.

01 / Fra nul til widget

Installation

Installer appen i en Shopify development store eller via det installationslink, som Saazly stiller til rådighed.

Åbn den indlejrede app i Shopify Admin. Shopify-sessionen verificeres, og installationens offline-token oprettes eller roteres.

Vælg Forbind studio. Et nyt førstepartsvindue hos Saazly kræver en administrator, der er logget ind, og viser kun aktive widgets i det valgte studio.

Vælg widget, og godkend forbindelsen.

Åbn temaeditoren via aktiveringslinket, aktivér Saazly Chat, og gem temaet.

02 / Mindst mulig adgang

Tilladelser og scopes

Admin API-scopes

Ingen i widgetversionen. Konfigurationen bruger en tom scope-liste.

Ordredata

Der læses eller skrives ingen ordredata. Ordreadgang er ikke inkluderet.

Butiksidentitet

Shopifys session-token identificerer butik og brugersession. Det giver aldrig i sig selv ret til at vælge et Saazly-studio.

03 / Datakontrakt

Læste og skrevne data

Læses fra Shopify

Butiksdomæne og signerede sessionsclaims. På butikssiden læser widgetten en browserrapporteret indkøbskurv fra butikkens egen cart.js.

Skrives til Shopify

Ingen forretningsdata. Forhandleren aktiverer selv appens indlejring og gemmer Widget ID i temaindstillingen.

Skrives hos Saazly

Butiksdomæne, krypteret offline access token, krypteret refresh token, udløbstidspunkt, studio-id og widget-id. Alle forbindelser er afgrænset til det enkelte studio.

04 / Hændelser

Webhooks

app/uninstalled

Fjerner aktiv tokenadgang og markerer installationen som afinstalleret.

customers/data_request

Verificeres og registreres. Widgetinstallationen gemmer ingen Shopify-kundeprofil.

customers/redact

Verificeres og registreres. Widgetinstallationen har ingen Shopify-kundeprofil, der skal slettes.

shop/redact

Sletter installationsposten og eventuelle fremtidige Shopify-katalogdata for det tilknyttede studio.

05 / Hemmeligheder

Opbevaring af tokens

I hvile

Access token og refresh token krypteres med AES 256 GCM, før de skrives til databasen. Klienter får aldrig adgang til tokenværdier.

Rotation

Offline-tokens med udløbstid roteres med refresh token fem minutter før udløb. Databasens updated_at bruges som optimistisk rotationslås.

Tilbagekaldelse

Shopify tilbagekalder adgangen ved afinstallation. Webhooken rydder derefter begge krypterede tokenfelter og den aktive lokale adgang.

06 / Ren fjernelse

Afinstallation

Afinstaller Saazly Chat i Shopify Admin.

Shopify tilbagekalder appens adgang og sender app/uninstalled.

Saazly rydder krypterede tokens og markerer installationen som afinstalleret.

Fjern eller deaktivér Saazly Chat under App embeds, hvis temaet stadig viser en gemt indlejring.

07 / Når noget går i stå

Fejlfinding

Appen viser, at sessionen mangler

Åbn appen igen fra Shopify Admin. Kontrollér, at tredjepartsscripts fra cdn.shopify.com ikke blokeres.

Widgetten vises ikke

Kontrollér, at en aktiv widget er tilknyttet, at appens indlejring er aktiveret, og at temaet er gemt.

Det forkerte studio vises

Luk forbindelsesvinduet, vælg det rette studio i Saazly, og åbn et nyt forbindelseslink fra Shopify Admin.

Stadig gået i stå?

Send butikkens domæne, tidspunkt og fejlmeddelelse. Send aldrig tokens eller adgangskoder.

Kontakt support
Shopify-integration | Saazly-dokumentation