← Alla integrationer
Theme app extension

Shopify, öppet dokumenterad.

Installerar Saazly widgeten i butikens tema. Den här versionen läser inga order och begär inga orderbehörigheter.

Development installation

Teknisk kandidat klar för verifiering i development store.

Plattformsgranskning

Inskickad till Shopify och väntar på godkännande.

Publik listing

Inte publicerad. Tillgänglighet påstås först efter Shopify godkännande.

01 / Från noll till widget

Installation

Installera appen i en Shopify development store eller via den installationslänk som Saazly tillhandahåller.

Öppna den inbäddade appen i Shopify Admin. Shopify sessionen verifieras och installationens offline token skapas eller roteras.

Välj Koppla studio. Ett nytt förstapartsfönster hos Saazly kräver en inloggad administratör och visar bara aktiva widgetar i vald studio.

Välj widget och godkänn kopplingen.

Öppna temaredigeraren från aktiveringslänken, aktivera Saazly Chat och spara temat.

02 / Minsta åtkomst

Behörigheter och scopes

Admin API scopes

Inga i widgetversionen. Konfigurationen använder en tom scope lista.

Orderdata

Ingen orderdata läses eller skrivs. Orderbehörigheter ingår inte.

Butiksidentitet

Shopify session token identifierar butik och användarsession. Den ger aldrig ensam rätt att välja Saazly studio.

03 / Datakontrakt

Läst och skriven data

Läses från Shopify

Butiksdomän och signerade sessionsanspråk. På butikssidan läser widgeten en webbläsarrapporterad varukorg från butikens egna cart.js.

Skrivs till Shopify

Ingen affärsdata. Handlaren aktiverar själv appens inbäddning och sparar Widget ID i temainställningen.

Skrivs hos Saazly

Butiksdomän, krypterad offline access token, krypterad refresh token, utgångstid, studio id och widget id. Alla kopplingar är studioskopade.

04 / Händelser

Webhookar

app/uninstalled

Tar bort aktiv tokenåtkomst och markerar installationen avinstallerad.

customers/data_request

Verifieras och registreras. Widgetinstallationen lagrar ingen Shopify kundprofil.

customers/redact

Verifieras och registreras. Widgetinstallationen har ingen Shopify kundprofil att radera.

shop/redact

Raderar installationsposten och eventuell framtida Shopify katalogdata för den kopplade studion.

05 / Hemligheter

Tokenlagring

I vila

Access token och refresh token krypteras med AES 256 GCM innan de skrivs till databasen. Klienter får aldrig tokenvärden.

Rotation

Expirerande offline tokens roteras med refresh token fem minuter före utgång. Databasens updated_at används som optimistiskt rotationslås.

Återkallning

Shopify återkallar åtkomst vid avinstallation. Webhooken rensar därefter båda krypterade tokenfälten och aktiv åtkomst lokalt.

06 / Ren borttagning

Avinstallation

Avinstallera Saazly Chat i Shopify Admin.

Shopify återkallar appens åtkomst och skickar app/uninstalled.

Saazly rensar krypterade tokens och markerar installationen som avinstallerad.

Ta bort eller stäng av Saazly Chat under App embeds om temat fortfarande visar en sparad inbäddning.

07 / När något stoppar

Felsökning

Appen visar att session saknas

Öppna appen på nytt från Shopify Admin. Kontrollera att tredjepartsskript från cdn.shopify.com inte blockeras.

Ingen widget syns

Kontrollera att en aktiv widget är kopplad, att appens inbäddning är aktiverad och att temat är sparat.

Fel studio visas

Stäng kopplingsfönstret, välj rätt studio i Saazly och öppna en ny kopplingslänk från Shopify Admin.

Fortfarande fast?

Skicka butikens domän, tidpunkt och felmeddelande. Skicka aldrig token eller lösenord.

Kontakta support
Shopify integration | Saazly dokumentation