Hjælpecenter
Chatbot-integrationer

Integration med PrestaShop

Sidst opdateret:

Forbind din ChatLab-chatbot med din PrestaShop-butik for at give kunderne adgang i realtid til produktoplysninger og ordresporing direkte i chatten.

Vigtigt: Best practices for e-handel

Når du har gennemført integrationen herunder, bør du læse den omfattende guide om optimering af din chatbot til e-handel: Sådan opsætter du ChatLab til din e-handelsbutik

Hvad integrationen tilbyder

Produktsøgning - Kunderne kan søge i dit PrestaShop-katalog ved at indtaste en frase. Chatbotten søger på tværs af produkttitler og beskrivelser og returnerer de 5 mest relevante produkter med:

  • Produkt-ID, navn og beskrivelse
  • Pris (valgfrit inklusiv moms og specifikke prisrabatter)
  • Direkte link til produktsiden i din butik
  • Produktbillede

Produktsøgning via reference (SKU) - Kunderne kan fremsøge produkter ved hjælp af præcise referencekoder. Chatbotten søger på tværs af flere identifikatortyper - reference/SKU, EAN-13-stregkode, ISBN og MPN - på både produkter og deres varianter (kombinationer). Dette er nyttigt, når kunderne har en specifik produktkode fra et katalog, en faktura eller emballagen.

Ordreoplysninger - Kunderne kan tjekke deres ordrestatus ved at oplyse et ordre-ID og den e-mailadresse, der er tilknyttet ordren. Begge værdier valideres mod oplysningerne i din PrestaShop-butik. Chatbotten returnerer:

  • Ordrereference, dato og aktuel status (f.eks. i gang, fuldført, annulleret)
  • Ordretotal
  • Modtagernavn, virksomhed, fuld leveringsadresse (gade, by, postnummer) og telefonnummer
  • Fragtfirmaets navn og trackingnumre (flere trackingnumre understøttes)
  • Bestilte varer med navne, antal og individuelle priser

Forudsætninger

Før du påbegynder PrestaShop-integrationen, skal du sikre dig følgende:

Trin 1: Aktivér webservice i PrestaShop

  1. Log ind på dit PrestaShop back office
  2. Gå til Configure > Advanced Parameters > Webservice (Konfigurer > Avancerede parametre > Webservice)

PrestaShop-administrationsmenu, der viser valgmuligheden Advanced Parameters og Webservice|width=25

  1. Rul ned til sektionen Configuration (Konfiguration)
  2. Sæt Enable PrestaShop's webservice (Aktivér PrestaShops webservice) til Yes (Ja)
  3. Klik på Save (Gem)

Konfigurationssektion med til/fra-knappen Enable PrestaShop's webservice og knappen Save

Trin 2: Opret en webservicenøgle

  1. På den samme webserviceside skal du klikke på Add new webservice key (Tilføj ny webservicenøgle)

Webserviceside med knappen Add new webservice key|width=50

  1. Klik på Generate (Generer) for at oprette en ny nøgle
  2. Indtast en beskrivelse (f.eks. "ChatLab Integration")
  3. Sørg for, at nøglen er sat til Enabled (Aktiveret)
  4. Under ressourcetilladelser skal du give adgang til View (GET) (Vis) for følgende ressourcer:
    • 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

Konfiguration af webservicenøgle med knappen Generate, beskrivelse og tilladelserne View GET

  1. Klik på Save (Gem)
  2. Kopiér den genererede webservicenøgle - du skal bruge den i næste trin

Trin 3: Find dit produkt-URL-format

  1. Gå til Configure > Shop Parameters > Traffic & SEO (Konfigurer > Butiksparametre > Trafik & SEO) i PrestaShops back office

PrestaShop-administrationsmenu, der viser valgmuligheden Shop Parameters og Traffic & SEO|width=25

  1. Rul ned til sektionen Schema of URLs (URL-skema)
  2. Kopiér værdien fra feltet Route to products (Sti til produkter) (f.eks. {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Sektionen Schema of URLs, der viser feltet Route to products

Trin 4: Forbind PrestaShop i ChatLab

  1. Log ind på ChatLab, og vælg din bot
  2. Gå til fanen Connect (Forbind)

Fanen Connect, der viser PrestaShop-integrationsfeltet

  1. Klik på Connect (Forbind) på PrestaShop-feltet
  2. Indtast din Webservice key (webservicenøgle fra trin 2)
  3. Indtast din Shop url (den fulde URL til din butik, f.eks. https://www.mystore.com)
  4. Indtast dit Product url format (produkt-URL-format fra trin 3)

PrestaShop-integrationsformular med webservicenøgle, butiks-URL, produkt-URL-format og standardsprog

  1. Klik på Initialize Configuration (Initialiser konfiguration) - dette henter de tilgængelige sprog fra din butik
  2. Vælg det korrekte Default language (standardsprog) i rullemenuen
  3. Klik på Connect (Forbind)

ChatLab tester automatisk forbindelsen ved at bekræfte, at din webservicenøgle har de påkrævede adgangstilladelser. Hvis det lykkes, ser du en bekræftelsesmeddelelse.

Trin 5: Konfigurer PrestaShop-handlinger

Når forbindelsen er oprettet, kan du aktivere og tilpasse individuelle AI-handlinger. Gå til Settings > Actions (Indstillinger > Handlinger), og filtrer efter PrestaShop-platformen.

PrestaShop-handlinger i Settings, der viser produktsøgning og ordreoplysninger

Følgende handlinger er tilgængelige:

  • Prestashop - product search - gør det muligt for chatbotten at søge i dit produktkatalog efter navn
  • Prestashop - search by reference - gør det muligt for chatbotten at finde produkter via reference/SKU-, EAN-13-, ISBN- eller MPN-koder
  • Prestashop - order details - gør det muligt for chatbotten at slå ordreoplysninger op
  • Prestashop - get product variants - gør det muligt for chatbotten at hente detaljerede variatoplysninger (størrelser, farver) for et specifikt produkt

Klik på aktiveringsknappen ved hver handling for at slå den til. Du kan også tilpasse handlingens etiket (den meddelelse, der vises til brugerne, mens handlingen kører) og de instruktioner, der styrer, hvordan AI'en bruger hver handling.

Når handlingen "Search by reference" er aktiveret, vil den almindelige produktsøgning også automatisk falde tilbage på en referencekodesøgning, hvis der ikke findes nogen resultater på navnet. Det betyder, at kunder kan indtaste et SKU eller en stregkode i et almindeligt søgefelt og stadig få præcise resultater.

Vis produkter med genopfyldningsdato (forudbestilling)

Når "Products in stock only" er aktiveret i indstillingerne for handlingen Product Search, kan du desuden aktivere "Show products with restock date". Dette gør det muligt for chatbotten at medtage varer, der ikke er på lager, men som har en forventet genopfyldningsdato angivet i PrestaShop. I stedet for at skjule disse produkter helt, informerer chatbotten kunden om genopfyldningsdatoen, og at produktet kan forudbestilles.

Krav:

  • PrestaShop skal have "Allow ordering of out-of-stock products" (Tillad bestilling af varer, der ikke er på lager) aktiveret (Shop Parameters > Product Settings)
  • Webservicenøglen skal have View (GET)-adgang til ressourcerne combinations og configurations
  • Produkter skal have en available_date angivet på deres kombinationer i PrestaShop

Priser inklusiv moms

Aktivér til/fra-knappen "Apply tax (VAT) to prices" i indstillingerne for handlingen Product Search for at vise priser inklusive moms. Når den er aktiveret, beregner chatbotten priserne ved hjælp af momsreglerne fra din PrestaShop-butik baseret på butikkens standardland. Dette sikrer, at de priser, kunderne ser i chatten, stemmer overens med det, de ser på din webshop.

Krav:

  • Webservicenøglen skal have View (GET)-adgang til ressourcerne taxes, tax_rules, tax_rule_groups og configurations

Specifikke priser (rabatter og kampagner)

Aktivér til/fra-knappen "Apply specific prices (discounts/promotions)" i indstillingerne for handlingen Product Search for at vise nedsatte priser fra specifikke prisregler i PrestaShop. Når en rabat er aktiv for et produkt, viser chatbotten både den nedsatte pris og den oprindelige pris, så kunderne kan se besparelsen.

Dette dækker overordnede specifikke prisregler - kampagner og tilbud, der gælder for alle kunder med et minimumsantal på 1. Tidsbegrænsede kampagner understøttes også; chatbotten anvender kun rabatter, der er aktive i øjeblikket baseret på deres start- og slutdatoer.

Krav:

  • Webservicenøglen skal have View (GET)-adgang til ressourcerne specific_prices og specific_price_rules

Test din integration

Når du har aktiveret handlingerne, kan du åbne din chatbot-widget og prøve følgende:

  • "Vis mig løbesko" (tester produktsøgning)
  • "Jeg leder efter produkt ABC-12345" (tester reference/SKU-søgning)
  • "Hvad er status på min ordre 12345?" (tester ordreoplysninger)

Bekræft, at svarene stemmer overens med dataene fra din PrestaShop-butik, at produktlinks åbner korrekt, og at priserne inkluderer moms og rabatter, når disse indstillinger er slået til.

Installer chatbotten i din PrestaShop-butik

For at tilføje chat-widgetten til din PrestaShop-webshop kan du læse den detaljerede guide: Installation af chatbot i en PrestaShop-butik