Integrasjon med Shopify

Koble ChatLab-chatboten din til Shopify-butikken din for å gi kundene tilgang i sanntid til produktinformasjon og ordresporing direkte i chatten.

Viktig: Beste praksis for e-handel

Etter at du har fullført integrasjonen nedenfor, bør du lese den omfattende veiledningen om hvordan du optimaliserer chatboten din for e-handel: Hvordan sette opp ChatLab for e-handelsbutikken din

Hva integrasjonen tilbyr

Produktsøk - Kunder kan søke i Shopify-katalogen din ved å skrive inn et søkeord. Chatboten søker på tvers av produkttitler, beskrivelser, typer, tagger og leverandører, og returnerer matchende aktive produkter med:

• Produktnavn, beskrivelse og type
• Leverandør og tagger
• Pris eller prisklasse (for produkter med flere varianter)
• Tilgjengelige varianter med SKU, førpris (compare-at price), lagerantall og tilgjengelighetsstatus
• Produktbilde og direkte lenke til butikken din

Du kan konfigurere produktsøket til å bare vise produkter på lager. Når dette er aktivert, ekskluderes utsolgte varer fra resultatene. Et ekstra valg lar deg inkludere produkter som er tilgjengelige for forhåndsbestilling, selv når lagerfilteret er aktivt. Se trinn 4 for detaljer.

Ordredetaljer - Kunder kan sjekke ordrestatus ved å oppgi ordrenummer og e-postadresse. Begge verdiene valideres mot oppføringene i Shopify-butikken din. Chatboten returnerer:

• Odrereferanse, dato, totalsum og valuta
• Bestilte varer med navn, antall, priser, SKU, varianttittel og leverandør
• Behandlingsstatus (fulfillment status) og sporingsinformasjon (nummer, transportør, URL)
• Leveringsadresse og fakturaadresse
• Fraktmetode og fraktkostnad
• Kundens kontaktinformasjon (e-post, navn, telefon)
• Årsak og dato for kansellering (for kansellerte bestillinger)

Trinn 1: Opprett API-påloggingsinformasjon i Shopify

Viktig for byråer og Shopify-partnere: Shopify-appen MÅ opprettes i Dev Dashboard for organisasjonen som eier butikken - start alltid fra butikkens eget administrasjonspanel (Settings > Apps > Develop apps > Build apps in Dev Dashboard (Innstillinger > Apper > Utvikle apper > Bygg apper i Dev Dashboard)). En app som er opprettet av en annen organisasjon (for eksempel et byrå eller en Shopify-partner som jobber i sitt eget Dev Dashboard) og installert i butikken via en tilpasset installasjonslenke, vil IKKE fungere med ChatLab, selv om installasjonen lykkes og appen vises blant butikkens installerte apper med riktige tillatelser. Årsaken: ChatLab kobler til ved hjelp av Client ID og Secret (Shopifys client credentials grant), og Shopify tillater bare denne godkjenningen for apper utviklet av organisasjonen som eier butikken - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (Shopify-dokumentasjon). Dette er en begrensning fra Shopify, ikke fra ChatLab. Symptomet er en tilkoblingsfeil i ChatLab med meldingen "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (forårsaket av Shopifys shop_not_permitted OAuth-feil), selv når Client ID, Secret og butikkens subdomene er helt korrekte og appen er installert. Et sikkert tegn på en app fra en annen organisasjon er at butikkadministrasjonen viser "This custom app was built by a Shopify partner for your store." Løsningen for byråer: du trenger ikke at forhandlerens utvikler gjør det - be forhandleren legge til brukeren din i SIN organisasjon med rollen App developer ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - Shopify-dokumentasjon), og opprett deretter appen mens du jobber i forhandlerens organisasjon. Samarbeidstilgang (collaborator access) alene er ikke tilstrekkelig - apper opprettet mens du jobber i din egen organisasjon forblir i din organisasjon.

1. Logg inn på Shopify-administrasjonspanelet ditt
2. Gå til Settings > Apps (Innstillinger > Apper)
3. Klikk på Develop apps (Utvikle apper)
4. På siden App Development klikker du på Build apps in Dev Dashboard (Bygg apper i Dev Dashboard) - dette åpner dev.shopify.com/dashboard
5. Klikk på Create app (Opprett app) og skriv inn et navn (f.eks. "ChatLab Integration")

6. Når den er opprettet, blar du ned til delen Access (Tilgang) og klikker på Select scopes (Velg omfang)

7. Under tilgangsomfang for Admin API, finn og aktiver disse tillatelsene:
   • read_products
   • read_orders
8. Klikk på Done (Ferdig)

9. Klikk på Release-knappen (Publiser) for å gi ut appen din
10. Gå til App settings (Appinnstillinger) og kopier Client ID og Secret - oppbevar disse sikkert, du trenger dem for å koble til ChatLab

11. Gå til delen Home (Hjem) og klikk for å installere applikasjonen i butikken din

12. Velg butikken din og bekreft ved å klikke på Install (Installer)

Trinn 2: Finn butikkens subdomene

Subdomenet ditt er delen foran .myshopify.com i Shopifys administrasjons-URL. Hvis for eksempel URL-en din er https://pizza-delicious.myshopify.com/admin, er subdomenet ditt pizza-delicious.

Trinn 3: Koble til Shopify i ChatLab

1. Logg inn på ChatLab og velg boten din
2. Gå til Connect-fanen (Koble til)

3. Klikk på Connect (Koble til) på Shopify-flisen
4. Skriv inn din Client ID (fra trinn 1)
5. Skriv inn din Secret (fra trinn 1)
6. Skriv inn ditt Shopify-subdomene (fra trinn 2)

7. Klikk på Connect

ChatLab tester automatisk tilkoblingen ved å bekrefte at API-påloggingsinformasjonen din har de nødvendige tilgangsomfangene. Hvis alt er i orden, vil du se en bekreftelsesmelding.

Trinn 4: Konfigurer Shopify-handlinger

Etter at du har koblet til, kan du aktivere og tilpasse individuelle AI-handlinger. Gå til Settings > Actions (Innstillinger > Handlinger) og filtrer etter Shopify-plattformen.

To handlinger er tilgjengelige:

• Shopify - product search - lar chatboten søke i produktkatalogen din
• Shopify - order details - lar chatboten slå opp ordreinformasjon

Klikk på aktiveringsknappen for hver handling for å ta den i bruk. Du kan også tilpasse handlingsetiketten (meldingen som vises for brukere mens handlingen kjører) og instruksjonene som styrer hvordan AI-en bruker hver handling.

Produktsøk - Lagerinnstillinger

Handlingen for produktsøk inkluderer alternativer for lagerfiltrering i fanen Product Search Settings (Innstillinger for produktsøk):

• Products in stock only (Kun produkter på lager) - Når dette er aktivert, returnerer chatboten bare produkter som for øyeblikket er på lager. Utsolgte produkter ekskluderes fra søkeresultatene.
• Show products available for pre-order (Vis produkter tilgjengelige for forhåndsbestilling) - Dette alternativet vises når "Products in stock only" er aktivert. Når det er aktivt, vil produkter som er utsolgt, men konfigurert til å fortsette salget (forhåndsbestilling) i Shopify, fortsatt vises i søkeresultatene, merket som tilgjengelige for forhåndsbestilling.

Teste integrasjonen din

Etter at du har aktivert handlingene, åpner du chatbot-widgeten og prøver:

• "Vis meg joggesko" (tester produktsøk)
• "Hva er statusen for ordren min #1001?" (tester ordredetaljer)

Bekreft at svarene stemmer overens med dataene fra Shopify-butikken din, og at produktlenkene åpner seg som de skal.

Installer chatboten i Shopify-butikken din

For å legge til chat-widgeten i Shopify-nettbutikken din:

1. I ChatLab går du til Deploy-fanen (Publiser) for boten din
2. Velg Shopify-plattformfanen
3. Kopier kodesnutten
4. I Shopify-administrasjonen går du til Online Store > Themes (Nettbutikk > Temaer)
5. Klikk på menyen med tre prikker på det aktive temaet ditt og velg Edit code (Rediger kode)
6. Åpne filen theme.liquid under Layout
7. Lim inn kodesnutten i <head>-seksjonen
8. Klikk på Save (Lagre)

Til slutt - du må aktivere AI Actions som er tilgjengelige for Shopify - Order details og Product Search.