Zum Hauptinhalt springen

Fehlerbehebung bei WooCommerce (WordPress) Verbindungsproblemen

Behebe Verbindungsfehler mit dem WooCommerce-Plugin, Autorisierungsschleifen, API-Zugriffsprobleme und Firewall-Blockierungen in Omnisend.

Verfasst von Ira

Wenn Sie Ihren WooCommerce Der Webshop nicht mit Omnisend verbinden können, eine "Omnisend kann keine Verbindung herstellen"-Fehlermeldung sehen oder in einer Autorisierungsschleife stecken bleiben, wird Ihnen dieser Leitfaden helfen, das Problem zu diagnostizieren und zu beheben.

Die meisten Verbindungsprobleme stammen von Konflikten mit Plugins, Firewall-/Sicherheitseinstellungen, API-Zugriffsrestriktionen oder einer falschen Einrichtung des Webshops. Befolgen Sie die untenstehenden Diagnose Schritte, um das Problem zu identifizieren und zu lösen.

Vor der Fehlersuche: Stellen Sie sicher, dass Sie die Haupt-WooCommerce-Einrichtungsanleitung und die Installationsschritte abgeschlossen.

Bevor Sie beginnen

Überprüfen Sie, ob diese Voraussetzungen erfüllt sind. Wenn eine fehlt, schlägt die Verbindung fehl, unabhängig von den Fehlersuche-Schritten.

Erforderlich für die Verbindung:

  • ✅ WooCommerce 3.6+ und WordPress 5.0+. Frühere Versionen unterstützen die REST API v3 (erforderlich von Omnisend) nicht. Gehen Sie zu Plugins → Installierte Plugins, um die Versionen zu überprüfen.

  • ✅ Aktives HTTPS (SSL-Zertifikat). Ihre Webshop-URL muss mit https:// beginnen. Omnisend kann auf Stores ohne gültige SSL-Zertifikate nicht zugreifen.

  • ✅ WordPress im Domain-Wurzelverzeichnis installiert. WordPress muss unter yourdomain.com oder subdomain.yourdomain.com sein, nicht unter yourdomain.com/store. Das Plugin schlägt fehl, wenn WordPress auf einem Seitenpfad installiert ist.

  • ✅ REST API-Zugriff aktiviert. Öffnen Sie yourdomain.com/wp-json/wc/v3/products in Ihrem Browser. Wenn Sie Produktdaten oder eine Fehlermeldung sehen, funktioniert die API. Wenn Sie einen 404-Fehler sehen, ist die REST API blockiert – siehe Abschnitt REST API blockiert.

  • ⚠️ Leerer Webshop-Slot (wenn Sie bereits eine andere Plattform verbunden haben). Wenn Sie Shopify, BigCommerce oder einen anderen Webshop mit Omnisend verbunden haben, müssen Sie einen neuen Webshop-Slot erstellen, bevor Sie WooCommerce verbinden. Jede Plattform benötigt ihren eigenen Webshop, um Datenmischungen zu verhindern.

Verbindungsdiagnose-Checkliste

Arbeiten Sie diese Schritte in der richtigen Reihenfolge durch. Versuchen Sie nach jedem Schritt, sich erneut zu verbinden. Wenn die Verbindung erfolgreich ist, haben Sie das Problem gefunden.

Schritt 1. Voraussetzungen überprüfen

Bestätigen Sie, dass alle Anforderungen aus Bevor Sie beginnen erfüllt sind:

  • WooCommerce 3.6+ installiert

  • HTTPS aktiv (URL beginnt mit https://)

  • WordPress im Domain-Stamm (nicht im /store-Unterverzeichnis)

  • REST API zugänglich (testen Sie unter yourdomain.com/wp-json/wc/v3/products)

  • Leerer Webshop-Slot erstellt (wenn Sie andere Plattformen verbunden haben)

Schritt 2. Bekannte problematische Plugins deaktivieren

Diese Plugins blockieren häufig Omnisend-Verbindungen. Deaktivieren Sie sie vorübergehend nacheinander, und versuchen Sie nach jedem Schritt erneut, sich zu verbinden:

Um ein Plugin zu deaktivieren, gehen Sie zu WordPress Admin → Plugins → Installierte Plugins → klicken Sie auf Deaktivieren.

  • WP Crontrol – Stört Omnisend-Cron-Jobs

  • LiteSpeed Cache – Entfernt Autorisierungsheader

  • Really Simple Security – Blockiert REST API-Anfragen

  • Wordfence / Cloudflare – Firewall blockiert Omnisend-IPs

  • Perfmatters – Kann REST API oder Skripte deaktivieren

💡 Nachdem die Verbindung erfolgreich ist: Aktivieren Sie die Plugins nacheinander wieder, um den Übeltäter zu identifizieren.

Schritt 3. Whitelist Omnisend-IP-Adressen

Wenn Sie Wordfence, Cloudflare, Really Simple Security oder ein anderes Firewall-Plugin verwenden, blockieren diese möglicherweise Omnisend-Anfragen.

Springen Sie zu Firewall- & Sicherheits-Plugin-Fehlerbehebungsbereich, um Omnisend-IPs und Benutzeragenten auf die Whitelist zu setzen.

So whitelisten Sie:

Schritt 4. Cache leeren & im Inkognito-Modus testen

  1. Leeren Sie den Cache Ihres Browsers (Strg+Shift+Entf in Chrome/Edge, Cmd+Shift+Entf in Safari).

  2. Öffnen Sie ein Inkognito-/privates Fenster.

  3. Melden Sie sich bei WordPress an und versuchen Sie erneut, eine Verbindung herzustellen.

Wenn das Problem im Inkognito-Modus weiterhin besteht, verursacht wahrscheinlich eine Browsererweiterung oder eine zwischengespeicherte Sitzung das Problem. Deaktivieren Sie vorübergehend Erweiterungen oder verwenden Sie einen anderen Browser.

Schritt 5. Verbindungstatus überprüfen

In WordPress: Gehen Sie zur Omnisend-Plugin-Seite. Der Status sollte "zeigen" "Verbunden."

In Omnisend: Gehen Sie zu Der Webshop-Einstellungen → Der Kontakt → Überprüfen Sie, ob Ihre Webshop-URL mit Ihrer Live-Domain übereinstimmt (nicht localhost oder staging).

Test-Endpunkt:
Öffnen Sie yourdomain.com/wp-json/omnisend-api/v1/connected in Ihrem Browser. Es sollte "true" zurückgeben. true.

Spezifische Fehlerszenarien

Wenn die Diagnoseliste Ihr Problem nicht gelöst hat, finden Sie das Fehlerszenario unten, das Ihren Symptomen entspricht.

Autorisierungs-Redirect-Schleife

Was Sie sehen:

  • Sie klicken auf "Zustimmen" im WooCommerce Einwilligungsfenster.

  • Sie werden zurück zu "Ihr Konto verbinden" umgeleitet, ohne die Einrichtung abzuschließen.

  • Die Verbindung wird nie beendet.

Warum das passiert: Ein Caching-Plugin, Sicherheits-Plugin oder WP Crontrol entfernt den Autorisierungsheader während des Genehmigungsprozesses.

Wie man es behebt:

  1. Deaktivieren Sie WP Crontrol: Gehen Sie zu Plugins → Installierte Plugins → Deaktivieren Sie WP Crontrol.

  2. Deaktivieren Sie vorübergehend Caching-Plugins: Deaktivieren Sie LiteSpeed Cache, WP Rocket oder ein beliebiges Caching-Plugin.

  3. Leeren Sie den Browser-Cache und öffnen Sie ein Inkognito-Fenster.

  4. Versuchen Sie erneut, eine Verbindung herzustellen.

  5. Wenn die Schleife weiterhin besteht: Kontaktieren Sie Ihren Hosting-Anbieter (SiteGround, Bluehost, GoDaddy) und bitten Sie ihn zu bestätigen, dass der Authorization-Header auf Serverseite nicht entfernt wird.

💡 Nach erfolgreicher Verbindung: Aktivieren Sie die Plugins nacheinander wieder, um den Blocker zu identifizieren.

Plugin zeigt verbunden, aber Omnisend sagt "Verbindung nicht möglich"

Was Sie sehen:

  • Das Omnisend-Plugin in WordPress zeigt "aktiv" oder "verbunden."

  • Das Omnisend-Dashboard zeigt ein rotes Banner an: "Omnisend kann keine Verbindung zu Ihrem WooCommerce herstellen."

  • Daten werden nicht zwischen WooCommerce und Omnisend synchronisiert.

Warum das passiert: Omnisend kann nicht auf deine WooCommerce REST API zugreifen, obwohl das Plugin installiert ist.

Wie man es behebt:

  1. Überprüfen Sie den API-Schlüssel: Gehen Sie zu WooCommerce → Einstellungen → Erweitert → REST API und überprüfen Sie, ob der Omnisend API-Schlüssel vorhanden und nicht abgelaufen oder widerrufen ist.

  2. Test API-Zugriff: Öffnen yourdomain.com/wp-json/omnisend-api/v1/connected in Ihrem Browser.

    • Wenn es true zurückgibt, funktioniert die Verbindung – warten Sie 10 Minuten und aktualisieren Sie Ihr Omnisend-Dashboard.

    • Wenn es false oder 404 zurückgibt, ist die API blockiert – siehe Abschnitt REST API Blockiert.

  3. Whitelist Omnisend-IPs: Fügen Sie die Omnisend-IP-Adressen zu Wordfence, Cloudflare oder Ihrer Firewall hinzu – siehe Firewall- & Sicherheits-Plugin-Fehlerbehebungsbereich.

  4. Überprüfen Sie die URL des Webshops: Gehe zu Omnisend → Der Webshop-Einstellungen → Der Kontakt und bestätigen Sie, dass Ihre Webshop-URL mit Ihrer tatsächlichen Domain übereinstimmt (nicht localhost oder eine Staging-URL wie staging.yourdomain.com).

"Add Permissions"-Schaltfläche fehlt

Was Sie sehen: Nach der Installation des Plugins sehen Sie nicht die "Add permissions"-Schaltfläche auf der Omnisend-Plugin-Seite.

Warum das passiert: Ein alter Omnisend API-Schlüssel ist noch aktiv, was verhindert, dass die neue Berechtigungsaufforderung erscheint.

Wie man es behebt:

  1. Gehe zu WooCommerce → Einstellungen → Erweitert → REST API.

  2. Finden Sie den Omnisend Schlüssel in der Liste.

  3. Klicken Sie auf Widerrufen, um es zu löschen.

  4. Gehen Sie zurück zur Omnisend-Plugin-Seite.

  5. Die Schaltfläche "Berechtigungen hinzufügen" sollte jetzt erscheinen. Klicken Sie darauf und genehmigen Sie.

Leere Seite oder "Nicht gefunden"-Fehler während der Verbindung

Was Sie sehen: Wenn Sie auf "Verbinden" oder "Genehmigen," sehen Sie:

  • Eine leere weiße Seite.

  • "Die angeforderte URL wurde auf diesem Server nicht gefunden" (404-Fehler).

  • Browserfehler anstelle des Genehmigungs-Pop-ups.

Warum das passiert: Dein Server entfernt den Authorization-Header oder die WooCommerce REST API ist deaktiviert.

Wie man es behebt:

  1. Fügen Sie den Autorisierungsheader zu .htaccess hinzu:
    Öffnen Sie your .htaccess-Datei (im Stammverzeichnis von WordPress über FTP oder cPanel-Dateimanager) und fügen Sie diese Zeile hinzu:

    SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

  2. Speichern Sie die Datei und versuchen Sie erneut, eine Verbindung herzustellen.

  3. Überprüfen Sie den REST API-Zugriff:
    Gehen Sie zu yourdomain.com/wp-json/wc/v3/products in Ihrem Browser.

  4. Kontaktieren Sie Ihren Host:
    Einige Hosts (Bluehost, GoDaddy, WP Engine) blockieren standardmäßig REST API-Endpunkte. Bitten Sie sie, /wp-json/ Zugriff zu ermöglichen.

REST API blockiert

Was Sie sehen: Die Verbindung schlägt fehl, und yourdomain.com/wp-json/wc/v3/products gibt einen 404-Fehler oder "REST API ist deaktiviert." zurück.

Warum das passiert: REST API ist von Ihrem Host, Sicherheits-Plugin oder den Theme-Einstellungen deaktiviert.

Wie man es behebt:

  1. Überprüfen Sie die Sicherheits-Plugins:

    • In Wordfence: Gehen Sie zu Wordfence → Firewall → Firewall-Optionen und stellen Sie sicher, dass die REST API nicht blockiert ist.

    • In Really Simple Security: Gehen Sie zu Einstellungen → REST API und erlauben Sie den Zugriff auf die REST API.

  2. Überprüfen Sie die Theme-Einstellungen: Einige Themes (z.B. Divi, Avada) enthalten Optionen zum Deaktivieren der REST API. Überprüfen Sie die Theme-Einstellungen und aktivieren Sie sie erneut.

  3. Fügen Sie eine .htaccess-Regel hinzu: Füge the Authorization header fix from

  4. Kontaktieren Sie den Hosting-Anbieter: Bitten Sie ihn zu bestätigen /wp-json/ Endpunkte sind auf Serverebene nicht blockiert (häufig bei Bluehost, GoDaddy und WP Engine).

"Webshop bereits verbunden" Fehler

Was Sie sehen: Ein Banner erscheint:

  • "Dieser Omnisend-Webshop ist bereits verbunden. Wählen Sie einen anderen Webshop aus Ihrem Konto und versuchen Sie es erneut."

  • "Kein verfügbarer Webshop-Slot"

Warum das passiert: Sie haben bereits einen Webshop (Shopify, WooCommerce, BigCommerce usw.) mit Omnisend verbunden, und Sie haben keinen neuen Webshop-Slot für diese WooCommerce-Seite erstellt, oder Ihre WooCommerce-Domain war zuvor mit einem anderen Omnisend-Konto (einschließlich Testkonten) verbunden.

So beheben Sie:

  • Wenn Sie eine andere Plattform verbunden haben:

  1. Erstellen Sie einen neuen Webshop-Slot in Omnisend:
    Gehen Sie zu Konto-Einstellungen → Stores → Neuen Webshop hinzufügen.

  2. Wechseln Sie zum neuen leeren Webshop:
    Klicken Sie auf den Webshop-Wechsler (oben rechts im Omnisend Dashboard → Webshop wechseln) und wählen Sie den neuen Webshop aus.

  3. Zurück zu WordPress und klicken Sie erneut auf "Ihr Konto verbinden".

  4. Genehmigen Sie die Verbindung im Pop-up.

💡 Warum? Jede Plattform (Shopify, WooCommerce, BigCommerce) muss mit einem separaten Webshop in Ihrem Omnisend-Konto verbunden werden, um Datenmischung zu verhindern.

  • Wenn Ihre Domain zuvor mit einem anderen Omnisend-Konto verbunden war:

Kontaktieren Sie unseren Support unter [email protected] oder im In-App-Chat, um den alten Link zu trennen.

Verbindung funktionierte vorher (plötzlich gestoppt)

Was du siehst:

  • Das Plugin war wochen- oder monatelang verbunden.

  • Zeigt plötzlich "konnte nicht verbinden" oder die Synchronisierung stoppt.

  • Es wurden keine Änderungen vorgenommen (an die Sie sich erinnern).

Warum das passiert:

  • Ihre Webshop-URL hat sich leicht geändert (hinzugefügt/entfernt www.).

  • Ein aktuelles Plugin- oder WooCommerce-Update hat die API-Berechtigungen widerrufen.

  • Firewall-Einstellungen wurden während eines Server-Updates geändert.

  • SSL-Zertifikat abgelaufen.

So beheben Sie:

  1. Überprüfen Sie, ob sich Ihre Webshop-URL geändert hat: Gehe zu Omnisend → Der Webshop-Einstellungen → Kontaktinformationen. Wenn die URL nicht mit Ihrer tatsächlichen Domain übereinstimmt (prüfen Sie auf www. Unterschiede), aktualisieren Sie es.

  2. Überprüfen Sie, ob der API-Schlüssel vorhanden ist: Gehen Sie zu WooCommerce ➡ Einstellungen → Erweitert → REST API. Wenn der Omnisend-Schlüssel fehlt, gehen Sie zur Omnisend-Plugin-Seite → klicken Sie "Berechtigungen hinzufügen" → Genehmigen.

  3. Überprüfen Sie Ihr SSL-Zertifikat: Test unter SSL-Checker. Wenn abgelaufen oder ungültig, erneuern Sie es über Ihren Hosting-Anbieter (viele bieten kostenlose Let's Encrypt-Zertifikate an).

  4. Wenn nichts davon funktioniert: Gehen Sie zur Omnisend-Plugin-Seite → klicken Sie auf "Berechtigungen hinzufügen" → Genehmigen → warten Sie 10 Minuten → aktualisieren.

4a1 Wenn der Webshop verbunden ist, aber die Daten sich immer noch nicht aktualisieren, siehe Daten werden nach der Verbindung nicht synchronisiert unten.

Plugin-Update-Banner verschwindet nicht

Was Sie sehen: Sie haben das Omnisend-Plugin aktualisiert, aber ein Banner sagt weiterhin "Update erforderlich" oder "Verbindungsproblem."

Warum das passiert:;Vorübergehende Die Wartezeit beim Synchronisieren der Plugin-Berechtigungen mit Omnisend.

So beheben Sie es:

  1. Gehen Sie zur Omnisend-Plugin-Seite in WordPress.

  2. Klicken Sie auf Berechtigungen hinzufügen (wenn die Schaltfläche erscheint).

  3. Klicken Sie auf Genehmigen im WooCommerce-Einwilligungsfenster.

  4. Warte 510 Minuten, damit die Änderungen wirksam werden.

  5. Leeren Sie den Cache Ihres Browsers und aktualisieren Sie die Seite.

Wenn das Banner nach 10 Minuten weiterhin angezeigt wird, siehe Plugin zeigt verbunden, aber Omnisend sagt "Verbindung nicht möglich"-Bereich.

Firewall- & Sicherheits-Plugin-Fehlerbehebungen

Wenn du Wordfence, Cloudflare, Really Simple Security oder ein beliebiges Firewall-Plugin verwendest, musst du Omnisend-IP-Adressen und User-Agents auf die Whitelist setzen.

Omnisend-IP-Adressen zur Whitelist:

Füge diese IPs zu deiner Firewall-Whitelist hinzu:

  • 34.170.162.11

  • 34.56.62.59

  • 34.56.108.215

  • 34.133.59.36

  • 34.58.66.146

  • 35.184.130.5

  • 35.232.14.89

Wordfence

Um Omnisend-IPs in Wordfence auf die Whitelist zu setzen:

  1. Gehen Sie zu WordPress Admin Wordfence Firewall.

  2. Klicken Sie auf Firewall verwalten scrollen Sie zu "Erlaubte IP-Adressen."

  3. Füge jede Omnisend-IP-Adresse in einer neuen Zeile ein.

  4. Klicken Sie auf Änderungen speichern.

  5. Gehen Sie zurück zu WordPress und versuchen Sie erneut, eine Verbindung herzustellen.

Cloudflare

Um Omnisend in Cloudflare auf die Whitelist zu setzen:

  1. Melden Sie sich bei Ihrem Cloudflare-Dashboard an

  2. Gehen Sie zu Sicherheit WAF (Web Application Firewall)

  3. Klicken Sie auf Regel erstellen

  4. Setzen Sie Regelname: Erlaube Omnisend (oder ähnlich)

  5. Setzen Sie Feld: Benutzeragent | Operator: enthält | Wert: Omnisend/1.0 (groß-/kleinschreibung beachten)

  6. Setzen Sie Aktion: Überspringen

  7. Wählen Sie alle Komponenten zum Überspringen aus

  8. Klicke auf Bereitstellen

Um Omnisend-IPs auf die Whitelist zu setzen:

  1. Gehen Sie zu Sicherheit WAF Tools

  2. Scrollen Sie zu IP-Zugriffsregeln

  3. Fügen Sie jede Omnisend-IP hinzu (siehe Liste oben) und setzen Sie Aktion auf Erlauben

  4. Klicken Sie auf Hinzufügen

Nach dem Speichern installieren Sie das Omnisend-Plugin in WordPress erneut und stellen Sie die Verbindung wieder her.

Really Simple Security

Um Omnisend-Anfragen zuzulassen:

  1. Gehen Sie zu WordPress Admin Really Simple Security Einstellungen

  2. Klicken Sie auf REST API

  3. Stellen Sie sicher, dass die REST API nicht deaktiviert ist

  4. Gehen Sie zu Firewall IP-Zulassungsliste

  5. Fügen Sie jede Omnisend-IP-Adresse hinzu (siehe Liste oben)

  6. Speichern Sie und versuchen Sie erneut, eine Verbindung herzustellen

Daten synchronisieren sich nach der Verbindung nicht

Wenn Ihr Webshop verbunden ist, aber Kontakte, Bestellungen, Produkte oder Produktkategorien fehlen oder veraltet aussehen, befolgen Sie diese Schritte.

Was Sie sehen:

  • Kontakte, Bestellungen, Produkte oder Produktkategorien fehlen in Omnisend.

  • Die Daten haben nach einem Plugin-Update oder einer Änderung des Webshops aufgeh1rt, sich zu aktualisieren.

  • Produkte oder Kategorien erscheinen nicht, obwohl der Webshop als verbunden angezeigt wird.

Warum das passiert: Die Synchronisierung erfolgt vollständig über das Backend von Omnisend über die WooCommerce REST API und Webhooks. Alles, was Omnisend daran hindert, die API Ihres Shops zu erreichen – oder Webhooks daran hindert, Omnisend zu erreichen – wird die Synchronisierung stoppen.

So beheben Sie es:

  1. Geben Sie Zeit für den ersten Import. Nach der Verbindung oder dem Update auf die Plugin-Version 1.20.0 oder höher führt Omnisend eine einmalige Nachfüllung aller vorhandenen Daten durch. Dies kann bis zu 24 Stunden für große Shops dauern.

  2. Bestätige, dass das Plugin auf Version 1.20.0 oder höher aktualisiert ist. In älteren Versionen kann das Plugin weiterhin einige Daten pushen, während Omnisends Backend sie ebenfalls synchronisiert. Aktualisiere über Plugins → Updates in WordPress.

  3. Überprüfen Sie auf Konflikte mit Plugins. Sicherheits-, Firewall-, Caching- oder Plugins, die die WooCommerce REST API ändern, können die Synchronisierung blockieren. Deaktivieren Sie vorübergehend verdächtige Plugins, um den Konflikt zu isolieren. Häufige Übeltäter: Wordfence, LiteSpeed Cache, Really Simple Security, Perfmatters, WP Crontrol.

  4. Überprüfen Sie, ob die IPs von Omnisend auf der Whitelist stehen. Siehe die Omnisend-IP-Adressen zur Whitelist hinzufügen im Abschnitt Firewall & Sicherheits-Plugin-Lösungen.

  5. Überprüfen Sie die WooCommerce API-Anmeldeinformationen. Gehen Sie zu WooCommerce ➡ Einstellungen → Erweitert → REST API und bestätigen Sie, dass der Omnisend API-Schlüssel vorhanden ist und nicht widerrufen oder regeneriert wurde. Wenn er fehlt, gehen Sie zur Omnisend-Plugin-Seite → klicken Sie Berechtigungen hinzufügen → Genehmigen.

  6. Prfen Sie auf eine Diskrepanz zwischen Staging und Produktion. Wenn Ihr Webshop in einer Staging-Umgebung verbunden war und sich die URL des Live-Webshops gendert hat, versucht Omnisend mglicherweise, die falsche Umgebung zu erreichen. Gehen Sie zu Omnisend → Der Webshop-Einstellungen → Der Kontakt Informationen und bestätigen Sie, dass die Webshop-URL mit Ihrer Live-Produktionsdomain übereinstimmt. Wenn nicht, verbinden Sie das Plugin erneut.

Wenn keine der oben genannten Lösungen das Problem behebt, kontaktieren Sie unser Support-Team unter [email protected] oder über den In-App-Chat.

Plugin-Konflikte & permanente Lösungen

Wenn das Deaktivieren eines Plugins Ihre Verbindung behoben hat, verwenden Sie diese dauerhaften Lösungen, damit Sie das Plugin aktiv halten können.

WP Crontrol

Problem: Verwaltet WordPress-Cron-Jobs und blockiert Omnisend-Hintergrundprozesse.

Behebung: Halten Sie es deaktiviert während der Verbindung. Nach der Verbindung nur wieder aktivieren, wenn Sie es für andere Aufgaben benötigen. Wenn Probleme weiterhin bestehen, lassen Sie es deaktiviert.

LiteSpeed Cache

Problem: Entfernt Autorisierungsheader, was zu Verbindungsfehlern führt.

Lösung:

  1. Gehen Sie zu WordPress Admin LiteSpeed Cache Ausnehmen

  2. Unter URI Exclude hinzufügen: /wp-json/omnisend*

  3. Einstellungen speichern und erneut verbinden

Cloudflare (Turnstile / Formularmodul)

Problem: Blockiert Omnisend-Bot-Anfragen.

Behebung: Whitelist den User-Agent Omnisend/1.0 (groß-/kleinschreibung beachten) in Cloudflare WAF-Regeln – siehe Cloudflare-Abschnitt.

Perfmatters

Problem: Kann die REST API oder JavaScript, das für die Verbindung erforderlich ist, deaktivieren.

Beheben:

  1. Gehe zu Perfmatters Einstellungen Deaktivieren

  2. Stellen Sie sicher, dass die REST API nicht deaktiviert ist

  3. Erneut verbinden

Erweiterte Fehlersuche

Klonen Ihres WooCommerce Webshops (Staging/Testumgebungen)

Wenn Sie Ihren WooCommerce Webshop klonen, um eine Test- oder Staging-Umgebung zu erstellen, können Sie neue Funktionen, Updates und andere Änderungen sicher testen, ohne Ihren Live-Webshop zu beeinträchtigen.

Wie das Omnisend-Plugin funktioniert:Das Omnisend-Plugin sorgt fr eine klare Unterscheidung zwischen Ihrer Produktions- und Staging-Umgebung, indem es automatisch die Staging-Umgebung vom Senden von Daten an Ihren Live-Webshop trennt. Es erfordert auch, dass die Staging-Umgebung mit einer Testmarke verbunden ist.

Schritte zum Einrichten einer Staging-Umgebung

Schritt 1: Aktionen in Ihrem Produktions-Webshop.Klonen Sie Ihren Webshop mit den Tools Ihres Hosting-Anbieters, einem WordPress-Plugin (WP Staging, Duplicator) oder einer manuellen FTP/Datenbankkopie. Dies schafft die gewnschte Umgebung fr Tests oder andere Zwecke.

Schritt 2: Aktionen in Ihrem Staging-Webshop. Verbinden Sie das Staging-Plugin mit einer separate Testmarke in Omnisend (nicht Ihre Produktionsmarke). Dies stellt sicher, dass die Staging-Umgebung mit einer anderen Marke als Ihrem Live-Webshop verbunden ist. Das Plugin zeigt den Markennamen an, was es einfacher macht, zu unterscheiden, mit welcher Omnisend-Marke es verbunden ist.

Wichtige Hinweise

⚠️ Automatische Trennung: Wenn eine Produktionskopie erstellt wird, trennt sich das Staging-Plugin automatisch vom Haupt-Webshop, um zu verhindern, dass es Daten an die Produktionsumgebung sendet.

Das Omnisend-Plugin erkennt, wenn eine Staging-Umgebung erstellt wurde, und trennt sich von Ihrem Live-Webshop, damit keine Nicht-Produktionsdaten dorthin gesendet werden. Damit das Plugin die Umgebungsänderung erkennt, muss Ihre geklonte Staging-Umgebung die WordPress-Variable WP_ENVIRONMENT_TYPE auf "staging" oder "development" gesetzt haben.

Dies sollte entweder automatisch von deinem bevorzugten Klon-Tool eingestellt werden oder, wenn du manuell klonst, in deiner wp-config.php-Datei festgelegt werden, wie:

define('WP_ENVIRONMENT_TYPE', 'staging');

Wie man die Staging-Einrichtung überprüft

Wenn Sie ein Drittanbieter-Tool verwenden, um Ihren Shop zu klonen, und sicherstellen möchten, dass die erstellte Einrichtung korrekt ist, können Sie dies tun, indem Sie:

  1. Gehen Sie zum WordPress-Admin-Dashboard Ihres geklonten Shops

  2. Navigiere zu Werkzeuge Website-Gesundheit Info WordPress-Konstanten

  3. Überprüfe, ob WP_ENVIRONMENT_TYPE auf "staging" oder "development" gesetzt ist

Werte wie "production" oder "Undefined" sollten nur in Ihrem Produktions-Webshop erscheinen. Wenn sie in Ihrem geklonten Shop erscheinen, deutet das auf eine falsche Einrichtung hin, da das Omnisend-Plugin nicht erkennen würde, dass es sich trennen muss.

Für detaillierte Schritte, wie Sie Ihren WooCommerce Webshop klonen und eine Test- oder Staging-Umgebung erstellen, folgen Sie bitte diesen Anleitungen:

Markenname anzeigen: Das Omnisend-Plugin zeigt den Markennamen an, um dir zu helfen, leicht zu erkennen, mit welcher Marke es verbunden ist.

Probleme mit der Permalink-Struktur

Problem: Einige 404-Fehler werden behoben, wenn die Permalink-Struktur zurückgesetzt wird.

Beheben:

  1. Gehe zu WordPress Admin Einstellungen Permalinks.

  2. Klicke auf Änderungen speichern (auch ohne Änderungen vorzunehmen).

  3. Erneut verbinden.

SSL-Zertifikat-Probleme

Problem:A Ungültiges oder abgelaufenes SSL-Zertifikat verhindert den API-Zugriff.

Beheben:

  1. Überprüfe dein SSL-Zertifikat bei SSL Checker.

  2. Wenn abgelaufen oder ungültig, erneuere es über deinen Hosting-Anbieter (viele bieten kostenlose Let's Encrypt-Zertifikate an).

  3. Nach der Erneuerung erneut verbinden.

Server-Level-Authorization-Header-Blockierung

Problem: Einige Hosts (SiteGround, Bluehost, GoDaddy) entfernen standardmäßig den Authorization-Header.

Beheben:

  1. Füge diese Zeile in deine .htaccess-Datei (im WordPress-Stammverzeichnis) ein:

    SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

  2. Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Hosting-Anbieter und bitten Sie ihn, die Weiterleitung des Autorisierungs-Headers für REST-API-Anfragen zu aktivieren.

So beheben Sie API-Zugriffsprobleme

Aufgrund von API-Zugriffsproblemen werden Ihre Webshop-Daten nicht mit Omnisend synchronisiert. Dies verhindert, dass Sie Nachrichten an Ihre Zielgruppe senden. Wenn die Daten Ihres Shops nicht synchronisiert werden, könnte der API-Zugriff blockiert sein durch:

  • Sicherheits-Plugins (Drittanbieter).

  • Benutzerdefinierter PHP-Code, der den API-Zugriff verhindert.

  • WordPress- oder WooCommerce-Sicherheitseinstellungen.

Bitte kontaktieren Sie Ihre Entwickler, um mögliche Ursachen zu identifizieren und zu beheben.

Um zu überprüfen, ob die WooCommerce API zugänglich ist:

  1. Gehe zu WooCommerce → Einstellungen → Erweitert → REST API.

  2. Klicke auf Schlüssel hinzufügen.

  3. Geben Sie einen beliebigen Namen ein und klicken Sie auf API-Schlüssel generieren.

  4. Nimm den Verbraucherschlüssel und das Geheimnis und gib diese URL in deinen Browser ein:

    {shopDomain}/wp-json/wc/v3/products?consumer_key={consumer_key}&consumer_secret={consumer_secret}

  5. Wenn die Produktliste erscheint, funktioniert die API.

  6. Löschen Sie den Test-API-Schlüssel nach der Überprüfung.

Um zu überprüfen, ob die Omnisend API zugänglich ist:

  1. Aktualisiere auf die neueste Version des Omnisend-Plugins.

  2. Öffne {shopDomain}/wp-json/omnisend-api/v1/connected in deinem Browseres sollte true zurückgeben.

Überprüfe, ob deine Lösung funktioniert hat

Bestätige nach der Anwendung einer Lösung, dass die Verbindung aktiv ist:

  • In WordPress: Gehe zu der Omnisend-Plugin-Seite. Der Status sollte anzeigen "Verbunden."

  • In Omnisend: Gehe zu Die Zielgruppe → Kontakte und besttigen Sie, dass die Webshop-Kontakte angezeigt werden.

  • Test-Endpunkt: Öffne yourdomain.com/wp-json/omnisend-api/v1/connected in Ihrem Browser. Es sollte "true" zurückgeben. true.

Häufig gestellte Fragen

Das Plugin zeigt "verbunden" in WordPress an, aber Omnisend sagt "konnte nicht verbinden." Warum?
Das bedeutet, dass Omnisend nicht auf deine WooCommerce API zugreifen kann, obwohl das Plugin aktiv ist. Überprüfen Sie, ob Ihre WooCommerce REST API zugänglich ist, fügen Sie die IP-Adressen von Omnisend in Ihrer Firewall zur Whitelist hinzu und vergewissern Sie sich, dass die Store-URL in Omnisend mit Ihrer tatsächlichen Domain übereinstimmt (nicht localhost).

Was bedeutet "Die angeforderte URL wurde auf diesem Server nicht gefunden" während der Verbindung?
Dieser Fehler bedeutet, dass dein Server die WooCommerce REST API-Endpunkte blockiert oder falsch konfiguriert. Füge SetEnvIf Authorization "(.*)\" HTTP_AUTHORIZATION=$1 in deine .htaccess-Datei oder kontaktieren Sie Ihren Hosting-Anbieter, um den Zugriff auf die REST-API zu aktivieren.

Warum zeigt das Klicken auf "Verbinden" eine leere weiße Seite an?
Eine leere Seite während der Verbindung zeigt an, dass Ihr Server den Authorization-Header entfernt oder ein Plugin API-Anfragen blockiert. Füge the Authorization header fix to .htaccess (siehe oben), deaktiviere vorübergehend Caching/Sicherheits-Plugins und versuche es erneut.

Ich habe das Plugin aktualisiert, aber das Banner sagt immer noch "Aktualisierung erforderlich." Was jetzt?
Nach der Aktualisierung gehe zur Omnisend-Plugin-Seite in WordPress und klicke "Berechtigungen hinzufügen." Warte 5–10 Minuten, leere den Browser-Cache und lade die Seite neu. Wenn das Banner weiterhin angezeigt wird, siehe Plugin zeigt verbunden, aber Omnisend sagt "Kann nicht verbinden" Abschnitt.

WP Crontrol verursacht Probleme. Was macht dieses Plugin?
WP Crontrol verwaltet WordPress-Cronjobs (geplante Aufgaben). Es kann die Hintergrundprozesse von Omnisend stören. Deaktivieren Sie es vorübergehend, schließen Sie die Verbindung ab und aktivieren Sie es dann wieder. Wenn Probleme weiterhin bestehen, lassen Sie es deaktiviert oder kontaktieren Sie den Support.

Welche IP-Adressen muss ich für Omnisend auf die Whitelist setzen?
Setzen Sie diese IPs in Wordfence, Cloudflare, Really Simple Security oder einem anderen Firewall-Plugin auf die Whitelist: 34.170.162.11, 34.56.62.59, 34.56.108.215, 34.133.59.36, 34.58.66.146, 35.184.130.5, 35.232.14.89.

Ich benutze Cloudflare. Wie kann ich Omnisend auf die Whitelist setzen?
Gehen Sie zu Cloudflare → Security → WAF → Create a rule. Setzen Sie den User-Agent auf die Whitelist Omnisend/1.0 (groß- und kleinschreibung beachten) und fügen Sie die Omnisend-IP-Adressen (siehe FAQ oben) zu Ihrer Zulassungsliste hinzu. Nach dem Speichern das Omnisend-Plugin neu installieren.

Meine Webshop-URL hat sich gendert (von localhost oder Staging). Wie stelle ich die Verbindung wieder her?
Gehen Sie zu Omnisend → Store Settings → Contact information and update your store URL to the live domain. Warten Sie 10 Minuten, melden Sie sich dann ab und wieder an. Wenn das Problem weiterhin besteht, trennen und verbinden Sie das Plugin erneut von WordPress.

Warum ist mein 0WooCommerce Webshop langsam, nachdem ich mich mit Omnisend verbunden habe?
Wenn Sie eine Plugin-Version verwenden, die älter als 1.20.0 ist, kann das Plugin weiterhin einige Daten übertragen, während das Backend von Omnisend diese ebenfalls synchronisiert, was zu einer doppelten Synchronisationslast bei Kontakten, Bestellungen, Produkten und Produktkategorien führt. Update to version 1.20.0 or later to resolve this.Gehen Sie zu Plugins → Updates in WordPress.

Wenn Sie Fragen haben oder Unterstützung benötigen, kontaktieren Sie unser Support-Team unter [email protected] oder über den In-App-Chat.

Verwandte Artikel
Hat dies deine Frage beantwortet?