Integration med Shoper: AI Search, direktsökning i butik och orderstatus

Koppla din ChatLab-chatbot till din Shoper-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 Shoper-katalog utifrån innebörd, eller via butikssökning i realtid, som gör förfrågningar direkt mot butikens API.

Exempel på konversation

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

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 chatbot för e-handel: Hur du ställer in ChatLab för din e-handelsbutik

Hur chatten hittar produkter på Shoper: AI Search och livebutikssökning

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

AI Search (rekommenderas) - ChatLab har ett eget index över din Shoper-katalog och chattbotten söker i det utifrån betydelse.

• 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 Shoper i samma stund som svaret ges, så att 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.
• Plan du behöver: ingår i alla E-commerce-planer (Free 100 produkter, Start 2 000, Grow 5 000, Scale 20 000). På en Universal-plan lägger du till tillägget E-commerce integrations ($30 i månaden) plus ett AI Search-produktpaket ($29 i månaden, 5 000 produkter) kopplat till chattbotten.

Livebutikssökning - chattbotten skickar kundens sökfras vidare till Shopers sökfunktion via butikens API och svarar med vad butiken returnerar.

• Ingenting indexeras och ingenting behöver synkroniseras. Informationen är alltid i realtid.
• Det är en nyckelordssökning: den hittar det som din butiks egen sökfunktion skulle hitta för den frasen. Den förstår inte beskrivningar av behov, synonymer eller stavfel på det sätt som AI Search gör.
• Plan du behöver: en Universal-plan med tillägget E-commerce integrations ($30 i månaden). Inget produktpaket behövs.

När AI Search är aktiverat ersätter det livebutikssökning. Orderstatus fungerar på samma sätt oavsett alternativ. Ett tredje alternativ, träning på skannade butikssidor, finns i alla planer och är avsett för informationsinnehåll som leverans 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

Livebutikssökning (produktsökning via fras) - Chattbotten skickar kundens fras till Shopers sökfunktion. Den söker bland produktnamn med fuzzy matching och returnerar upp till 10 matchande produkter med:

• Produktnamn och beskrivning
• Pris och SKU
• Direktlänk till produktsidan i din butik
• Produktbild
• Lagerstatus
• Valfritt: produktbilagor (PDF-filer, dokument)

Du kan också aktivera filtret för i lager för att endast visa produkter som för närvarande finns i lager.

Orderdetaljer - Kunder kan kontrollera sin orderstatus genom att ange ett order-ID och den e-postadress som hör till beställningen. Båda värdena valideras mot uppgifterna i din Shoper-butik. Chattbotten returnerar:

• Order-ID, datum och aktuell status
• Ordersumma och valuta
• Beställda artiklar med namn, antal och priser
• Leveransadress (gatuadress, postort, postnummer, land, telefonnummer)
• Fakturaadress
• Orderanteckningar

Två sätt att ansluta din butik

Det finns två sätt att ansluta Shoper till ChatLab:

• Metod 1: ChatLab-appen från Shoper App Store (rekommenderas) - installation med ett klick. Appen skapar anslutningen, aktiverar produktsökning och orderdetaljer samt lägger till chatt-widgeten i din storefront. Inga API-nycklar behöver kopieras.
• Metod 2: Manuell konfiguration - du skapar en WebAPI-administratör i Shoper och anger dess inloggningsuppgifter i ChatLab. Använd detta endast om du inte kan installera appen, eller om du vill ansluta butiken till en chatbot som du hanterar på ett specifikt sätt.

Välj en metod. Skapa inte en andra anslutning med metod 2 om appen redan har anslutit butiken.

Metod 1: Installera ChatLab-appen från Shoper App Store

Den kostnadsfria ChatLab-appen i Shoper App Store är det snabbaste sättet att komma igång. Du behöver inget befintligt ChatLab-konto eller någon chattbot - båda skapas åt dig under installationen.

1. Gå till Tillägg och integrationer > Applikationer (Add-ons and integrations > Applications) i din Shoper-administration, sök efter ChatLab - AI Chatbot for Customer Support and Sales och installera den
2. Öppna ChatLab-appen i din Shoper-administration - ChatLab-panelen öppnas i ett nytt fönster
3. Ange ditt lösenord (nytt konto) eller logga in med ditt befintliga ChatLab-konto
4. Om du startade i guiden för chattbotkonfiguration bekräftar du att butiken ska anslutas till den chattbotten; annars skapas en chattbot för butiken på ditt konto
5. Välj en plan eller stanna kvar på gratisplanen - du kan uppgradera senare under Konto > Prenumeration (Account > Subscription)

Det är allt. Butiken är ansluten, åtgärderna för produktsökning och orderinformation är aktiverade, och chattbotten visas i din butik så snart anslutningen är klar. Fortsätt med Konfigurera Shoper-åtgärder nedan för att granska åtgärderna, eller öppna Deploy > Shoper i ChatLab för att se samma installationssteg igen.

Metod 2: Manuell konfiguration

Använd den här metoden om du inte kan installera appen. Innan du börjar, kontrollera att:

• Din ChatLab-prenumeration inkluderar Shoper-integrationen
• Du har åtkomst till din Shoper-adminpanel
• Din chatbot redan är skapad i ChatLab

Den manuella konfigurationen ansluter endast butiksdata. Chattwidgeten måste läggas till separat i din butik, se Installera chatbot i din Shoper-butik i slutet av denna artikel.

Steg 1: Skapa en administratörsgrupp

1. I din Shoper-adminpanel går du till Inställningar > Butiksadministratörer (Settings > Store administrators)

2. Klicka på MER (MORE) > Lägg till administratörsgrupp (Add administrators group)

3. Ange ett namn för gruppen (t.ex. "ChatLab Integration"), välj åtkomsttyp: 'åtkomst till webapi' (access to webapi) och spara

Steg 2: Konfigurera gruppbehörigheter

1. Öppna den nyskapade gruppen och gå till behörighetsinställningarna
2. Ge behörigheten Läs (Read) till följande resurser:
   • Försäljning (Sales) - läs
   • Katalog (Catalog) - läs
   • Konfiguration (Configuration) - läs

Steg 3: Lägg till en API-administratör

1. Gå till Administratörer (Administrators) och klicka på Lägg till administratör (Add administrator)

2. Fyll i inloggningsnamn och lösenord, och tilldela administratören till gruppen som skapades i steg 1

3. Spara administratören. Anteckna inloggningsnamn och lösenord - du behöver dem i nästa steg.

Steg 4: Anslut Shoper i ChatLab

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

3. Klicka på Connect på Shoper-rutan
4. Ange din Shop URL (din Shoper-domän, t.ex. myshop.shoper.pl)
5. Ange ditt WebAPI Login (från steg 3)
6. Ange ditt WebAPI Password (från steg 3)

7. Klicka på Initialize Configuration - detta hämtar tillgängliga språk från din butik
8. Välj rätt Shop Language i rullgardinsmenyn (detta avgör vilken språkversion av produktdata som returneras)
9. Klicka på Connect

ChatLab testar automatiskt anslutningen genom att göra en testsökning efter produkter. Om det lyckas ser du ett bekräftelsemeddelande, och åtgärderna för både produktsökning och orderinformation aktiveras som standard.

Konfigurera Shoper-åtgärder

När du har anslutit med någon av metoderna kan du aktivera och anpassa enskilda AI-åtgärder. Gå till Settings > Actions (Inställningar > Åtgärder) och filtrera på plattformen Shoper.

Standardåtgärderna inkluderar:

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

Anslutningen aktiverar standardåtgärderna automatiskt. Kontrollera 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ärdens etikett (meddelandet som visas för användarna medan åtgärden körs) och instruktionerna som styr hur AI:n använder varje åtgärd.

För produktsökning klickar du på knappen Edit (Redigera) och går till fliken Product Search Settings (Inställningar för produktsökning). Två ytterligare alternativ finns tillgängliga:

• Include product attachments - när det är aktiverat inkluderar chatbotten produktbilagor (PDF-filer, dokument) i sökresultaten
• Products in stock only - när det är aktiverat returnerar chatbotten endast produkter som för närvarande finns i lager

AI Search för Shoper: 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 direkt sökning i butiken (live store search). Indexeringen startar automatiskt när butiken ansluts.

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

Om katalogen är större än produktgränsen avbryts indexeringen vid gränsen och chattbottens ägare får ett e-postmeddelande. Alternativen för direkt butikssökning 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 provar följande:

• "Visa mig löparskor" (testar produktsökning)
• "Vad har min beställning 12345 för status?" (testar orderdetaljer; ange den matchande e-postadressen för en beställning du har behörighet att komma åt)

Kontrollera att svaren stämmer överens med uppgifterna från din Shoper-butik och att produktlänkarna öppnas korrekt.

Installera chattboten i din Shoper-butik

Om du använde Metod 1 (appen) finns chattwidgeten redan i din butik och du behöver inte lägga till något. Om du använde Metod 2 (manuell konfiguration), öppna Deploy > Shoper i ChatLab, växla till Manual Installation (manuell installation), kopiera koden och klistra in den i din Shoper-administration under Add-ons and integrations > Custom integrations (Tillägg och integrationer > Anpassade integrationer) i fältet Page header (sidhuvud). Se Lägga till chattbot på din webbplats för mer information.

Relaterade artiklar

• AI Search: så hittar din chatbot produkter
• E-commerce-abonnemang och gränser
• Konfigurationsguide för e-handel
• Lägga till chatbot på din webbplats