Integration med Shopify

Forbind din ChatLab-chatbot med din Shopify-butik for at give kunderne adgang i realtid til produktoplysninger og ordrespring direkte i chatten.

Vigtigt: Best practices for e-commerce

Når du har gennemført integrationen nedenfor, bør du læse den omfattende vejledning om optimering af din chatbot til e-commerce: How to set up ChatLab for your E-commerce store

Hvad integrationen giver

Produktsøgning - Kunder kan søge i dit Shopify-katalog ved at indtaste en frase. Chatbotten søger på tværs af produkttitler, beskrivelser, typer, tags og leverandører, og returnerer matchende aktive produkter med:

• Produktnavn, beskrivelse og type
• Leverandør og tags
• Pris eller prisinterval (for produkter med flere varianter)
• Tilgængelige varianter med varenummer (SKU), sammenligningspris, lagerantal og tilgængelighedsstatus
• Produktbillede og direkte link til din butik

Du kan konfigurere produktsøgningen til kun at vise varer på lager. Når dette er aktiveret, udelukkes varer, der ikke er på lager, fra resultaterne. En ekstra indstilling lader dig inkludere produkter, der kan forudbestilles, selv når lagerfilteret er aktivt. Se Trin 4 for flere detaljer.

Ordreoplysninger - Kunder kan tjekke ordrestatus ved at oplyse deres ordrenummer og e-mailadresse. Begge værdier valideres mod data i din Shopify-butik. Chatbotten returnerer:

• Ordrereference, dato, samlet beløb og valuta
• Bestilte varer med navne, antal, priser, varenummer (SKU), varianttitel og leverandør
• Leveringsstatus og trackingoplysninger (nummer, fragtfirma, URL)
• Leveringsadresse og faktureringsadresse
• Leveringsmetode og fragtpris
• Kundens kontaktoplysninger (e-mail, navn, telefon)
• Årsag til annullering og dato (for annullerede ordrer)

Trin 1: Opret Shopify API-adgangsoplysninger

Vigtigt for bureauer og Shopify-partnere: Shopify-appen SKAL oprettes i Dev Dashboard for den organisation, der ejer butikken - start altid fra selve butikkens administrationspanel (Settings > Apps > Develop apps > Build apps in Dev Dashboard). En app oprettet af en anden organisation (f.eks. et bureau eller en Shopify-partner, der arbejder i deres eget Dev Dashboard) og installeret på butikken via et brugerdefineret installationslink vil IKKE fungere med ChatLab, selvom installationen lykkes, og appen vises blandt butikkens installerede apps med de korrekte rettigheder. Årsagen: ChatLab forbinder via Client ID og Secret (Shopifys client credentials grant), og Shopify tillader kun dette grant for apps udviklet af den organisation, der ejer butikken - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (Shopify-dokumentation). Dette er en begrænsning hos Shopify, ikke hos ChatLab. Symptomet er en forbindelsesfejl i ChatLab med meddelelsen "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (forårsaget af Shopifys OAuth-fejl shop_not_permitted), selv når Client ID, Secret og butikkens subdomæne er korrekte, og appen er installeret. Et tydeligt tegn på en app fra en anden organisation: butikkens administratorpanel viser "This custom app was built by a Shopify partner for your store." Løsningen for bureauer: du behøver ikke få forhandlerens udvikler til at gøre det - bed forhandleren om at tilføje din bruger til DERES organisation med rollen App developer ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - Shopify-dokumentation), og opret derefter appen, mens du arbejder i forhandlerens organisation. Samarbejdspartneradgang (collaborator access) alene er ikke tilstrækkeligt - apps oprettet, mens du arbejder i din egen organisation, forbliver i din organisation.

1. Log ind på dit Shopify-kontrolpanel
2. Gå til Settings > Apps (Indstillinger > Apps)
3. Klik på Develop apps (Udvikl apps)
4. På siden App Development klikker du på Build apps in Dev Dashboard (Byg apps i Dev Dashboard) - dette åbner dev.shopify.com/dashboard
5. Klik på Create app (Opret app) og indtast et navn (f.eks. "ChatLab Integration")

6. Når den er oprettet, ruller du ned til sektionen Access (Adgang) og klikker på Select scopes (Vælg omfang)

7. Under adgangsomfang for Admin API finder og aktiverer du disse rettigheder:
   • read_products
   • read_orders
8. Klik på Done (Udført)

9. Klik på knappen Release (Udgiv) for at frigive din app
10. Gå til App settings (App-indstillinger), og kopiér Client ID og Secret - gem disse et sikkert sted, da du skal bruge dem til at forbinde med ChatLab

11. Gå til sektionen Home (Startside), og klik for at installere applikationen i din butik

12. Vælg din butik, og bekræft ved at klikke på Install (Installer)

Trin 2: Find din butiks subdomæne

Dit subdomæne er den del, der står før .myshopify.com i din Shopify-administrator-URL. Hvis din administrator-URL for eksempel er https://pizza-delicious.myshopify.com/admin, er dit subdomæne pizza-delicious.

Trin 3: Forbind Shopify i ChatLab

1. Log ind på ChatLab, og vælg din bot
2. Gå til fanen Connect (Forbind)

3. Klik på Connect (Forbind) på Shopify-feltet
4. Indtast dit Client ID (fra Trin 1)
5. Indtast din Secret (fra Trin 1)
6. Indtast dit Shopify subdomain (Shopify-subdomæne fra Trin 2)

7. Klik på Connect (Forbind)

ChatLab tester automatisk forbindelsen ved at bekræfte, at dine API-adgangsoplysninger har de nødvendige adgangsrettigheder. Hvis det lykkes, ser du en bekræftelsesmeddelelse.

Trin 4: Konfigurer Shopify Actions

Når forbindelsen er oprettet, kan du aktivere og tilpasse individuelle AI actions. Gå til Settings > Actions (Indstillinger > Handlinger), og filtrer efter Shopify-platformen.

To handlinger er tilgængelige:

• Shopify - product search - giver chatbotten mulighed for at søge i dit produktkatalog
• Shopify - order details - giver chatbotten mulighed for at slå ordreoplysninger op

Klik på aktiveringsknappen ved hver handling for at slå den til. Du kan også tilpasse handlingens etiket (den besked, der vises for brugerne, mens handlingen kører) og instruktionerne, der styrer, hvordan AI'en anvender hver handling.

Produktsøgning - lagerindstillinger

Handlingen til produktsøgning indeholder muligheder for lagerfiltrering under fanen Product Search Settings (Indstillinger for produktsøgning):

• Products in stock only (Kun varer på lager) - Når denne er aktiveret, returnerer chatbotten kun produkter, der aktuelt er på lager. Varer, der ikke er på lager, udelukkes fra søgeresultaterne.
• Show products available for pre-order (Vis produkter tilgængelige for forudbestilling) - Denne indstilling vises, når "Products in stock only" er aktiveret. Når den er slået til, vil produkter, der ikke er på lager, men er konfigureret til at fortsætte salget (forudbestilling) i Shopify, stadig blive vist i søgeresultaterne, markeret som tilgængelige for forudbestilling.

Afprøvning af din integration

Når du har aktiveret handlingerne, kan du åbne din chatbot-widget og prøve:

• "Show me running shoes" (tester produktsøgning)
• "What's the status of my order #1001?" (tester ordreoplysninger)

Kontrollér, at svarene stemmer overens med dataene fra din Shopify-butik, og at produktlinks åbner korrekt.

Installer chatbotten i din Shopify-butik

Sådan tilføjer du chat-widgetten til din Shopify-webshop:

1. I ChatLab skal du gå til fanen Deploy (Udrul) for din bot
2. Vælg platformfanen Shopify
3. Kopiér kodestykket
4. Gå til Online Store > Themes (Webshop > Temaer) i dit Shopify-kontrolpanel
5. Klik på menuen med de tre prikker ud for dit aktive tema, og vælg Edit code (Rediger kode)
6. Åbn filen theme.liquid under Layout
7. Indsæt kodestykket i sektionen <head>
8. Klik på Save (Gem)

Til sidst - du skal aktivere AI Actions tilgængelige for Shopify - Order details og Product Search.