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 zum Abschnitt Firewall & Sicherheits-Plugin-Fehlerbehebungen, um Omnisend-IPs und Benutzeragenten zu whitelisten.

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 Abschnitt Firewall & Sicherheits-Plugin-Fehlerbehebungen.

  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 Sie sehen:

  • 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.

Plugin-Update-Banner verschwindet nicht

Was Sie sehen: Sie haben das Omnisend-Plugin aktualisiert, aber ein Banner sagt immer noch "Aktualisierung 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 Zustimmen im WooCommerce Einwilligungsfenster.

  4. Warten Sie 5–10 Minuten, bis 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 "Kann nicht verbinden" Abschnitt.

Firewall- und Sicherheitsplugin-Behebungen

Wenn Sie Wordfence, Cloudflare, Really Simple Security oder ein anderes Firewall-Plugin verwenden, müssen Sie die Omnisend-IP-Adressen und Benutzeragenten auf die Whitelist setzen.

Omnisend-IP-Adressen zur Whitelist:

Fügen Sie diese IPs zu Ihrer 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-IP-Adressen 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ügen Sie 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: Omnisend erlauben (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. Klicken Sie auf Bereitstellen

Um Omnisend-IPs zu whitelisten:

  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 neu und stellen 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-Whitelist

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

  6. Speichern und versuchen Sie erneut, eine Verbindung herzustellen

Plugin-Konflikte & dauerhafte 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 wieder aktivieren, nur 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.

Behebung:

  1. Gehen Sie zu WordPress Admin → LiteSpeed Cache → Ausnehmen

  2. Fügen Sie unter URI ausschließen hinzu: /wp-json/omnisend*

  3. Einstellungen speichern und erneut versuchen, eine Verbindung herzustellen

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.

Behebung:

  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 Der Webshop (Staging/Testumgebungen)

Wenn Sie Ihren WooCommerce Der 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 für eine klare Unterscheidung zwischen Ihrer Produktions- und Staging-Umgebung, indem es die Staging-Umgebung automatisch vom Senden von Daten an Ihren Live-Webshop trennt. Es erfordert auch, dass die Staging-Umgebung mit einer Testmarke verbunden ist.

Schritte zur Einrichtung 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 gewünschte Umgebung für Tests oder andere Zwecke.

Schritt 2: Aktionen in Ihrem Staging-Webshop. Verbinden Sie das Staging-Plugin mit einer separaten Testmarke in Omnisend (nicht Ihrer 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 Daten zurück an die Produktionsumgebung gesendet werden.

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 deine geklonte Staging-Umgebung die WP_ENVIRONMENT_TYPE WordPress-Variable auf "staging" oder "development" gesetzt haben.

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

define('WP_ENVIRONMENT_TYPE', 'staging');

So überprüfst du deine Staging-Einrichtung

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 Der Webshop klonen und eine Test- oder Staging-Umgebung erstellen, folgen Sie bitte diesen Anleitungen:

Markenname anzeigen: Das Omnisend-Plugin zeigt den Markennamen an, um Ihnen 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.

Behebung:

  1. Gehe zu WordPress Admin → Einstellungen → Permalinks.

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

  3. Erneut verbinden.

SSL-Zertifikatsprobleme

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

Behebung:

  1. Überprüfe dein SSL-Zertifikat unter 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.

Behebung:

  1. Füge diese Zeile zu deiner .htaccess-Datei (im WordPress-Stammverzeichnis) hinzu:

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

  2. Wenn das Problem weiterhin besteht, kontaktieren Sie Ihren Hosting-Anbieter und bitten Sie ihn, die Übergabe des Authorization-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 wir Nachrichten an Ihre Zielgruppe senden. Wenn die Daten Ihres Shops nicht synchronisiert werden, kann 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 deinem 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 Omnisend-Plugin-Version.

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

Überprüfe, ob deine Behebung funktioniert hat

Nach der Anwendung einer Behebung, bestätige, 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 bestätigen Sie, dass die Webshop-Kontakte angezeigt werden.

  • Test-Endpunkt: Öffne deinedomain.com/wp-json/omnisend-api/v1/connected in deinem Browser. Es sollte 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 URL Ihres Webshops 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) hinzu, deaktiviere vorübergehend Caching/Sicherheits-Plugins und versuche es erneut.

Ich habe das Plugin aktualisiert, aber das Banner sagt immer noch "Aktualisierung erforderlich." Was nun?
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 an, aber Omnisend sagt "Konnte 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 setze ich Omnisend auf die Whitelist?
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, installieren Sie das Omnisend-Plugin erneut.

Meine Webshop-URL hat sich geändert (von localhost oder Staging). Wie kann ich mich wieder verbinden?
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 Sie das Plugin und verbinden Sie es erneut von WordPress.

Warum ist mein WooCommerce Der Webshop langsam, nachdem ich mich mit Omnisend verbunden habe?
Wenn du eine alte Version des WooCommerce-Plugins verwendest, synchronisieren sowohl das Plugin als auch die API gleichzeitig Kontakte, was eine doppelte Synchronisationslast erzeugt. Das kann Ihren Webshop verlangsamen. Update to the latest plugin version 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
Omnisend API-Übersicht und Entwicklerressourcen
Verbinden Sie Ihren Webshop mit Omnisend
Verbinden Sie Ihren WooCommerce (WordPress) Webshop mit Omnisend
WordPress-Plugin mit Omnisend verbinden
WooCommerce: Rabattartikel hinzufügen und konfigurieren
Hat dies deine Frage beantwortet?