Integration med Shoper

Forbind din ChatLab-chatbot med din Shoper-butik for at give kunderne adgang til produktoplysninger og ordrespoting i realtid 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: How to set up ChatLab for your E-commerce store

Hvad integrationen giver dig

Produktsøgning - Kunderne kan søge i dit Shoper-katalog ved at indtaste en frase. Chatbotten søger på tværs af produktnavne ved hjælp af fuzzy matching og returnerer op til 10 matchende produkter med:

• Produktnavn og beskrivelse
• Pris og varenummer (SKU)
• Direkte link til produktsiden i din butik
• Produktbillede
• Lagerstatus
• Valgfrit: produktvedhæftninger (PDF'er, dokumenter)

Du kan også aktivere lagerfilteret, så der kun vises produkter, der aktuelt er på lager.

Ordredetaljer - Kunderne kan tjekke deres ordrestatus ved at angive et ordre-id og den e-mailadresse, der er knyttet til ordren. Begge værdier valideres mod oplysningerne i din Shoper-butik. Chatbotten returnerer:

• Ordre-id, dato og aktuel status
• Samlet ordrebeløb og valuta
• Bestilte varer med navne, antal og priser
• Leveringsadresse (gade, by, postnummer, land, telefonnummer)
• Faktureringsadresse
• Ordrebemærkninger

Forudsætninger

Før du starter Shoper-integrationen, skal du sikre dig følgende:

• Du har et STANDARD- eller PREMIUM-abonnement hos ChatLab
• Du har adgang til dit Shoper-kontrolpanel
• Din chatbot er allerede oprettet i ChatLab

Trin 1: Opret en administratorgruppe

1. I dit Shoper-kontrolpanel går du til Settings > Store administrators (Indstillinger > Butiksadministratorer)

2. Klik på MORE (MERE) > Add administrators group (Tilføj administratorgruppe)

3. Indtast et navn til gruppen (f.eks. "ChatLab Integration"), vælg adgangstypen "access to webapi", og gem

Trin 2: Konfigurer gruppetilladelser

1. Åbn den nyoprettede gruppe, og gå til tilladelsesindstillingerne
2. Tildel læseadgang (Read) til følgende ressourcer:
   • Sales (Salg) - læs
   • Catalog (Katalog) - læs
   • Configuration (Konfiguration) - læs

Trin 3: Tilføj en API-administrator

1. Gå til Administrators (Administratorer), og klik på Add administrator (Tilføj administrator)

2. Udfyld login og adgangskode, og tildel administratoren til gruppen oprettet i trin 1

3. Gem administratoren. Noter login og adgangskode ned - du skal bruge dem i næste trin.

Trin 4: Forbind Shoper i ChatLab

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

3. Klik på Connect (Forbind) på Shoper-feltet
4. Indtast din Shop URL (din Shoper-domæneadresse, f.eks. myshop.shoper.pl)
5. Indtast dit WebAPI Login (fra trin 3)
6. Indtast din WebAPI Password (fra trin 3)

7. Klik på Initialize Configuration (Initialiser konfiguration) - dette henter de tilgængelige sprog fra din butik
8. Vælg det korrekte Shop Language (Butikssprog) fra rullemenuen (dette afgør, hvilken sprogversion af produktdataene der returneres)
9. Klik på Connect (Forbind)

ChatLab tester automatisk forbindelsen ved at udføre en testproduktsøgning. Hvis det lykkes, ser du en bekræftelsesmeddelelse, og handlingerne til både produktsøgning og ordredetaljer aktiveres som standard.

Trin 5: Konfigurer Shoper-handlinger

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

To handlinger er tilgængelige:

• Shoper - product search - gør det muligt for chatbotten at søge i dit produktkatalog
• Shoper - order details - gør det muligt for chatbotten at slå ordreoplysninger op

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

For produktsøgning klikker du på knappen Edit (Rediger) og går til fanen Product Search Settings (Indstillinger for produktsøgning). To yderligere indstillinger er tilgængelige:

• Include product attachments (Inkluder produktvedhæftninger) - når denne er aktiveret, inkluderer chatbotten produktvedhæftede filer (PDF'er, dokumenter) i søgeresultaterne
• Products in stock only (Kun produkter på lager) - når denne er aktiveret, returnerer chatbotten kun produkter, der aktuelt er på lager

Test din integration

Når handlingerne er aktiveret, åbner du din chatbot-widget og prøver:

• "Vis mig løbesko" (tester produktsøgning)
• "Hvad er status på min ordre 12345?" (tester ordredetaljer)

Bekræft, at svarene stemmer overens med dataene fra din Shoper-butik, og at produktlinks åbner korrekt.