Dieser Artikel bietet eine umfassende Anleitung zur Fehlerbehebung bei technischen Problemen mit deiner WooCommerce- und Gelato-Integration. Von der Überprüfung des Zustands der Gelato-App bis hin zum Verständnis und der Nutzung von Webhooks — wir haben alles für dich parat.
Status deiner Gelato-App in WooCommerce überwachen
Probleme mit deiner WooCommerce-Integration? Dein erster Anlaufpunkt sollte der Gelato-App-Status in deinem WordPress/WooCommerce-Dashboard sein. So findest du ihn:
Wechsle zum Bereich "Gelato-App".
Klicke auf "Status".
Diese Seite zeigt eine Momentaufnahme der Gesundheit deiner Gelato‑App. Wenn du auf Probleme stößt, teile den kompletten Inhalt dieser Statusseite mit unserem Kundendienstteam, damit wir dir schnell helfen können.
Mit Webhooks in WooCommerce arbeiten
Webhooks fungieren als Boten zwischen deinem WooCommerce-Shop und Gelato und sorgen für einen nahtlosen Datenfluss. Für eine reibungslose Integration sollten sechs spezifische Webhooks aktiv sein. So findest du sie:
Gehe zu deinem WooCommerce-Dashboard.
Klicke auf „Einstellungen“.
Wähle „Erweitert“ aus.
Wähle "Webhook".
Deine Webhooks-Seite sollte so aussehen:
Webhook-Protokolle freischalten
Wenn deine Webhooks korrekt konfiguriert zu sein scheinen, du aber trotzdem Verbindungs- oder Bestellprobleme hast, wirf einen Blick in deine Webhook-Protokolle, um mehr Einblicke zu erhalten. Du kannst auf diese Protokolle zugreifen über:
Navigiere zu "WooCommerce".
Wähle „Status“ aus.
Wähle "Protokolle".
Behebung häufiger Probleme in WooCommerce
WooCommerce Webhooks-Fehler
Wenn in deiner Gelato-App ein Webhook-Fehler angezeigt wird ("WooCommerce Webhooks => FAIL"), ist ein Reset fällig. Dabei werden die erforderlichen Gelato REST API- und Webhook-Einstellungen in WooCommerce entfernt und neu installiert.
Es gibt zwei Optionen:
Zurücksetzen über das Plugin
Gehe zu "Gelato" -> "Status".
Suche unten links den Button „Plugin zurücksetzen“ und klicke darauf. Dadurch wird dein Shop von Gelato getrennt und die zugehörigen API- und Webhook-Einstellungen werden entfernt.
Verbinde deinen Shop erneut mit Gelato, um die Integration wiederherzustellen.
Plugin deaktivieren und reaktivieren
Gehe im WordPress-Dashboard zum Bereich „Plugins“.
Deaktiviere die Gelato-Integration für das WooCommerce-Plugin. Dadurch werden die Gelato REST-API- und Webhook-Einstellungen automatisch entfernt.
Aktiviere das Plugin erneut, um die Verbindung wiederherzustellen und die nötigen Einstellungen zu konfigurieren.
Fehler bei der Website-Weiterleitung
Wenn der Status deiner Gelato-App „Check site redirection => FAIL“ anzeigt, ist eine Anpassung der Konfiguration in deinen WordPress-Einstellungen erforderlich.
Navigiere zu „Einstellungen“ -> „Allgemeine Pflegehinweise“ in deinem WordPress-Dashboard.
Stelle sicher, dass die Felder für Website-Adresse und WordPress-Adresse identisch sind und HTTPS verwenden. So ist die Kommunikation zwischen deinem Shop und Gelato sicher.
Wenn du Hilfe beim Einrichten von SSL brauchst, schau in die WooCommerce-Dokumentation: https://woocommerce.com/document/ssl-and-https/.
Weitere Fehlerbehebung
Prüfe, ob andere Plugins außer Gelato das Problem verursachen. Deaktiviere sie nacheinander, um zu sehen, ob das Problem behoben ist. Wenn das Deaktivieren eines Plugins das Problem löst, ist dieses Plugin wahrscheinlich nicht mit Gelato kompatibel.
Wenn die Ergebnisse des Gesundheitschecks "OK" anzeigen und kein Status "Fail" erscheint, solltest du in Erwägung ziehen, den WooCommerce support zu kontaktieren. Sie können dir helfen, mögliche Probleme mit deinem Shop zu identifizieren und zu beheben.
Sehr oft werden Probleme mit der Integration durch Sicherheits-Plugins oder Servereinstellungen verursacht. Bitte stelle sicher, dass unser Gelato-Plugin in deinem Shop nicht blockiert wird und dass unsere IP-Bereiche in deinen Firewall-/Servereinstellungen auf der Allowlist stehen.
Du solltest die folgenden IP-Bereiche auf die Allowlist setzen:
52.208.0.0/16
54.217.0.0/16
54.229.0.0/16
Erklärung:
/16bedeutet, dass alle IPs von52.208.0.0bis52.208.255.255abgedeckt sind.Das gilt ähnlich für die beiden anderen Bereiche.