Verbind je Ecwid by Lightspeed-winkel met je ChatLab-chatbot. Zodra de verbinding actief is, zoekt de chatbot in je producten, indexeert deze de volledige catalogus voor AI Search en controleert deze de status van bestellingen van klanten rechtstreeks in de Ecwid-winkel.
Voorbeeldgesprek
Controleer een bestelling
Vereist een gekoppelde winkel en de ingeschakelde bestelactie. Beschikbare velden zijn afhankelijk van de integratie. Een overeenkomend e-mailadres is geen identiteitsbewijs.
Bezoeker: Waar is mijn bestelling?
Speel het voorbeeld af of lees het hieronder. Er worden geen echte klantgegevens gebruikt.De klant vraagt naar een bestaande bestelling.
Het afspelen pauzeert wanneer dit voorbeeld uit beeld verdwijnt. Dit is een simulatie, geen livechat. De widgetknoppen tijdens het afspelen zijn niet interactief.Lees het volledige voorbeeld
- De klant vraagt naar een bestaande bestelling.
Bezoeker: Waar is mijn bestelling?
- De standaardzoekopdracht heeft beide gegevens nodig.
Assistent: Geef alsjeblieft je bestelnummer en het e-mailadres door dat bij het afrekenen is gebruikt.
- Gebruik fictieve gegevens in dit voorbeeld.
Bezoeker: 41982, anna@example.com
- De actie haalt gegevens op uit de gekoppelde winkel.
Bestelling 41982 controleren...
- Meld alleen de gegevens die de winkel teruggeeft.
Assistent: Bestelling 41982 staat gemarkeerd als verzonden. De bezorger is DPD. Bekijk de trackingpagina voor de meest recente bezorginformatie.
Het voorbeeld laat de klantervaring zien. De beschikbare acties en getoonde informatie zijn afhankelijk van deze integratie en jouw configuratie.
Belangrijk: best practices voor e-commerce
Nadat je de onderstaande integratie hebt voltooid, lees je de gedetailleerde handleiding over het optimaliseren van je chatbot voor e-commerce: Hoe je ChatLab instelt voor je e-commercestore
Wat de integratie biedt
AI-productzoekfunctie - Klanten beschrijven in hun eigen woorden wat ze zoeken en de chatbot vindt passende producten in je catalogus. Het antwoord bevat:
- Productnaam en beschrijving
- Huidige prijs in de valuta van je winkel, en voor afgeprijsde artikelen ook de normale prijs en de korting
- Productafbeelding
- Directe link naar de productpagina in je winkel
- Beschikbaarheid, SKU, categorieën en productopties (maten, kleuren) wanneer het product deze heeft
Producten zoeken op trefwoord - Een eenvoudige zoekopdracht op trefwoorden via de zoekmachine van Ecwid. De AI-productzoekfunctie vervangt deze automatisch zodra de catalogus is geïndexeerd.
Bestelstatus - De klant geeft het bestelnummer en het e-mailadres op dat bij het afrekenen is gebruikt, en de chatbot antwoordt met de betalingsstatus, verwerkingsstatus, verzendmethode, het trackingnummer en de bestelde artikelen. Bestellingen worden altijd gekoppeld aan het e-mailadres van de klant, zodat een geraden bestelnummer nooit de bestelling van iemand anders kan onthullen.
Categorieën - De chatbot kan een zoekopdracht verfijnen tot een specifieke categorie met behulp van de categoriestructuur van je winkel.
Toevoegen aan winkelwagen - Productkaarten in de chat kunnen een knop Add to cart (Aan winkelwagen toevoegen) tonen. Wanneer de chatbot draait op je Instant Site, of op een website waarin je Ecwid-winkel is ingesloten, plaatst de knop het product direct in de Ecwid-winkelwagen van de klant. Bij producten met opties zoals maat of kleur kiest de klant eerst de variant in de chat. Op alle andere plekken, en bij producten met opties die niet via de chat kunnen worden ingevuld (zoals een tekstveld voor een gravure), opent de knop de productpagina.
Bekijk de winkelwagenervaring
Voor een voorbeeld van de winkelwagen en instructies voor het testen op je storefront, zie Producten toevoegen aan de winkelwagen. De onderstaande reeks dient ter illustratie; er wordt geen echte bewerking in de Ecwid-winkelwagen uitgevoerd.
Kies een variant voordat je het aan het winkelmandje toevoegt
Illustratieve weergave: daadwerkelijke knoppen voor winkelmandjes en variantkiezers zijn afhankelijk van het platform en de storefront. Deze demo voert geen actie in het winkelmandje uit.
Smaragdgroene wikkeljurk, $79. Viscose, midi-lengte.
Speel het voorbeeld af of lees het hieronder. Er worden geen echte klantgegevens gebruikt.Zoekresultaten tonen een productkaart met een winkelmandknop in ondersteunde winkels.
Het afspelen pauzeert wanneer dit voorbeeld uit beeld verdwijnt. Dit is een simulatie, geen livechat. De widgetknoppen tijdens het afspelen zijn niet interactief.Lees het volledige voorbeeld
- Zoekresultaten tonen een productkaart met een winkelmandknop in ondersteunde winkels.
Smaragdgroene wikkeljurk, $79. Viscose, midi-lengte.
- De klant kiest een product en maat via de ondersteunde winkelmandknoppen.
Bezoeker: Smaragdgroene wikkeljurk, maat 38.
- Bevestig pas een succesvolle toevoeging nadat de storefront de actie heeft verwerkt.
Assistent: Voorbeeldresultaat: de geselecteerde variant is toegevoegd aan je winkelmandje in de winkel.
- Betaling en afrekenen vinden plaats in de winkel.
Assistent: Controleer je winkelmandje in de winkel om aantal, prijs en bezorging te bevestigen en ga door naar afrekenen.
Wat de integratie niet biedt
- Afrekenen in de chat. De klant rondt de aankoop af in je Ecwid-winkel.
- Live voorraadmeldingen. Prijzen en beschikbaarheid worden uit Ecwid opgehaald op het moment dat de chatbot antwoordt, maar de chatbot stelt klanten niet op de hoogte van latere wijzigingen.
Vereisten
- Een Ecwid-winkel met het Venture-, Business- of Unlimited-abonnement. Ecwid biedt API-toegang vanaf het Venture-abonnement; het Starter-abonnement kan niet worden gekoppeld.
- De Ecwid-integratie inbegrepen in je ChatLab-abonnement.
- Voor de AI-productzoekfunctie: voldoende AI Search-capaciteit toegewezen aan de chatbot voor al je geactiveerde producten. Controleer de beschikbare capaciteit via Shop (Winkel) > Products (Producten).
- Geen andere winkelintegratie gekoppeld aan dezelfde chatbot.
Stap 1: Haal de Store ID en het geheime token op in Ecwid
- Log in op je Ecwid-beheerderspaneel.
- Klik in het linkermenu op Apps, daarna op My Apps (Mijn apps) en open Develop apps (Apps ontwikkelen) (of ga direct naar
https://my.ecwid.com/#develop-appsterwijl je bent ingelogd). - Als er nog geen aangepaste app staat, klik je op Create app (App maken). Ecwid maakt de app aan met de machtigingen die de chatbot nodig heeft: winkelprofiel lezen, catalogus lezen en bestellingen lezen. Als het scherm een lijst met machtigingen toont, controleer dan of deze drie zijn aangevinkt.
- Open de pagina Details van de app en klik op Show secret token (Geheim token tonen). Kopieer het token. Dit begint met
secret_. Gebruik niet het openbare token, dat begint metpublic_. - Noteer je Store ID. Dit is het nummer dat onderaan elke pagina van je Ecwid-beheerder staat en in de adresbalk van het paneel te zien is.
Houd het geheime token privé. Het geeft leestoegang tot je catalogus en bestellingen. Je kunt het op elk moment intrekken door de app te verwijderen via Apps > My Apps; wanneer je de app opnieuw installeert, wordt er een nieuw token gegenereerd.
Stap 2: Koppel de winkel in ChatLab
- Open je chatbot in ChatLab en ga naar Shop.
- Klik op de tegel Ecwid.
- Plak de Store ID en het Secret token (Geheim token).
- Klik op Check connection (Verbinding controleren). ChatLab leest het winkelprofiel uit en toont de naam van de winkel, het adres van de storefront en de valuta.
- Als je winkel meerdere talen heeft, kies je de Shop Language (Winkeltaal) die de chatbot moet gebruiken voor productnamen en beschrijvingen.
- Klik op Connect (Verbinden).
ChatLab test de verbinding en schakelt de acties voor productzoekfunctie en bestelstatus in. Wanneer er AI Search-capaciteit is toegewezen aan de chatbot, start het indexeren van de catalogus direct; dit wordt gemeld in het bevestigingsvenster. Het geheime token wordt versleuteld opgeslagen en wordt daarna nooit meer getoond; laat het tokenveld leeg als je alleen de taal wilt wijzigen.
Stap 3: Configureer de acties
Ga naar Settings (Instellingen) > AI Actions (AI-acties). Er zijn drie acties beschikbaar voor Ecwid:
- Ecwid - AI product search - semantisch zoeken in de geïndexeerde catalogus. In de instellingen kun je de volledige productkaart aan het antwoord toevoegen, resultaten beperken tot producten op voorraad en de knop Add to cart inschakelen.
- Ecwid - product search - zoeken op trefwoorden via de Ecwid-zoekmachine, handig wanneer AI Search niet beschikbaar is voor de chatbot. Deze actie kan ook worden beperkt tot producten op voorraad en kan de knop Add to cart tonen.
- Ecwid - order details - opzoeken van de bestelstatus. Snelheidsbeperkingen (rate limiting) en het afschermen van persoonsgegevens zijn instelbaar in de actie-instellingen.
Elke actie heeft een bewerkbare prompt en een actielabel dat in de chat wordt getoond terwijl de chatbot bezig is.
Stap 4: Controleer de catalogus
Open Training > E-commerce catalog (E-commercecatalogus) om de voortgang van de indexering te volgen, door de geïndexeerde producten te bladeren en de catalogus opnieuw te trainen na grotere wijzigingen in de winkel. Alleen producten die sinds de vorige keer zijn gewijzigd, worden opnieuw geïndexeerd. Gedeactiveerde producten worden automatisch uit de index verwijderd.
Producten zonder beschrijving worden alleen geïndexeerd op naam, categorieën en attributen. Als je producten in Ecwid geen beschrijving hebben, verbetert het toevoegen van zelfs een korte omschrijving de zoekresultaten aanzienlijk.
Stap 5: Voeg de chatbot toe aan je storefront
De Ecwid-integratie verbindt de chatbot met je winkelgegevens. Om de chatbot aan je klanten te tonen, voeg je het ChatLab-script toe aan de website waar de winkel op staat:
Instant Site (vereist het Venture-, Business- of Unlimited-abonnement):
- Open je chatbot in ChatLab, ga naar Test & Deploy (Testen en implementeren), kies Ecwid en kopieer de code.
- Ga in je Ecwid-beheerderspaneel naar Website > Overview (Website > Overzicht).
- Scrol omlaag naar Advanced website settings (Geavanceerde website-instellingen) en klik op Add Code (Code toevoegen) onder Custom JavaScript code (Aangepaste JavaScript-code).
- Plak de code in het veld dat opent en klik op Save (Opslaan).
- Vernieuw je Instant Site - de chatbot verschijnt in de onderste hoek van elke pagina.
Ecwid raadt het body-gedeelte (Custom JavaScript code) aan voor chatwidgets. Gebruik niet Header meta tags and site verification in de SEO-instellingen - dat veld is bedoeld voor verificatietags.
Winkel ingesloten op een andere website (WordPress, Wix, Squarespace en andere): voeg de code toe aan die website, precies zoals beschreven in Chatbot toevoegen aan je website. De chatbot verschijnt dan op elke pagina van die website, niet alleen op de winkelpagina.
Probleemoplossing
- "Ecwid rejected the secret token" - Het token is niet volledig gekopieerd, of de app is verwijderd of opnieuw geïnstalleerd in Ecwid, waardoor een nieuw token is gegenereerd. Open de pagina Details van de app opnieuw en plak het actuele token.
- "The Ecwid store plan does not include API access" - De winkel gebruikt het Starter-abonnement. Upgrade naar Venture of hoger in Ecwid.
- De chatbot vindt geen producten - Controleer de indexeringsstatus in Training > E-commerce catalog en zorg ervoor dat de producten zijn ingeschakeld in Ecwid. Uitgeschakelde producten worden nooit getoond.
- De bestelling wordt niet gevonden - De chatbot heeft het e-mailadres nodig dat bij het afrekenen is gebruikt, samen met het bestelnummer zoals vermeld in de bevestigingsmail, inclusief eventuele voorvoegsels of achtervoegsels die je winkel aan bestelnummers toevoegt.