TellMyShop installeren

Je installeert TellMyShop zoals elke andere PrestaShop-module. Het duurt ongeveer 15 minuten. Aan het eind heb je een winkeladres voor de chat dat je in Claude of ChatGPT toevoegt. Deze pagina bevat de details; de korte versie staat in Aan de slag.

Wat je nodig hebt

• PrestaShop 8.1 of nieuwer, tot en met 9.x, met PHP 8.1 of nieuwer (hoofdpakket), of PrestaShop 1.7.8–8.2 met PHP 7.2–8.0 (apart pakket).
• Weet je niet welke PHP-versie je hebt? Vraag het je hostingprovider.
• Een winkeladres dat begint met https://.
• Een Claude- of ChatGPT-account. Gratis accounts werken ook.
• Toegang tot de backoffice van je winkel met het recht om modules te installeren.

Je hebt geen PrestaShop Account nodig.

Welk pakket je downloadt

• TellMyShop Pro: download de ZIP in je account, Account > Downloads. Je krijgt ook een licentiesleutel.
• TellMyShop Free: een aparte gratis ZIP, zonder sleutel. De chat leest je winkel, maakt rapporten en vertelt wat je moet verbeteren, maar dit pakket kan geen enkele wijziging opslaan.

Beide installeer je op dezelfde manier. Wil je later van Free naar Pro, upload dan de Pro-ZIP over de gratis versie en plak je sleutel. Je instellingen en geschiedenis blijven bewaard.

Stap 1: de module uploaden

1. Open in de backoffice Modules > Module Manager.
2. Klik op Een module uploaden en sleep het ZIP-bestand erin. Pak het niet uit.
3. Zie je ‘Module geïnstalleerd’, klik dan op Configureren.

In de modulelijst heet de module TellMyShop. Mislukt het uploaden? Kijk dan in de FAQ.

Stap 2: je licentiesleutel plakken

Met TellMyShop Free sla je deze stap over. Details staan hieronder bij Je licentie activeren.

Stap 3: instellen in 3 stappen

De kaart Start bevat de lijst Instellen in 3 stappen. Wat klaar is, wordt afgevinkt.

1. De connector aanzetten. Klik op Connector aanzetten. Deze ene knop maakt een apart account ‘Claude TellMyShop’ aan waarmee niemand kan inloggen, zet de connector aan en maakt een back-up van de database van de winkel. Onder de knop zie je het Winkeladres voor de chat. Klik op Kopiëren. Dit adres is niet geheim: zonder jouw goedkeuring in een venster van de winkel geeft het geen toegang.
2. De winkel toevoegen in je chat-app en in het venster van de winkel op Toestaan klikken: in Claude als aangepaste connector, in ChatGPT als aangepaste MCP-server in het onderdeel Plugins. Stap voor stap: Je winkel koppelen aan Claude of ChatGPT.
3. Het eerste gesprek beginnen. De kaart bevat een kant-en-klare starttekst. Plak die in een nieuwe chat; de chat leert je winkel kennen en vertelt waar je kunt beginnen.

Het account dat de module aanmaakt heet om historische redenen ‘Claude TellMyShop’. Het werkt net zo goed voor ChatGPT. Verwijder het niet en wijzig het profiel niet.

Wat er na de installatie is ingesteld

Om te beginnen hoef je niets te wijzigen:

• De chat leest je hele winkel (met TellMyShop Pro): producten, categorieën, pagina’s, instellingen, modules en logboeken. Hij ziet niet wat altijd geblokkeerd is en ook niet de gegevens van je klanten.
• Met een licentie worden wijzigingen in content, SEO en catalogus meteen opgeslagen, altijd na een voorbeeld en jouw ‘ja’ in de chat.
• Prijzen, thema, modules en technisch werk staan uit. Je zet ze aan in de kaart Opslaan per gebied: Verkoop blijft aan tot je het uitzet, Thema en Modules voor 24 uur, Onderhoud voor 3 uur. Zie Wat de chat voor je kan doen.
• Klantgegevens zijn niet toegankelijk voor de AI en versleuteld in de wijzigingsgeschiedenis. Toegang is een aparte instelling in de kaart Klantgegevens (AVG), en alleen jij zet die aan. Zie De gegevens van je klanten.
• Je krijgt een e-mail telkens als een veiligheidsinstelling wordt versoepeld, en een korte dagelijkse samenvatting.

Je licentie activeren

1. Kopieer je licentiesleutel uit de aankoopmail of uit Account > Licenties.
2. Open in het instellingenscherm de kaart Licentie, plak de sleutel en klik op Activeren. Het domein van je winkel wordt automatisch toegewezen.

Zonder actieve sleutel werkt het Pro-pakket als TellMyShop Free: de chat leest de hele winkel en maakt een plan van wijzigingen, maar slaat niets op. Verversen controleert de licentie opnieuw; Domein vrijgeven geeft het domein vrij voordat je de licentie verplaatst. Details: Licenties.

De module bijwerken of verwijderen

• Bijwerken: upload de nieuwe ZIP in Module Manager, net als de eerste keer. Instellingen, geschiedenis en de connector in je chat-app blijven bewaard.
• Verwijderen: Module Manager > TellMyShop > Verwijderen. Verbonden chats verliezen hun toegang, en het account ‘Claude TellMyShop’ en de databaseback-ups worden verwijderd. De wijzigingsgeschiedenis, bestandsback-ups, doorverwijzingen en de licentie blijven bewaard; wil je alles verwijderen, vink dan Geschiedenis, back-ups en doorverwijzingen bewaren bij verwijderen uit in Instellingen: veiligheid, meldingen, limieten voordat je de module verwijdert. Verwijderen geeft het domein van je licentie niet vrij: klik eerst op Domein vrijgeven in de kaart Licentie, of geef het vrij in je account. Wijzigingen die je al hebt goedgekeurd, blijven in de winkel staan.

Technische details

• Technische naam tellmyshop. Endpoint: https://your-shop.com/module/tellmyshop/mcp. Sinds 2.8 logt de chat in (OAuth) via een venster van de winkel, met jouw goedkeuring. Oudere methode (Verbonden chats > Geavanceerd: hoe chats verbinden > Adres met sleutel (oudere methode)): token in ?token=… of Authorization: Bearer ….
• Token van het adres met sleutel: alleen een SHA-256-hash en een prefix worden opgeslagen; het volledige token wordt één keer getoond; een nieuw token trekt het oude meteen in. Het testtoken van de verbindingstest is 2 minuten geldig. De aparte serviceconnector van 2.6.x is in 2.7.0 verwijderd.
• Status na installatie: connector uit tot stap 1 van de kaart Start (Connector aanzetten); Content en SEO, Catalogus meteen opgeslagen met een actieve licentie; Verkoop, Thema, Modules en Onderhoud uit; niveau klantgegevens off; e-mailmeldingen en dagelijkse samenvatting aan.
• Stap 1 maakt het profiel ‘Claude TellMyShop’ en een inactieve medewerker ‘Claude TellMyShop’ aan (SuperAdmin geweigerd). Sinds 2.7.0 krijgt het profiel de rechten van alle gebieden; de schakelaars bepalen wat wordt opgeslagen.
• De installatie registreert de hooks registerGDPRConsent, actionDeleteGDPRCustomer, actionExportGDPRData (psgdpr) en actionFrontControllerInitBefore (doorverwijzingen en blog-301’s). Ze maakt de privémap var/tellmyshop/ aan voor back-ups en sleutels; de versleutelingssleutel is var/tellmyshop/keys/history.key.
• Verwijderen wist altijd de tokens en de ondertekeningssleutel, de medewerker en het profiel die de module heeft aangemaakt, het noodscript en de sleutel ervan, het verbindingslogboek en alle databaseback-ups. Met TELLMYSHOP_KEEP_ON_UNINSTALL aan (fabrieksinstelling) blijven wijzigingsgeschiedenis, bestandsback-ups, doorverwijzingen, het auditlogboek, de privémap met de sleutel en de licentie bewaard; uit wist het alle tabellen van de module, alle TELLMYSHOP_*-instellingen en var/tellmyshop/. Verwijderen neemt geen contact op met de licentieserver, dus het domein blijft geactiveerd tot het wordt vrijgegeven in de kaart Licentie of in het account.
• Alle details: Technische specificatie.

---

PrestaShop is een geregistreerd handelsmerk van PrestaShop SA. Claude is een handelsmerk van Anthropic. ChatGPT is een handelsmerk van OpenAI. TellMyShop is met geen van hen verbonden.