Vad kan ChatLab göra när det är integrerat med PrestaShop?

ChatLab kan söka efter produkter i din PrestaShop-katalog efter namn eller referenskod (SKU, EAN-13, ISBN, MPN), visa priser inklusive moms och tillämpade rabatter samt hämta orderdetaljer såsom referens, datum, status, totalsumma, fullständig leveransadress med fraktbolag och spårningsnummer samt beställda artiklar med namn, antal och priser.

Hur skapar jag en webservice-nyckel i PrestaShop?

I PrestaShop går du till Configure (Konfigurera), sedan Advanced Parameters (Avancerade parametrar) och därefter Webservice. Aktivera webservice, klicka på Add new webservice key (Lägg till ny webservice-nyckel), generera en nyckel och ge GET-behörigheter för languages, search, products, orders, tags, customers, addresses, order_states, categories och carriers.

Var ansluter jag PrestaShop i ChatLab?

Logga in på ChatLab, välj din bot, gå till fliken Connect (Anslut) och klicka på Connect (Anslut) på PrestaShop-rutan. Ange din webservice-nyckel, butikens URL, format för produkt-URL och standardspråk, och klicka sedan på Connect.

Var konfigurerar jag PrestaShop-åtgärder efter anslutningen?

När du har anslutit PrestaShop under fliken Connect går du till Settings (Inställningar) och sedan Actions (Åtgärder) för att aktivera och konfigurera enskilda åtgärder som Product Search och Order Details.

Stöder ChatLab PrestaShop multistore?

För närvarande inte. Integreringen stöder inte multistore-konfigurationer. Kontakta ChatLab-supporten via kontaktformuläret om du behöver den här funktionen.

Integrering med PrestaShop - ChatLab Hjälpcenter

Koppla ihop din ChatLab-chattbot med din PrestaShop-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 konfigurerar ChatLab för din e-handelsbutik

Vad integrationen erbjuder

Produktsökning - Kunder kan söka i din PrestaShop-katalog genom att skriva in en fras. Chattbotten söker bland produkttitlar och beskrivningar och returnerar de 5 bäst matchande produkterna med:

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

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

Orderuppgifter - Kunder kan kontrollera sin orderstatus genom att ange ett order-ID och e-postadressen som är kopplad till beställningen. Båda värdena valideras mot uppgifterna i din PrestaShop-butik. Chattbotten returnerar:

Orderreferens, datum och aktuell status (t.ex. behandlas, slutförd, avbruten)
Ordersumma
Mottagarens namn, företag, fullständig leveransadress (gatuadress, postort, postnummer) och telefonnummer
Transportörens namn 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 redan är tillagd i din PrestaShop-butik - se Installera chattbot i en PrestaShop-butik
Du har tillgång till din PrestaShop-administrationspanel (back office)

Steg 1: Aktivera webbtjänsten i PrestaShop

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

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

Steg 2: Skapa en webbtjänstnyckel

Klicka på Add new webservice key (Lägg till ny webbtjänstnyckel) på samma Webservice-sida

Klicka på Generate (Generera) för att skapa en ny nyckel
Ange en beskrivning (t.ex. "ChatLab Integration")
Kontrollera att nyckeln är inställd på Enabled (Aktiverad)
Under resursbehörigheter ger du behörigheten View (GET) (Visa [GET]) till 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
- states
- stock_availables
- tags
- tax_rule_groups
- tax_rules
- taxes

Klicka på Save
Kopiera den genererade webbtjänstnyckeln - du behöver den i nästa steg

Steg 3: Hitta formatet för din produkt-URL

Gå till Configure > Shop Parameters > Traffic & SEO (Konfigurera > Butiksparametrar > Trafik och SEO) i PrestaShop back office

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

Steg 4: Anslut PrestaShop i ChatLab

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

Klicka på Connect på PrestaShop-rutan
Ange din Webservice key (webbtjänstnyckel från steg 2)
Ange din Shop url (butikens fullständiga webbadress, t.ex. https://www.mystore.com)
Ange ditt Product url format (produkt-URL-format från steg 3)

Klicka på Initialize Configuration (Initiera konfiguration) - detta hämtar tillgängliga språk från din butik
Välj rätt Default language (standardspråk) i rullgardinsmenyn
Klicka på Connect

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

Steg 5: Konfigurera PrestaShop-åtgärder

Efter anslutningen kan du aktivera och anpassa enskilda AI-åtgärder. Navigera 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

Klicka på aktiveringsknappen för varje åtgärd för att slå på den. 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 växlar den vanliga produktsökningen automatiskt över till en referenskodssökning om inga resultat hittas på namn. Det innebär att kunder kan skriva in ett SKU eller en 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 slutsålda produkter som har ett förväntat påfyllningsdatum inställt i PrestaShop. I stället för att dölja dessa produkter helt informerar chattbotten kunden om påfyllningsdatumet och att produkten går att förbeställa.

Krav:

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

Priser inklusive moms

Aktivera reglaget "Apply tax (VAT) to prices" (Tillämpa 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 momsreglerna från din PrestaShop-butik baserat på butikens standardland. Detta säkerställer att priserna som kunderna ser i chatten matchar det de ser i din webbutik.

Krav:

Webbtjänstnyckeln måste ha View (GET)-behörighet 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 regler för specifika priser. När en rabatt är aktiv för en produkt visar chattbotten både det rabatterade priset och ordinarie pris, så att kunderna ser prissänkningen.

Detta omfattar generella regler för specifika priser - kampanjer och reor som gäller för alla kunder med en minsta kvantitet på 1. Tidsbegränsade kampanjer stöds också; chattbotten tillämpar endast rabatter som för tillfället är aktiva baserat på start- och slutdatum.

Krav:

Webbtjänstnyckeln måste ha View (GET)-behörighet till resurserna specific_prices och specific_price_rules

Testa din integration

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

"Visa mig löparskor" (testar produktsökning)
"Jag letar efter produkt ABC-12345" (testar referens-/SKU-sökning)
"Vad har min order 12345 för status?" (testar orderuppgifter)

Kontrollera att svaren stämmer överens med informationen från din PrestaShop-butik, att produktlänkarna ö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 chatt-widgeten i din PrestaShop-butik, se den detaljerade guiden: Installera chattbot i en PrestaShop-butik