Fehlerbehebung
Zuletzt aktualisiert:
Für Werkstattbetreiber und technische Manager. Früher:
Finde die Nachricht, die du auf dem Bildschirm siehst, und folge dann den Schritten in der entsprechenden Tabelle. Nachrichten werden auf Englisch gespeichert, sodass man sie mit der Benutzeroberfläche zuordnen kann.
Schnelle Kontrollen
Bevor Sie ein spezifisches Problem beheben:
- Überprüfen Sie, ob Sie im richtigen Geschäft arbeiten.
- Öffne ** PrestaKick KI → Verbindung** im Modul.
- Überprüfen Sie den Connected Status.
- Wenn Sie gerade die Konfiguration geändert haben, wählen Sie Save configuration.
- Öffne Cron Jobs → Logs und überprüfe den letzten Durchlauf.
- Überprüfen Sie auf dem Dashboard den Status von Healthy, Degraded, Offline oder Unknown.
- Versuchen Sie es erneut mit einem Inkognitofenster, um alte Daten im Browser auszuschließen.
Modulverbindungsfehler
| Botschaft oder Symptom | Gemeinsame Sache | Was zu tun ist |
|---|---|---|
| API connection required | Modul verbindet sich nicht oder ruft die API nicht auf | Öffnen Sie Connection, verbinden Sie sich wieder und wählen Sie Save configuration |
| Not connected | OAuth unvollständig oder nicht verbunden | Wählen Sie Connect with PrestaKick, wählen Sie die richtige Werkstatt und bestätigen Sie |
| Connected aber Features meldet trotzdem einen Fehler | Ungespeicherte Einstellungen, eine falsche URL oder kein ausgehender Internetzugang | Speichere die Einstellungen, überprüfe https://api.prestakick.com und benutze dann Test connection |
| Connection failed / Connection test failed | Fehlende Informationen oder unzugängliche APIs | Überprüfe Module Secret, API Base URL, Shop ID und Netzwerkverbindungen |
Reichen Sie keine Modulgeheimnisse oder API-Schlüssel in Support-Anfragen ein.
OAuth Fehler
| Botschaft | Was zu tun ist |
|---|---|
| Invalid connection request | Schließen Sie die aktuelle Seite und starten Sie erneut von Connect with PrestaKick im Modul |
| OAuth connection token has expired | Beginnen Sie erneut mit dem Modul; Der alte Link ist abgelaufen |
| OAuth connection token has already been used | Öffne den alten Link nicht wieder; Starte einen neuen Verbindungsfluss |
| Shop is already connected to another PrestaShop URL | Überprüfe alte und neue URLs, bevor du dich für eine Wiederverbindung entscheidest |
| Only the shop owner can connect this shop | Melde dich mit einem Eigentümerkonto an oder bitte den Eigentümer, es zu erledigen |
| No unconnected shops | Erstellen Sie einen Shop oder verbinden Sie einen bestehenden Shop erneut, wenn dies beabsichtigt ist |
Öffne immer nur einen OAuth-Prozess gleichzeitig.
Offline-Module oder Synchronisation fehlen Daten
| Phänomen | Wie man damit umgeht |
|---|---|
| Modulberichte Offline | Überprüfen Sie, ob das Modul aktiviert ist, Cron läuft und der Server Internetzugang hat |
| Modulberichte Degraded | Öffnen Sie Cron Jobs → Logs, überprüfen Sie wiederholte Fehler und die Warteschlange und überwachen Sie dann, ob sich der Status wiederherstellt |
| Das Modul meldet Unknown nach einer neuen Verbindung | Warte ein paar Minuten und lass Cron einmal laufen |
| Alte oder fehlende Dashboard-Daten | Überprüfe den Modulstatus und öffne die Data sync, um eine Neusynchronisation anzufordern |
| Manual sync is rate limited to once per hour per entity type | Warte, bis das Zeitlimit abgelaufen ist, bevor du den Datentyp erneut ausführst |
| Synchronisations-Jobberichte Failed | Öffnen Sie die Daten, beheben Sie die Ursache und führen Sie den Auftrag erneut aus |
| Unauthorized: Invalid or missing API Key | Überprüfen Sie den Store-API-Schlüssel, wählen Sie Save configuration aus oder verbinden Sie sich erneut mit OAuth |
| Unauthorized: invalid or missing cron token. |
Widget wird nicht angezeigt
Schau in folgender Reihenfolge nach:
- Show Widget aktiviert oder die Test-IP befindet sich im Preview IPs.
- Du hast Save configuration ausgewählt.
- Der aktuelle Domainname befindet sich im Allowed storefront domains.
- Das Modul befindet sich nicht in Offline Zustand.
- Der Browser verwendet kein altes JavaScript; Versuchen Sie eine harte Aktualisierung oder ein Inkognito-Fenster.
- Wenn der Test am Telefon ist, ist Show on Mobile an.
| Botschaft | Was zu tun ist |
|---|---|
| Widget origin is not allowed for this shop | Der Inhaber fügt den korrekten Domainnamen unter Einstellungen → Domains & Access hinzu und wählt dann Save rules |
| Invalid widget key | Verbinden Sie OAuth wieder oder aktualisieren Sie einen neuen Widget-Schlüssel in Ihrer aktuellen Konfiguration |
| Failed to save widget configuration | Überprüfe die Verbindung, Berechtigungen und Planlimits und speichere dann erneut |
| Upgrade to Starter or higher to allow image uploads | Upgrade auf Starter oder höher oder schalte Allow image uploads |
Chat- und KI-Assistenten
| Botschaft oder Symptom | Was zu tun ist |
|---|---|
| Der Chat öffnet sich, aber die KI antwortet nicht | Überprüfen Sie Quoten, Modulstatus, synchronisierte Daten und Service-Benachrichtigungen |
| You are sending messages too fast... | Warte ein paar Sekunden und reiche dann erneut ein |
| AI credits have been exhausted | Eigentümer kaufen mehr Credits, aktualisieren ihren Plan oder warten auf ein neues Limit |
| Too many requests. Please try again later | Warte und versuche es erneut; Wenn es bei echtem Verkehr häufig vorkommt, kontaktiere den Support |
| Service is temporarily unavailable | Versuchen Sie es später noch einmal; Agenten können Konversationen übernehmen, wenn der Chat-Posteingang noch aktiv ist |
| Der Assistent gibt eine allgemeine Antwort | Überprüfen Sie Produktbeschreibungen, Richtlinienseiten, Synchronisations- und Assistentenanweisungen |
| Message could not be sent. | Überprüfe die Verbindung und versuche es erneut |
| Could not send the image. | Überprüfen Sie das Bildformat, die Dateigröße und ob der Plan das Hochladen von Bildern erlaubt |
Login und Sicherheit
| Botschaft | Was zu tun ist |
|---|---|
| Invalid credentials | Überprüfe E-Mail, Passwort und Caps Lock; Benutze Forgot password bei Bedarf |
| Account is not verified | Öffnen Sie eine Verifizierungs-E-Mail oder fordern Sie einen Link an, den Link erneut zu senden |
| Account is suspended or locked | Kontaktieren Sie den Support über offizielle Kanäle |
| TOTP code is required | Geben Sie einen sechsstelligen Code aus einer Authenticator-App ein |
| TOTP code is invalid | Warte auf einen neuen Code und prüfe, ob dein Handy seine Zeit automatisch einstellt |
| Refresh token has expired | Melde dich wieder im Dashboard an |
| Unvollständige, sensible Operation | Überprüfe deine Rolle und führe die erneute Authentifizierung durch |
| You need an active shop membership... | Überprüfen Sie Ihren gewählten Shop und Ihren Mitgliedschaftsstatus |
Wenn du dein Authentifizierungsgerät verlierst, verwende einen ungenutzten Wiederherstellungscode. Senden Sie keine TOTP- oder Wiederherstellungscodes an andere.
Pläne und Grenzen
| Botschaft | Was zu tun ist |
|---|---|
| Image search is not available on the current plan | Upgrade auf Starter oder höher oder schalte die Funktion aus |
| Recommendations are not available on the current plan | Upgrade auf Launch oder höher oder schalte Empfehlungen aus |
| The monthly recommendation request quota has been reached | Warten Sie auf die nächste Quotenperiode oder aktualisieren Sie den Plan |
| Current usage exceeds the selected plan limits | Reduzieren Sie Ihren Verbrauch unter das Limit oder wählen Sie einen anderen Tarif |
| Your current plan does not allow connecting another shop | Führen Sie ein Upgrade durch oder nutzen Sie einen Shop innerhalb der aktuellen Tarifgrenzen |
| Image storage quota exceeded | Löschen Sie unnötige Daten, falls es eine geeignete Option gibt, oder aktualisieren Sie den Tarif |
Wenn Sie den Support kontaktieren müssen
Vorbereitung:
- Shopname und Website-Domainname.
- Vollständiger Screenshot der Fehlermeldung.
- Der Zeitpunkt des Auftretens, mit der Zeitzone.
- Gerade Schritte unternommen.
- Ob der Fehler alle oder nur ein Konto, Gerät oder eine IP-Adresse betrifft.
- Der relevante Eintrag in Cron Jobs → Logs, falls zutreffend.
Senden Sie keine Passwörter, TOTP-Codes, Wiederherstellungscodes, Modulgeheimnisse, API-Schlüssel, Widget-Schlüssel oder Cron-Token.