Integrera med Shopify

Koppla din ChatLab-chattbot till din Shopify-butik för att ge kunderna direkt tillgång till produktinformation och orderspårning i realtid direkt i chatten.

Viktigt: Bästa praxis för e-handel

När du har slutfört integrationen nedan bör du läsa den omfattande guiden om hur du optimerar din chattbot för e-handel: Hur du ställer in ChatLab för din e-handelsbutik

Vad integrationen erbjuder

Product Search - Kunder kan söka i din Shopify-katalog genom att skriva in en fras. Chattbotten söker igenom produkttitlar, beskrivningar, typer, taggar och leverantörer, och returnerar matchande aktiva produkter med:

• Produktnamn, beskrivning och typ
• Leverantör och taggar
• Pris eller prisintervall (för produkter med flera varianter)
• Tillgängliga varianter med SKU, ordinarie pris (compare-at price), lagersaldo och tillgänglighetsstatus
• Produktbild och direktlänk till din butik

Du kan konfigurera produktsökningen så att den endast visar produkter i lager. När det är aktiverat exkluderas slutsålda artiklar från resultaten. Ett ytterligare alternativ låter dig inkludera produkter som är tillgängliga för förbeställning även när lagerfiltret är aktivt. Se Steg 4 för detaljer.

Order Details - Kunder kan kontrollera orderstatus genom att ange sitt ordernummer och sin e-postadress. Båda värdena valideras mot uppgifterna i din Shopify-butik. Chattbotten returnerar:

• Orderreferens, datum, totalsumma och valuta
• Beställda artiklar med namn, antal, priser, SKU, varianttitel och leverantör
• Leveransstatus och spårningsinformation (nummer, speditör, webbadress)
• Leveransadress och faktureringsadress
• Fraktmetod och fraktkostnad
• Kundens kontaktuppgifter (e-post, namn, telefon)
• Orsak och datum för avbokning (för avbrutna beställningar)

Steg 1: Skapa API-inloggningsuppgifter i Shopify

Viktigt för byråer och Shopify-partner: Shopify-appen MÅSTE skapas i Dev Dashboard för den organisation som äger butiken - börja alltid från butikens egen administration (Settings > Apps > Develop apps > Build apps in Dev Dashboard). En app som skapas av en annan organisation (till exempel en byrå eller Shopify-partner som arbetar i sin egen Dev Dashboard) och installeras i butiken via en anpassad installationslänk kommer INTE att fungera med ChatLab, även om installationen lyckas och appen syns bland butikens installerade appar med rätt behörigheter. Orsaken är att ChatLab ansluter med Client ID och Secret (Shopifys flöde för klientautentiseringsuppgifter, client credentials grant), och Shopify tillåter endast detta flöde för appar som utvecklats av organisationen som äger butiken - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (Shopify-dokumentation). Detta är en begränsning i Shopify, inte i ChatLab. Symtomet är ett anslutningsfel i ChatLab med meddelandet "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (orsakat av Shopifys OAuth-fel shop_not_permitted), även när Client ID, Secret och butikens underdomän är helt korrekta och appen är installerad. Ett tydligt tecken på en app från en annan organisation är att det står "This custom app was built by a Shopify partner for your store" i butiksadministrationen. Lösningen för byråer: du behöver inte be handlarens utvecklare göra det - be i stället handlaren att lägga till din användare i DERAS 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), och skapa sedan appen medan du arbetar i handlarens organisation. Enbart samarbetsåtkomst (collaborator access) räcker inte - appar som skapas medan du arbetar i din egen organisation stannar kvar i din organisation.

1. Logga in på din administrationspanel i Shopify
2. Gå till Settings > Apps
3. Klicka på Develop apps
4. På sidan App Development klickar du på Build apps in Dev Dashboard - detta öppnar dev.shopify.com/dashboard
5. Klicka på Create app och ange ett namn (t.ex. "ChatLab Integration")

6. När den är skapad skrollar du till avsnittet Access och klickar på Select scopes

7. Under åtkomstomfång för Admin API letar du upp och aktiverar följande behörigheter:
   • read_products
   • read_orders
8. Klicka på Done

9. Klicka på knappen Release för att publicera din app
10. Gå till App settings och kopiera Client ID och Secret - spara dessa på ett säkert ställe, du behöver dem för att ansluta till ChatLab

11. Gå till avsnittet Home och klicka för att installera applikationen i din butik

12. Välj din butik och bekräfta genom att klicka på Install

Steg 2: Hitta din butiks underdomän

Din underdomän är delen före .myshopify.com i din Shopify-administrationsadress. Om din adress till administrationen till exempel är https://pizza-delicious.myshopify.com/admin, så är din underdomän pizza-delicious.

Steg 3: Anslut Shopify i ChatLab

1. Logga in på ChatLab och välj din bot
2. Gå till fliken Connect (Anslut)

3. Klicka på Connect (Anslut) på Shopify-rutan
4. Ange ditt Client ID (från steg 1)
5. Ange din Secret (från steg 1)
6. Ange din Shopify subdomain (Shopifys underdomän, från steg 2)

7. Klicka på Connect (Anslut)

ChatLab testar anslutningen automatiskt genom att verifiera att dina API-inloggningsuppgifter har de nödvändiga behörigheterna. Om det lyckas visas ett bekräftelsemeddelande.

Steg 4: Konfigurera Shopify-åtgärder

Efter anslutningen kan du aktivera och anpassa enskilda AI-åtgärder. Navigera till Settings > Actions (Inställningar > Åtgärder) och filtrera på Shopify-plattformen.

Två åtgärder är tillgängliga:

• Shopify - product search - gör det möjligt för chattbotten att söka i din produktkatalog
• Shopify - order details - gör det möjligt för chattbotten att slå upp orderinformation

Klicka på aktiveringsknappen för respektive åtgärd för att aktivera den. Du kan också anpassa åtgärdens etikett (meddelandet som visas för användare medan åtgärden körs) och instruktionerna som styr hur AI:n använder varje åtgärd.

Product Search - Lagerinställningar

Åtgärden för produktsökning innehåller alternativ för lagerfiltrering under fliken Product Search Settings (Inställningar för produktsökning):

• Products in stock only - När det är aktiverat returnerar chattbotten endast produkter som för närvarande finns i lager. Slutsålda produkter exkluderas från sökresultaten.
• Show products available for pre-order - Det här alternativet visas när "Products in stock only" är aktiverat. När det är aktivt visas produkter som är slut i lager men inställda på att fortsätta säljas (förbeställning) i Shopify ändå i sökresultaten, märkta som tillgängliga för förbeställning.

Testa din integration

När du har aktiverat åtgärderna öppnar du din chattbot-widget och provar att skriva:

• "Show me running shoes" (testar produktsökning)
• "What's the status of my order #1001?" (testar orderinformation)

Kontrollera att svaren matchar uppgifterna från din Shopify-butik och att produktlänkarna öppnas korrekt.

Installera chattbotten i din Shopify-butik

För att lägga till chatt-widgeten på din Shopify-webbplats:

1. Gå till fliken Deploy (Publicera) för din bot i ChatLab
2. Välj plattformsfliken Shopify
3. Kopiera kodfragmentet
4. Gå till Online Store > Themes i din Shopify-administration
5. Klicka på menyn med tre punkter vid ditt aktiva tema och välj Edit code
6. Öppna filen theme.liquid under Layout
7. Klistra in kodfragmentet inuti taggen <head>
8. Klicka på Save

Avslutningsvis - du behöver aktivera tillgängliga AI-åtgärder för Shopify - Order details och Product Search.