Probleemoplossing
Laatst bijgewerkt:
Voor winkeloperators en technisch managers. Vorige:
Zoek het bericht dat je op het scherm ziet en volg vervolgens de stappen in de relevante tabel. Berichten worden in het Engels bewaard zodat je ze kunt koppelen aan de interface.
Snelle controles
Voordat je een specifiek probleem oplost:
- Controleer of je op de juiste plek werkt.
- Open ** PrestaKick AI → Connection** in de module.
- Controleer de Connected status.
- Als je net de configuratie hebt veranderd, selecteer dan Save configuration.
- Open Cron Jobs → Logs en controleer de laatste run.
- Controleer op het dashboard de status van Healthy, Degraded, Offline of Unknown.
- Probeer opnieuw met een incognitovenster om oude gegevens uit de browser te sluiten.
Moduleverbindingsfout
| Boodschap of symptoom | Gemeenschappelijke oorzaak | Wat te doen |
|---|---|---|
| API connection required | Module maakt geen verbinding of kan de API niet aanroepen | Open Connection, maak opnieuw verbinding en selecteer Save configuration |
| Not connected | OAuth onvolledig of losgekoppeld | Kies Connect with PrestaKick, kies de juiste winkel en bevestig het |
| Connected maar Features meldt nog steeds een foutmelding | Onopgeslagen instellingen, een verkeerde URL of geen uitgaande internettoegang | Sla de instellingen op, controleer https://api.prestakick.com en gebruik dan Test connection |
| Connection failed / Connection test failed | Ontbrekende informatie of ontoegankelijke API's | Controleer Module Secret, API Base URL, Shop ID en netwerkconnectiviteit |
| Invalid API Base URL format |
Dien geen modulegeheimen of API-sleutels in bij supportverzoeken.
OAuth Error
| Boodschap | Wat te doen |
|---|---|
| Invalid connection request | Sluit de huidige pagina en begin opnieuw vanaf Connect with PrestaKick in de module |
| OAuth connection token has expired | Begin opnieuw vanaf de module; De oude link is verlopen |
| OAuth connection token has already been used | Open de oude link niet opnieuw; Start een nieuwe verbindingsstroom |
| Shop is already connected to another PrestaShop URL | Controleer oude en nieuwe URL's voordat je besluit opnieuw verbinding te maken |
| Only the shop owner can connect this shop | Log in met een eigenaaraccount of vraag de eigenaar om het te doen |
| No unconnected shops | Maak een winkel aan of verbind een bestaande winkel opnieuw als dat is wat je wilt doen |
Open maar één OAuth-proces tegelijk.
Offline module of synchronisatie mist data
| Verschijnsel | Hoe om te gaan |
|---|---|
| Modulerapporten Offline | Controleer of de module is ingeschakeld, cron draait en de server internettoegang heeft |
| Modulerapporten Degraded | Open Cron Jobs → Logs, controleer herhaalde fouten en de wachtrij, en controleer vervolgens of de status herstelt |
| Module meldt Unknown na een nieuwe verbinding | Wacht een paar minuten en speel cron één keer |
| Oude of ontbrekende dashboardgegevens | Controleer de status van de module en open de Data sync om een hersynchronisatie aan te vragen |
| Manual sync is rate limited to once per hour per entity type | Wacht tot de tijdslimiet is verstreken voordat je het datatype opnieuw uitvoert |
| Synchronisatierapporten voor de opdracht Failed | Open de gegevens, los de oorzaak op, en voer de klus opnieuw uit |
| Unauthorized: Invalid or missing API Key | Controleer de Store API-sleutel, selecteer Save configuration, of verbind opnieuw met OAuth |
| Unauthorized: invalid or missing cron token. |
Widget verschijnt niet
Controleer in deze volgorde:
- Show Widget ingeschakeld, of het test-IP staat in de Preview IPs.
- Je hebt Save configuration gekozen.
- De huidige domeinnaam staat in de Allowed storefront domains.
- De module is niet in Offline toestand.
- De browser gebruikt geen oude JavaScript; Probeer een harde verversing of een incognitovenster.
- Als de toets telefonisch is, staat Show on Mobile aan.
| Boodschap | Wat te doen |
|---|---|
| Widget origin is not allowed for this shop | De eigenaar voegt de juiste domeinnaam toe bij Instellingen → Domeinen & Toegang en selecteert vervolgens Save rules |
| Invalid widget key | Maak OAuth opnieuw verbinding of werk een nieuwe Widget Key bij in je huidige configuratie |
| Failed to save widget configuration | Controleer de verbinding, rechten en planlimieten, en sla dan opnieuw op |
| Upgrade to Starter or higher to allow image uploads | Upgrade naar Starter of hoger, of zet Allow image uploads uit |
Chat en AI-assistenten
| Boodschap of symptoom | Wat te doen |
|---|---|
| De chat opent, maar de AI antwoordt niet. | Controleer quota, modulestatus, gesynchroniseerde data en servicemeldingen |
| You are sending messages too fast... | Wacht een paar seconden en dien dan opnieuw in |
| AI credits have been exhausted | Eigenaren kopen meer credits, upgraden hun abonnement of wachten op een nieuwe limiet |
| Too many requests. Please try again later | Wacht en probeer het opnieuw; Als het vaak gebeurt met echt verkeer, neem dan contact op met de support |
| Service is temporarily unavailable | Probeer het later opnieuw; agenten kunnen gesprekken overnemen als de Chat-inbox nog actief is |
| De assistent geeft een algemeen antwoord | Controleer productbeschrijvingen, beleidspagina's, synchronisatie- en assistentinstructies |
| Message could not be sent. | Controleer de verbinding en probeer het opnieuw |
| Could not send the image. | Controleer het afbeeldingsformaat, de bestandsgrootte en of het abonnement uploads van afbeeldingen toestaat |
Login en beveiliging
| Boodschap | Wat te doen |
|---|---|
| Invalid credentials | Controleer de e-mail, het wachtwoord en Caps Lock; Gebruik Forgot password indien nodig |
| Account is not verified | Open een verificatiemail of vraag een link opnieuw versturen |
| Account is suspended or locked | Neem contact op met de support via officiële kanalen |
| TOTP code is required | Voer een zescijferige code in vanuit een authenticator-app |
| TOTP code is invalid | Wacht op een nieuwe code en controleer of je telefoon automatisch zijn tijd instelt |
| Refresh token has expired | Log weer in op het dashboard |
| Onvolledige gevoelige operatie | Controleer je rol en voltooi de herauthenticatie |
| You need an active shop membership... | Controleer je gekozen winkel en lidmaatschapsstatus |
Als je je authenticatieapparaat verliest, gebruik dan een ongebruikte herstelcode. Stuur geen TOTP- of herstelcodes naar anderen.
Plannen en grenzen
| Boodschap | Wat te doen |
|---|---|
| Image search is not available on the current plan | Upgrade naar Starter of hoger, of zet de functie uit |
| Recommendations are not available on the current plan | Upgrade naar Launch of hoger, of zet aanbevelingen uit |
| The monthly recommendation request quota has been reached | Wacht op de volgende quotaperiode of upgrade het plan |
| Current usage exceeds the selected plan limits | Verlaag je verbruik onder de limiet of kies een ander abonnement |
| Your current plan does not allow connecting another shop | Upgrade je abonnement of gebruik een winkel binnen je huidige limieten |
| Image storage quota exceeded | Verwijder onnodige gegevens als er een geschikte optie is, of upgrade het abonnement |
Wanneer je contact moet opnemen met de klantenservice
Voorbereiding:
- Winkelnaam en websitedomeinnaam.
- Volledige screenshot van het foutbericht.
- Het tijdstip van het incident, met de tijdzone.
- Net stappen gezet.
- Of de fout iedereen treft of slechts één account, apparaat of IP-adres.
- Het relevante record in Cron Jobs → Logs, indien van toepassing.
Stuur geen wachtwoorden, TOTP-codes, herstelcodes, modulegeheimen, API-sleutels, widgetsleutels of cron-tokens.