Integration med Shopify: AI Search, direktsökning i butiken och orderstatus

Koppla din ChatLab-chatbot till din Shopify-butik så att kunderna kan hitta produkter och kontrollera sina beställningar direkt i chatten. Produkter hittas via AI Search, som söker i din indexerade Shopify-katalog utifrån betydelse, eller via direktsökning i butiken, som gör förfrågningar mot butikens API.

Exempel på konversation

Exemplet illustrerar kundupplevelsen. Tillgängliga åtgärder och returnerad information beror på denna integration och din konfiguration.

Innan du börjar

Skapa eller välj en chattbot först. Du behöver behörighet att hantera dess integrationer och åtkomst till det externa kontots anslutningsinställningar. Om Connect-rutan visar en uppmaning om uppgradering eller kontakt kontrollerar du att din prenumeration inkluderar denna integration. Håll API-uppgifterna hemliga; klistra aldrig in dem i webbplatsens inbäddningskod.

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

Hur chatboten hittar produkter på Shopify: AI Search och direktbutikssökning

Det finns två sätt för en ChatLab-chatbot att hitta produkter i en Shopify-butik. En chatbot använder det ena eller det andra, aldrig båda.

AI Search (rekommenderas) - ChatLab har ett eget index över din Shopify-katalog och chatboten söker i det utifrån innebörd.

• Kunder frågar på vanligt vardagsspråk, till exempel "en röd klänning under 300". Ett prisintervall tillämpas som ett strikt filter, och exakta produktkoder (SKU, EAN) matchas också.
• Pris, lagerstatus och varianter läses in live från Shopify i samma stund som svaret ges, så kunderna ser aktuell information även mellan indexuppdateringar.
• Resultaten visas som produktkort i chatten, upp till 5 per svar.
• Indexeringen startar automatiskt när butiken ansluts. Katalogen förbrukar inte träningstecken.
• Abonnemang du behöver: alla E-commerce-planer inkluderar det (Free 100 produkter, Start 2 000, Grow 5 000, Scale 20 000). På en Universal-plan lägger du till tillvalet E-commerce integrations ($30 i månaden) plus ett AI Search-produktpaket ($29 i månaden, 5 000 produkter) kopplat till chatboten.

Direktbutikssökning (live store search) - chatboten skickar kundens sökfras direkt till Shopifys sökfunktion via butikens API och svarar med det som butiken returnerar.

• Inget indexeras och inget behöver synkroniseras. Datan är alltid aktuell i realtid.
• Det är en nyckelordssökning: den hittar det som din butiks egen sökfunktion skulle hitta för frasen. Den förstår inte behovsbeskrivningar, synonymer eller stavfel på samma sätt som AI Search.
• Abonnemang du behöver: en Universal-plan med tillvalet E-commerce integrations ($30 i månaden). Inget produktpaket krävs.

När AI Search är aktiverat ersätter det direktbutikssökning. Orderstatus fungerar på samma sätt i båda alternativen. Ett tredje alternativ, träning på skannade butikssidor, finns i alla planer och är avsett för informationsinnehåll som leveranser och returer, inte för produkter. För en fullständig jämförelse, se AI Search: how your chatbot finds products, och för produktgränser, se E-commerce plans and limits.

Vad integrationen erbjuder

Live store search (produktsökning på fras) - Chattbotten skickar kundens sökfras till Shopify-sökningen. Den söker igenom produkttitlar, beskrivningar, produkttyper, taggar och leverantörer, och returnerar matchande aktiva produkter med:

• Produktnamn, beskrivning och produkttyp
• Leverantör och taggar
• Pris eller prisintervall (för produkter med flera varianter)
• Tillgängliga varianter med SKU, jämförelsepris, lagersaldo och tillgänglighetsstatus
• Produktbild och direktlänk till din butik

Du kan ställa in produktsökningen så att den bara visar produkter i lager. När detta är aktiverat exkluderas slutsålda artiklar från resultaten. Ett tilläggsalternativ låter dig inkludera produkter som kan förbeställas även när lagerfiltret är aktivt. Se Steg 4 för mer information.

Order Details (orderuppgifter) - Som standard anger kunden sitt ordernummer och matchande e-postadress. Tillvalsinställningar tillåter sökning på enbart order-ID eller senaste beställningar på enbart e-postadress. Dessa är datamatchningar, inte ett bevis på besökarens identitet. Chattbotten returnerar:

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

Steg 1: Skapa Shopify API-inloggningsuppgifter

Viktigt för byråer och Shopify-partner: Skapa och installera appen i den organisation som äger butiken. ChatLabs anslutning med Client ID och Secret använder Shopifys klientbehörighetsbeviljande (client credentials grant), vilket inte stöder en app som ägs av en annan organisation. Om du ser "The app cannot access this store" kontrollerar du appens organisation och installation innan du byter ut uppgifterna. Se Shopifys krav för klientbehörigheter.

1. Logga in på din administratörspanel i Shopify
2. Gå till Settings > Apps (Inställningar > Appar)
3. Klicka på Develop apps (Utveckla appar)
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 har skapats bläddrar du till avsnittet Access och klickar på Select scopes

7. Under Admin API-behörighetsomfång (access scopes), leta upp och aktivera dessa behörigheter:
   • read_products
   • read_orders
8. Klicka på Done

9. Klicka på knappen Release för att släppa din app
10. Gå till App settings och kopiera Client ID och Secret - spara dessa på ett säkert sätt, 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

Hitta butikens myshopify.com-domän under Settings > Domains i Shopify, och ange sedan enbart delen före .myshopify.com. För pizza-delicious.myshopify.com anger du pizza-delicious, inte din anpassade storefront-domän eller URL:en till översikten på admin.shopify.com. Se Shopifys domänguide.

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 (klient-ID från steg 1)
5. Ange din Secret (hemliga nyckel från steg 1)
6. Ange din Shopify subdomain (Shopify-underdomän från steg 2)

7. Klicka på Connect (Anslut)

ChatLab testar automatiskt anslutningen genom att kontrollera att dina API-uppgifter har de behörighetsomfång som krävs. Om det lyckas visas ett bekräftelsemeddelande.

Steg 4: Konfigurera Shopify-åtgärder

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

Standardåtgärderna inkluderar:

• 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

När anslutningen konfigureras aktiveras standardåtgärderna. Granska deras status och inaktivera de som du inte vill att kunderna ska använda. Öppna en åtgärd för att redigera den och använd sedan Enable (Aktivera) eller Update (Uppdatera) i dess dialogruta. Du kan också anpassa åtgärdsetiketten (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 inkluderar alternativ för lagerfiltrering under fliken Product Search Settings:

• Products in stock only - När detta ä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 kommer produkter som är slutsålda men inställda på att fortsätta säljas (förhandsbeställning) i Shopify ändå att visas i sökresultaten, märkta som tillgängliga för förhandsbeställning.

Integritet vid ordersökning

I orderåtgärdens Order Lookup Configuration är både Allow order lookup without email verification och Allow order lookup by email address only avstängda som standard. Läget med enbart e-post returnerar som standard 1 nyligen lagd beställning, vilket kan konfigureras från 1-3. Aktivering av sökning med enbart ID inaktiverar läget för enbart e-post. Den som känner till den valda identifieraren kan komma åt orderinformation, så granska dina åtkomstkontroller och maskering av personuppgifter (PII) innan du aktiverar något av alternativen.

AI Search för Shopify: katalog, återindexering och inställningar

Med en E-commerce-plan, eller med en Universal-plan när ett AI Search-produktpaket har tilldelats chattbotten, är AI Search aktiverat och ersätter direktbutikssökning i realtid. Indexeringen startar automatiskt när butiken ansluts.

• Kontrollera katalogen - öppna Träning > E-handelskatalog (Training > E-commerce catalog) och granska flikarna Produkter (Products) och Kategorier (Categories). Under Butik > Produkter (Shop > Products) visas panelen Produktkatalog (Product catalog) och kortet AI Search-paket på denna chatbot (AI Search packs on this chatbot).
• Schemalägg återindexering - använd Schemalägg automatisk omträning (Schedule auto-retrain) under Träning > E-handelskatalog (Training > E-commerce catalog). Återindexering kan köras så ofta som dagligen och är tillgänglig på alla E-commerce-planer och med varje produktpaket. Med Träna nu (Train now) eller Träna om (Retrain) körs den vid behov. Uppdateringarna är inkrementella: oförändrade produkter hoppas över och borttagna produkter raderas från indexet.
• Granska åtgärden - öppna Shopify - AI-produktsökning (Shopify - AI product search) under Inställningar > Åtgärder (Settings > Actions). Dess alternativ är Inkludera produktkort (Include product card), Endast produkter i lager (Products in stock only) och Antal produkter att returnera (Number of products to return).
• Visa produktkort - aktivera Aktivera Offer Cards (Enable Offer Cards) under Inställningar > Modell & avancerat (Settings > Model & Advanced). Se Offer Cards.

Om katalogen är större än produktgränsen stoppas indexeringen vid gränsen och chattbottens ägare får ett e-postmeddelande. Alternativen för den direktbutikssökningsåtgärd som beskrivs ovan gäller inte nödvändigtvis för AI Search.

Testa din integration

När du har aktiverat åtgärderna öppnar du Overview (Översikt) och testar:

• "Visa mig löparskor" (testar produktsökning)
• "Vad är statusen för min beställning #1001?" (testar orderdetaljer; ange matchande e-postadress för en beställning du har behörighet att se)

Kontrollera att svaren stämmer överens med informationen från din Shopify-butik och att produktlänkarna fungerar korrekt.

Installera chattbotten i din Shopify-butik

Så här lägger du till chattwidgeten i din Shopify-butik:

1. I ChatLab, gå till fliken Deploy (Publicera) för din bot
2. Välj plattformsfliken Shopify
3. Välj Widget och kopiera kodstycket
4. I din Shopify-admin, gå till Online Store > Themes (Webbutik > Teman)
5. Klicka på trepunktsmenyn på ditt aktiva tema och välj Edit code (Redigera kod)
6. Öppna filen theme.liquid under Layout
7. Klistra in kodstycket i sektionen <head>
8. Klicka på Save (Spara)

Öppna den publicerade butiken för att bekräfta att widgeten läses in. API-anslutningen och storefront-installationen är separata; granska de aktiverade åtgärderna i Settings > Actions.

Relaterade artiklar

• AI Search: hur din chatbot hittar produkter
• E-commerce-planer och gränser
• Kom igång med e-commerce
• Lägg till chatbot på din webbplats