Integration med CS-Cart: AI Search, direktsökning i butiken och orderstatus

Koppla ihop din ChatLab-chatbot med din CS-Cart-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 CS-Cart-katalog utifrån betydelse, eller via direktsökning i butiken, som gör förfrågningar direkt mot butikens API.

Exempel på konversation

Exemplet illustrerar kundupplevelsen. Vilka åtgärder som är tillgängliga och vilken information som returneras 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 bör du kontrollera 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 chatten hittar produkter på CS-Cart: AI Search och livesökning i butiken

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

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

• Kunder frågar i vanligt talsprå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 av live från CS-Cart precis när 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 inga 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.

Livesökning i butiken - chattbotten skickar vidare kundens sökfras till CS-Carts sökfunktion via butikens API och svarar med vad butiken returnerar.

• Inget indexeras och inget behöver synkroniseras. Informationen är alltid i realtid.
• Det är en nyckelordssökning: den hittar vad din butiks vanliga sökning skulle hitta för den frasen. Den förstår inte beskrivningar av behov, synonymer eller stavfel på samma 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 livesökningen i butiken. Orderstatus fungerar på samma sätt med båda metoderna. Ett tredje alternativ, träning på skannade butikssidor, finns tillgängligt på 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 ger

Direktsökning i butiken (produktsökning via fras) - Chattbotten skickar kundens fras till sökfunktionen i CS-Cart och returnerar matchande produkter med:

• Produktnamn och beskrivning
• Pris
• SKU (produktkod)
• Direktlänk till produkten i din butik
• Produktbild
• Tillgängliga varianter (storlekar, färger osv.)

Du kan konfigurera vilka produktfält som ska genomsökas (namn, kort beskrivning, fullständig beskrivning, nyckelord) och hur många resultat som ska returneras.

Orderdetaljer - Kunder kan kontrollera orderstatus genom att ange sitt order-ID och sin e-postadress. Chattbotten returnerar:

• Orderstatus
• Beställda artiklar med namn, priser, antal, produktbilder och valda varianter
• Ordersumma och fraktkostnad
• Fraktbolag, spårningsnummer och leveransstatus
• Mottagarens namn och fullständig leveransadress
• Kundens telefonnummer

Steg 1: Aktivera API-åtkomst i CS-Cart

1. Logga in på din administrationspanel i CS-Cart
2. Gå till Customers > Administrators (Kunder > Administratörer)

3. Klicka på administratörskontot som ska användas för API-anslutningen
4. Byt till fliken API access (API-åtkomst)
5. Markera "Yes, allow this user to use the API" ("Ja, tillåt denna användare att använda API:et")
6. Klicka på Save (Spara)

7. Kopiera den API key (API-nyckel) som visas efter att du har sparat - förvara den på ett säkert ställe
8. Notera den email address (e-postadress) som är kopplad till detta administratörskonto

Steg 2: Anslut CS-Cart i ChatLab

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

3. Klicka på Connect (Anslut) på CS-Cart-rutan
4. Ange din API Key (från steg 1)
5. Ange din Account Email (administratörens e-postadress med API-åtkomst)
6. Ange din Shop Url (t.ex. https://yourstore.com)

Du kan också konfigurera sökalternativ:

• Searchable fields (Sökbara fält) - välj vilka produktfält chattbotten ska söka igenom (produktnamn, kort beskrivning, fullständig beskrivning, sökord)
• Number of search results (Antal sökresultat) - hur många produkter som ska returneras per sökning (standard: 5)

7. Klicka på Connect

Efter en lyckad anslutning ser du ett bekräftelsemeddelande med möjlighet att konfigurera AI-åtgärder.

Steg 3: Konfigurera CS-Cart-åtgärder

Efter anslutningen aktiverar och anpassar du enskilda AI-åtgärder. Gå till Settings > Actions (Inställningar > Åtgärder) och filtrera på plattformen CsCart.

Standardåtgärderna omfattar:

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

Anslutningsprocessen aktiverar standardåtgärderna. Granska deras status och inaktivera dem 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ändarna medan åtgärden körs) och instruktionerna som styr hur AI:n använder varje åtgärd.

AI Search för CS-Cart: katalog, omindexering och inställningar

Med en E-commerce-plan, eller med en Universal-plan när ett produktpaket för AI Search är tilldelat chattbotten, är AI Search aktiverat och ersätter direktsö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 visas panelen Product catalog och kortet AI Search packs on this chatbot.
• Schemalägg omindexering - använd Schedule auto-retrain under Training > E-commerce catalog. Omindexering kan köras så ofta som dagligen och är tillgänglig på alla E-commerce-planer samt med alla produktpaket. Train now eller Retrain kör den manuellt vid behov. Uppdateringarna sker inkrementellt: oförändrade produkter hoppas över och borttagna produkter raderas från indexet.
• Granska åtgärden - öppna CsCart - AI product search under Settings > Actions (Inställningar > Åtgärder). Dess alternativ är Include product card, Products in stock only och Number of products to return.
• 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 stoppas indexeringen vid gränsen och chattbottens ägare får ett e-postmeddelande. Alternativen för åtgärden för butikens direktsö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:

• "Visa mig träningshandskar" (testar produktsökning)
• "Vad är statusen för min order 12345?" (testar orderuppgifter; ange den matchande e-postadressen för en order du har behörighet att se)

Kontrollera att svaren stämmer överens med data från din CS-Cart-butik.

Tips för sökkonfiguration

• Aktivera Product name och Short description för bästa balans mellan hastighet och precision
• Lägg till Keywords om dina produkter har rikligt med metadata i form av sökord
• Aktivera endast Full description om kortare fält inte ger bra resultat - det kan göra sökningarna långsammare
• Börja med 5 resultat per sökning och justera utifrån storleken på din katalog

Installera chattbotten i din CS-Cart-butik

För att lägga till chattwidgeten på din CS-Cart-webbplats:

1. I ChatLab går du till fliken Deploy (Driftsätt) för din bot
2. Välj plattformsfliken CS-Cart
3. Kopiera kodfragmentet
4. I CS-Cart-administrationen går du till Design > Layouts (Design > Layouter)
5. Lägg till ett HTML block (HTML-block) i standardlayouten och klistra in widgetens kodfragment i dess flik Content (Innehåll)
6. Spara blocket och layoutändringarna. Kontrollera sidor med separata layouter, till exempel kassan, samt alla butiksspråk

Om du använder ett HTML-block med Smarty-stöd omsluter du kodfragmentet med {literal} och {/literal}. Se CS-Carts instruktioner för anpassad kod. Öppna den publicerade butiken och kontrollera widgeten på både dator och mobil.

Relaterade artiklar

• AI Search: hur din chatbot hittar produkter
• E-commerce-planer och gränser
• Guide för att komma igång med e-handel
• Lägg till en chatbot på din webbplats