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

Koppla ihop din ChatLab-chattbot med din PrestaShop-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 PrestaShop-katalog baserat på betydelse, eller via live-butikssökning, som frågar 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.

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å PrestaShop: AI Search och direktbutikssökning

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

AI Search (rekommenderas) - ChatLab har ett eget index över din PrestaShop-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, lager och varianter läses in live från PrestaShop 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 inga träningstecken.
• Abonnemang som krävs: ingår i alla E-commerce-abonnemang (Free 100 produkter, Start 2 000, Grow 5 000, Scale 20 000). På ett Universal-abonnemang 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.

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

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

När AI Search är aktiverat ersätter det direktbutikssökningen. Orderstatus fungerar på samma sätt på båda vägarna. Ett tredje alternativ, träning på skannade butikssidor, är tillgängligt i alla abonnemang 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: hur din chattbot hittar produkter, och för produktgränser, se E-commerce-abonnemang och gränser.

Vad integrationen erbjuder

Livebutikssökning (produktsökning via fras) - Chattbotten skickar kundens fras till sökfunktionen i PrestaShop. Den söker igenom produkttitlar och beskrivningar och returnerar de 5 bäst matchande produkterna med:

• Produkt-ID, namn och beskrivning
• Pris (valfritt med moms och specifika prisavdrag tillämpade)
• Direktlänk till produktsidan i din butik
• Produktbild

Produktsökning via referens (SKU) - Kunder kan söka efter produkter med hjälp av exakta referenskoder. Chattbotten söker över flera typer av identifierare - referens/SKU, EAN-13-streckkod, ISBN och MPN - på både produkter och deras varianter (kombinationer). Detta är praktiskt när kunder har en specifik produktkod från en katalog, faktura eller förpackning.

Orderuppgifter - Som standard anger kunden ett order-ID och e-postadressen som är kopplad till beställningen. Båda matchas mot butikens register; detta utgör inget bevis på ägandeskap av e-postadressen. Den valfria inställningen Allow order lookup without email verification (Tillåt ordersökning utan e-postverifiering) tillåter sökning med enbart order-ID. Låt den vara inaktiverad såvida din implementering inte har lämpliga åtkomstkontroller. Chattbotten returnerar:

• Orderreferens, datum och aktuell status (t.ex. behandlas, slutförd, avbruten)
• Ordersumma
• Mottagarens namn, företag, fullständig leveransadress (gata, stad, postnummer) och telefonnummer
• Namn på fraktbolag och spårningsnummer (stöd för flera spårningsnummer finns)
• Beställda artiklar med namn, antal och styckpriser

Förutsättningar

Innan du påbörjar PrestaShop-integrationen, kontrollera att:

• Din chattbot är skapad i ChatLab. Anslutning av butiksdata och installation av widget är separata steg; modulen kan hantera båda.
• Du har tillgång till din PrestaShop-adminpanel (back office)

Rekommenderas: Anslut med modulen

För en ny installation rekommenderas den guidade PrestaShop-modulinstallationen. Med Connect my store (Anslut min butik) kan du logga in på ChatLab och välja din chattbot. De manuella stegen för webbtjänsten nedan är ett alternativ; skapa inte en andra koppling om modulen redan har anslutit butiken.

Steg 1: Aktivera webbtjänsten i PrestaShop

1. Logga in på PrestaShops back office
2. Gå till Configure > Advanced Parameters > Webservice (Konfigurera > Avancerade parametrar > Webbtjänst)

3. Rulla ner till avsnittet Configuration (Konfiguration)
4. Sätt Enable PrestaShop's webservice (Aktivera PrestaShops webbtjänst) till Yes (Ja)
5. Klicka på Save (Spara)

Steg 2: Skapa en webbtjänstnyckel

1. På samma Webservice-sida klickar du på Add new webservice key (Lägg till ny webbtjänstnyckel)

2. Klicka på Generate (Generera) för att skapa en ny nyckel
3. Ange en beskrivning (t.ex. "ChatLab Integration")
4. Kontrollera att nyckeln är satt till Enabled (Aktiverad)
5. Under resursbehörigheter ger du behörigheten View (GET) (Visa [GET]) för följande resurser:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • shops
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Klicka på Save (Spara)
7. Kopiera den genererade webbtjänstnyckeln - du kommer att behöva den i nästa steg

Steg 3: Hitta ditt URL-format för produkter

1. I PrestaShops back office går du till Configure > Shop Parameters > Traffic & SEO (Konfigurera > Butiksparametrar > Trafik och SEO)

2. Rulla ner till avsnittet Schema of URLs (URL-schema)
3. Kopiera värdet från fältet Route to products (Sökväg till produkter) (t.ex. {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Steg 4: Anslut PrestaShop i ChatLab

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

3. Klicka på Connect (Anslut) på PrestaShop-rutan
4. Ange din Webservice key (Webbtjänstnyckel, från steg 2)
5. Ange din Shop url (Butikens URL, hela webbadressen till din butik, t.ex. https://www.mystore.com)
6. Ange ditt Product url format (URL-format för produkter, från steg 3)

7. Klicka på Initialize Configuration (Initiera konfiguration) - detta hämtar tillgängliga språk och butiker från din installation
8. Välj rätt Default language (Standardspråk) och, om alternativet visas, avsedd Prestashop store (PrestaShop-butik)
9. Klicka på Connect (Anslut)

ChatLab testar anslutningen automatiskt genom att verifiera att din webbtjänstnyckel har nödvändig åtkomst. Om det lyckas visas ett bekräftelsemeddelande.

Steg 5: Konfigurera PrestaShop-å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å PrestaShop-plattformen.

Följande åtgärder är tillgängliga:

• Prestashop - product search - gör det möjligt för chattbotten att söka i din produktkatalog efter namn
• Prestashop - search by reference - gör det möjligt för chattbotten att hitta produkter via referens/SKU-, EAN-13-, ISBN- eller MPN-koder
• Prestashop - order details - gör det möjligt för chattbotten att slå upp orderinformation
• Prestashop - get product variants - gör det möjligt för chattbotten att hämta detaljerad variantinformation (storlekar, färger) för en specifik produkt

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 dialogrutan. 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.

När åtgärden "Search by reference" är aktiverad faller den vanliga produktsökningen automatiskt tillbaka på en referenskodssökning om inga resultat hittas på namn. Det innebär att kunder kan ange en SKU eller streckkod i en vanlig sökfråga och ändå få korrekta resultat.

Visa produkter med påfyllningsdatum (förbeställning)

När "Products in stock only" (Endast produkter i lager) är aktiverat i inställningarna för åtgärden Product Search kan du dessutom aktivera "Show products with restock date" (Visa produkter med påfyllningsdatum). Detta gör att chattbotten kan inkludera produkter som inte finns i lager men som har ett förväntat påfyllningsdatum angivet i PrestaShop. Istället för att dölja dessa produkter helt informerar chattbotten kunden om påfyllningsdatumet och att produkten är tillgänglig för förbeställning.

Krav:

• PrestaShop måste ha "Allow ordering of out-of-stock products" (Tillåt beställning av produkter som inte finns i lager) aktiverat (Shop Parameters > Product Settings)
• Webbtjänstnyckeln måste ha View (GET)-åtkomst till resurserna combinations och configurations
• Produkter måste ha ett available_date angivet på sina kombinationer i PrestaShop

Priser inklusive moms

Aktivera reglaget "Apply tax (VAT) to prices" (Tillämpa skatt [moms] på priser) i inställningarna för åtgärden Product Search för att visa priser inklusive moms. När detta är aktiverat beräknar chattbotten priser med hjälp av momsregler från din PrestaShop-butik baserat på butikens standardland. Jämför resultatet med priserna i din webbutik. Kundspecifika momsregler, plats och kassajusteringar kan fortfarande ge andra totalsummor.

Krav:

• Webbtjänstnyckeln måste ha View (GET)-åtkomst till resurserna taxes, tax_rules, tax_rule_groups och configurations

Specifika priser (rabatter och kampanjer)

Aktivera reglaget "Apply specific prices (discounts/promotions)" (Tillämpa specifika priser [rabatter/kampanjer]) i inställningarna för åtgärden Product Search för att visa rabatterade priser från PrestaShops specifika prisregler. När en rabatt är aktiv för en produkt visar chattbotten både det rabatterade priset och det ursprungliga priset, så att kunderna kan se besparingen.

Detta omfattar universella specifika prisregler - kampanjer och reor som gäller alla kunder med en minsta kvantitet på 1. Tidsbegränsade kampanjer stöds också; chattbotten tillämpar endast rabatter som för närvarande är aktiva baserat på deras start- och slutdatum.

Krav:

• Webbtjänstnyckeln måste ha View (GET)-åtkomst till resurserna specific_prices och specific_price_rules

AI Search för PrestaShop: 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 livesökning i butiken. 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). Shop > Products (Butik > Produkter) visar panelen Product catalog (Produktkatalog) och kortet AI Search packs on this chatbot (AI Search-paket på denna chattbot).
• 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å alla E-commerce-planer samt med alla produktpaket. Train now (Träna nu) eller Retrain (Träna om) kör den vid behov. Uppdateringarna är inkrementella: oförändrade produkter hoppas över och borttagna produkter raderas från indexet.
• Granska åtgärden - öppna Prestashop - 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.

När katalogen är större än produktgränsen stoppas indexeringen vid gränsen och chattbottens ägare får ett e-postmeddelande. Alternativ för livesökningsåtgärden 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 följande:

• "Visa mig löparskor" (testar produktsökning)
• "Jag letar efter produkt ABC-12345" (testar referens-/SKU-sö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 PrestaShop-butik, att produktlänkar öppnas korrekt och att priserna inkluderar moms och rabatter när dessa alternativ är aktiverade.

Installera chattbotten i din PrestaShop-butik

För att lägga till chattwidgeten på din PrestaShop-webbplats, se den detaljerade guiden: Installera chattbot i en PrestaShop-butik

Relaterade artiklar

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