Die WordPress-Integration mit CRM erfolgt über einen vorgefertigten Konnektor, einen Webhook oder eine REST-API – die Wahl hängt von der Art der Daten, den CRM-Funktionen und den Zuverlässigkeitsanforderungen ab.

Inhalt

Um Anfragen und Bestellungen verlustfrei zu übertragen, müssen Sie die Feldzusammensetzung, die Abgleichs- und Wiederholungsregeln im Voraus festlegen und anschließend die Szenarien «Kontaktformular → Lead» und «WooCommerce-Bestellung → Deal» testen. Dieser Leitfaden behandelt Integrationsoptionen, die Einrichtung des Datenaustauschs, den Zugriff auf Protokolle, die Sicherheit und das Testen unter Berücksichtigung Ihres Themes, Ihrer Plugins und Ihrer WordPress-Version.

Wie die Integration mit dem Theme, den Plugins und der REST-API zusammenhängt, wird in folgendem Abschnitt gezeigt: Überprüfung der individuellen WordPress-Entwicklung. Der Datenaustausch mit CRM wird hier erläutert.

Welche Daten müssen in das CRM-System übertragen werden?

Welche Daten aus WordPress sollten in das CRM übertragen werden?

Bevor Sie die Integration einrichten, ermitteln Sie, welche Felder ein Manager zur Bearbeitung einer Anfrage oder Bestellung benötigt. Übertragen Sie nicht automatisch alle Informationen aus WordPress: Erstellen Sie eine Datenzuordnung, die jedes Website-Feld einem bestimmten CRM-Feld zuordnet.

Formulare und Anträge

Für das Szenario «Kontaktformular → Lead» genügen in der Regel Name, Telefonnummer oder E-Mail-Adresse, der Anfragetext und die Quelle der Anfrage. Wenn Sie mehrere Formulare auf Ihrer Website haben, geben Sie jedem Formular eine Kennung oder einen beschreibenden Namen, z. B. «Beratung anfragen» oder «Angebot anfordern».

Es ist sinnvoll, folgende Daten zu übermitteln:

Name und Kontaktdaten des Besuchers;
Nachrichtentext, ausgewählter Dienst oder Betreff der Anfrage;
URL der Seite, von der das Formular abgeschickt wurde;
Datum und Uhrzeit des Versands mit Angabe der Zeitzone;
Seitensprache, falls die Website mehrsprachig ist;
UTM-Tags und andere vereinbarte Verkehrsquellen;
Interne Anwendungskennung für die Duplikatsuche.

Legen Sie im Voraus fest, welche Felder Pflichtfelder sind. Beispielsweise kann ein Formular eine Telefonnummer, aber keine E-Mail-Adresse erfordern. Bei ukrainischen Telefonnummern empfiehlt es sich, den normalisierten Wert mit der Ländervorwahl separat von der formatierten Anzeige zu speichern. Dies vereinfacht den Kontaktabgleich, die Normalisierungsregeln hängen jedoch von Ihrem CRM-System ab.

Falls der Standard-Connector keine benutzerdefinierten Formularfelder unterstützt, müssen Sie möglicherweise WordPress-Website-Entwicklung. Bevor Sie beginnen, erstellen Sie eine Zuordnungstabelle: «Formularfeld – CRM-Feld – Format – erforderlich». Dadurch entfällt für den Entwickler die Notwendigkeit, die Geschäftslogik anhand der Feldnamen zu ermitteln.

WooCommerce-Bestellungen

Im Szenario «WooCommerce-Bestellung → Kaufabwicklung» reicht eine einzelne Kundenkarte nicht aus. Das CRM-System muss Informationen erhalten, die es dem Manager ermöglichen, den Kaufinhalt, den Betrag und die Zahlungsmethode zu verstehen. Daher umfasst die WooCommerce-Integration mit dem CRM-System typischerweise Kunden-, Bestell- und Produktdaten.

Bestellnummer und interne Kennung;
Name, Telefonnummer und E-Mail-Adresse des Käufers;
Lieferadresse und Rechnungsadresse, falls abweichend;
Produkte, Varianten, Artikelnummer (SKU), Menge und Preis des Artikels;
Rabatte, Gutscheine, Versandkosten, Steuern und Gesamtbetrag;
Währung angeben, zum Beispiel UAH;
ausgewählte Zahlungs- und Liefermethoden;
Bestellstatus und Kommentar des Käufers;
Bestellquelle und gegebenenfalls registrierte Benutzer-ID.

Fassen Sie Produktpreis, Versandkosten und Rabatt nicht zu einem einzigen, nicht näher spezifizierten Betrag zusammen. Manager und Buchhaltungssysteme benötigen möglicherweise separate Beträge. Geben Sie bei variablen Produkten neben dem Produktnamen auch die ausgewählten Attribute wie Größe, Farbe oder Konfiguration an.

Definieren Sie außerdem einen Schlüssel zur Verbindung der Systeme. Typischerweise wird für Bestellungen eine unveränderliche interne WordPress- oder WooCommerce-Kennung verwendet, während die Anzeigenummer separat gespeichert wird. Für den Kunden kann der Schlüssel eine standardisierte Telefonnummer, E-Mail-Adresse oder seine eigene ID sein. Die Wahl hängt jedoch von den Duplikaterkennungsregeln des jeweiligen CRM-Systems ab. Diese Feldzuordnung ist die Grundlage; ohne sie besteht bei der WordPress-Integration mit dem CRM das Risiko unvollständiger Datensätze und doppelter Transaktionen.

Wählen Sie die Integrationsmethode aus

Auswahl zwischen Konnektor, Webhook oder API

Zur Übermittlung von Anfragen und Bestellungen können Sie einen vorgefertigten Konnektor, einen Webhook, eine REST-API oder einen Vermittlungsdienst nutzen. Wählen Sie die Lösung nicht nur nach Einrichtungsaufwand, sondern auch nach CRM-Kompatibilität, Wiederholungsmechanismus, Zugriff auf Protokolle und Gesamtbetriebskosten.

Fertiger Verbinder

Ein fertiges Plugin oder Modul eignet sich, wenn es das benötigte CRM-System und die Datenquelle unterstützt: ein Kontaktformular, WordPress oder WooCommerce. Dies ist in der Regel die einfachste Option für ein typisches Szenario «Formular → Lead» oder «Bestellung → Abschluss».

Prüfen Sie vor der Auswahl die Kompatibilität mit den aktuellen Versionen von WordPress, WooCommerce, Ihrem Theme und den Formular-Plugins. Das Vorhandensein eines Konnektors allein garantiert nicht die Übertragung von benutzerdefinierten Feldern, Produktvarianten, Versandarten, Rabatten und Bestellstatusänderungen.

Prüfen Sie, ob das Modul ein Kommunikationsprotokoll führt, CRM-Antworten anzeigt und nach einem temporären Fehler den Sendevorgang wiederholen kann. Werden Updates unregelmäßig veröffentlicht oder beschreibt die Dokumentation die Datenstruktur nicht, kann eine mangelhafte Implementierung bei der Markteinführung zu zusätzlichen Wartungskosten führen.

Webhook oder REST-API

Ein Webhook sendet Daten, sobald ein Ereignis eintritt, beispielsweise das Absenden eines Formulars oder das Erstellen einer Bestellung. Er eignet sich gut für schnelle, unidirektionale Datenübertragungen. Allerdings müssen Autorisierung, Fehlerbehandlung, Wiederholungsversuche und der Schutz vor Duplikaten berücksichtigt werden.

WordPress API-Integration Bietet mehr Kontrolle: Eine Website oder ein separates Modul kann Beiträge erstellen und aktualisieren, Status abfragen und Verzeichnisse synchronisieren. Die WordPress REST API ermöglicht externen Systemen außerdem den Zugriff auf Website-Daten über strukturierte HTTP-Anfragen, sofern die erforderlichen Entitäten und Zugriffsrechte vorhanden sind.

Für komplexe WooCommerce CRM-Integration Eine API ist in der Regel vorzuziehen, wenn ein bidirektionaler Datenaustausch erforderlich ist: die Übertragung einer Bestellung an ein CRM-System und die anschließende Rückmeldung des Bearbeitungsstatus an die Website. Dieser Ansatz erfordert Entwicklung, Überwachung und Support bei Änderungen an der API eines der Systeme.

Weg	Vorteile	Einschränkungen	Wenn es passt
Fertiger Verbinder	Schneller Start, schnittstellenbasierte Konfiguration, weniger benutzerdefinierter Code	Abhängigkeit von Plugin-Funktionen und -Updates	WooCommerce Standardformulare und Bestellungen
Webhook	Unmittelbare Übertragung nach dem Ereignis, relativ einfache Architektur	Wiederholungen, Protokolle und der Schutz vor Duplikaten bedürfen möglicherweise einer Verbesserung.	Einseitige Übermittlung eines Antrags oder einer Bestellung
REST-API	Flexible Feldkartierung und bidirektionaler Datenaustausch	Entwicklung, Dokumentation und Support sind erforderlich.	Nicht standardmäßige Logik- und Statussynchronisierung

Zwischendienst

Die Zwischenplattform empfängt Ereignisse von WordPress, transformiert die Daten und sendet sie an das CRM-System. Diese Option ist nützlich, wenn keine direkte Verbindung besteht oder wenn Sie mehrere Formulare, Shops und Systeme integrieren müssen, ohne jede Verbindung separat entwickeln zu müssen.

Berücksichtigen Sie Transaktionslimits, die Zugänglichkeit des Ausführungsverlaufs, die Wiederholungszeiten nach Fehlern und die Möglichkeit zum Exportieren von Protokollen. Beachten Sie neben der Servicegebühr auch den Zeitaufwand für die Konfiguration von Skripten, die Fehlerprüfung und die Unterstützung geänderter Felder. Ist der Anfragefluss geschäftskritisch, klären Sie, was passiert, wenn das CRM nicht verfügbar ist: Bleiben die zwischengespeicherten Daten erhalten und kann eine erneute Übertragung sicher eingeleitet werden?.

Datenaustauschregeln einrichten

Feldzuordnung, Datenvalidierung und Duplikatsbereinigung

Vor der Verbindung sollten Sie nicht nur die Liste der zu übertragenden Daten, sondern auch die Regeln für deren Transformation festlegen. Dokumentieren Sie, welches WordPress-Feld welchem CRM-Feld entspricht, wann ein neuer Datensatz erstellt wird und was bei einer erneuten Übermittlung geschieht. Dieses Vorgehen minimiert das Risiko von verloren gegangenen Anfragen, Duplikaten und falschen Statusmeldungen.

Felder und Status

Im Szenario «Kontaktformular → Lead» genügen in der Regel Name, Telefonnummer oder E-Mail-Adresse, Nachrichtentext, die Absendeseite und die Einwilligung des Nutzers. Es ist außerdem sinnvoll, die technische ID des Formulars und die UTM-Parameter zu übermitteln, sofern diese rechtmäßig erhoben wurden und von den Verantwortlichen tatsächlich benötigt werden.

Legen Sie Regeln für optionale Werte im Voraus fest. Wenn ein Besucher beispielsweise keinen Namen angibt, verwenden Sie keinen Platzhalternamen, sondern einen leeren Wert oder eine vom CRM zugelassene neutrale Bezeichnung. Formatieren Sie die Telefonnummer einheitlich, behalten Sie aber den Originalwert im Anrufprotokoll bei, falls dieser für Diagnosezwecke benötigt wird.

Im WooCommerce-Szenario «Bestellung → Deal» sollten Sie mindestens Folgendes abbilden:

Bestellnummer und interne ID;
Kontaktinformationen des Käufers;
Produkte, Mengen, Artikel und Varianten;
Kosten der Artikel, Rabatt, Lieferung und Gesamtbetrag;
Zahlungs- und Liefermethode;
Kundenkommentar;
Währung und Bestellstatus.

Gehen Sie nicht davon aus, dass Statusbezeichnungen identisch sind. Beispielsweise kann der WooCommerce-Status «In Bearbeitung» einer bestimmten Transaktionsphase im CRM entsprechen, dies hängt jedoch vom jeweiligen Geschäftsprozess ab. Erstellen Sie eine eindeutige Zuordnung und definieren Sie die Richtung des Datenaustauschs: nur von der Website zum CRM oder bidirektional. Bei bidirektionaler Synchronisierung legen Sie fest, welches System als maßgebliche Datenquelle für Zahlung, Versand und Stornierung gilt.

Wenn Sie die WordPress-API-Integration verwenden, überprüfen Sie die Datentypen vor dem Senden: Übergeben Sie den Betrag als Zahl im erwarteten Format, das Datum mit der angegebenen Zeitzone und Kennungen ohne willkürliche Konvertierung.

Duplikate und Wiedereinreichungen

Ein Netzwerkausfall bedeutet nicht zwangsläufig, dass das CRM den Datensatz nicht erhalten hat: Die Antwort könnte nach der Erstellung des Leads oder Deals verloren gegangen sein. Daher kann eine einfache Wiederholung der Anfrage zu einem Duplikat führen.

Übergeben Sie eine stabile externe Kennung: Bei einer Anfrage könnte dies die UUID sein, die beim ersten Speichern des Formulars generiert wurde, oder bei WooCommerce die Bestellnummer zusammen mit der Website-ID. Das CRM-System oder die Middleware sollte den Datensatz anhand dieses Schlüssels finden und aktualisieren, anstatt ihn neu zu erstellen. Dieses Verfahren wird als Idempotenz bezeichnet: Derselbe Vorgang erzeugt bei Wiederholung keine neuen Datensätze.

Die Wiederholungsregeln im Voraus festlegen:

Bei vorübergehender Nichtverfügbarkeit oder Serverfehlern wird der Sendevorgang wiederholt;
Verlängern Sie das Intervall zwischen den Versuchen und begrenzen Sie deren Anzahl;
Wiederholen Sie die Anfrage nicht ohne Korrektur, wenn ein Validierungsfehler vorliegt oder Sie keine Berechtigung haben;
Zeit, Vorgangs-ID, Antwortcode und Fehlergrund speichern;
Nachdem alle Versuche ausgeschöpft sind, verschieben Sie den Eintrag in die Warteschlange für die manuelle Überprüfung.

Die WooCommerce-Integration mit dem CRM sollte zwischen Auftragserstellung und nachfolgenden Änderungen unterscheiden. Senden Sie nicht die gesamte Transaktion als neue an, wenn sich der Status ändert: Verwenden Sie stattdessen eine externe ID und einen separaten Aktualisierungsvorgang. Verlassen Sie sich bei Kontaktformularen nicht ausschließlich auf Telefonnummer oder E-Mail-Adresse – diese Angaben können bei mehreren Anfragen identisch sein. Trennen Sie die Entscheidung zum Zusammenführen von Kontakten von der Einzigartigkeit jeder Anfrage.

Sicherheits- und Zustimmungsprüfung

Nutzereinwilligung und Datenschutz bei der Übertragung in das CRM

Bevor Sie die Integration starten, beschränken Sie den Zugriff auf Ihr CRM und WordPress, schützen Sie vertrauliche Informationen und legen Sie die Rechtsgrundlage für die Verarbeitung personenbezogener Daten fest. Übertragen Sie Felder nicht «vorsorglich» in Ihr CRM: Die Daten müssen für den vorgesehenen Zweck relevant sein – beispielsweise für die Bearbeitung einer Bewerbung, die Abwicklung einer Bestellung oder die Kundenbetreuung.

Zugriffsrechte und Geheimnisse

Erstellen Sie ein separates CRM-Konto für die Integration mit den minimal erforderlichen Berechtigungen. Wenn ein Skript beispielsweise nur Leads erstellen soll, benötigt es keinen Zugriff auf den Export der gesamten Kundendatenbank, Finanzberichte oder die Löschung von Deals. Dadurch wird das Risiko eines Schlüssellecks minimiert.

REST-API-Tokens, Passwörter und Geheimnisse für die Webhook-Verifizierung dürfen nicht in JavaScript, HTML-Formularen oder einem öffentlichen Repository gespeichert werden. Sie müssen auf dem Server in einem sicheren Konfigurations- oder Geheimnisverwaltungstool abgelegt werden. Der Zugriff auf Konfigurationsdateien sollte eingeschränkt und Geheimnisse nicht in Fehlerprotokollen protokolliert werden.

Verwenden Sie HTTPS für WordPress, CRM und Vermittlungsdienste;
Prüfen Sie die Webhook-Signatur, um festzustellen, ob Absender und CRM diesen Mechanismus unterstützen.;
Legen Sie nur die minimalen Kontorechte fest und ändern Sie die Schlüssel regelmäßig;
Beschränken Sie den Zugriff auf Protokolldateien, da diese Telefonnummern, E-Mails und Anwendungsinhalte enthalten können;
Persönliche Daten maskieren und Tokens aus Protokollen ausschließen;
Aktualisieren Sie WordPress, Theme und Plugins, nachdem Sie die Kompatibilität geprüft haben.

Auf eigene Faust WordPress-API-Integration Prüfen Sie Typ, Länge und Format der Eingabewerte und verwenden Sie Escape-Sequenzen, bevor Sie diese im Admin-Bereich ausgeben. Überprüfen Sie außerdem die Benutzerberechtigungen und Sicherheitsanforderungen gemäß den WordPress-Mechanismen. Implementieren Sie Codeänderungen zunächst in einer Testumgebung, nachdem Sie ein Backup erstellt haben. Die Kompatibilität kann ohne Prüfung der WordPress-Version, des Themes, der Formular-Plugins und von WooCommerce nicht gewährleistet werden.

personenbezogene Daten

Ermitteln Sie, welche Daten Ihr CRM-System tatsächlich benötigt. Für einen Rückruf genügen in der Regel Name, Telefonnummer und der Kontext der Anfrage. Bei einer Bestellung werden möglicherweise Empfängerkontaktdaten, Bestelldetails, Lieferadresse und Zahlungs-IDs benötigt, jedoch keine vollständigen Bankkartendaten.

Fügen Sie neben dem Formular einen deutlichen Hinweis hinzu: Wer erhält die Daten, zu welchem Zweck, wie lange werden sie gespeichert und an wen können sie weitergegeben werden? Ein Link zur Datenschutzerklärung sollte vor dem Absenden des Formulars verfügbar sein. Vermeiden Sie vorausgewählte Kontrollkästchen, wenn die Verarbeitung ausdrücklich auf einer Einwilligung beruht.

Die Einwilligung ist jedoch nicht die einzige mögliche Rechtsgrundlage. So können Bestelldaten beispielsweise zur Vertragserfüllung verarbeitet werden, während für eine separate Marketingkampagne in der Regel eine eigenständige Prüfung der Rechtsgrundlage und eine gesonderte Einwilligung des Nutzers erforderlich sind. Beachten Sie die ukrainischen Datenschutzgesetze. Auch die Anforderungen der DSGVO können relevant sein, insbesondere wenn Sie Waren oder Dienstleistungen für Personen in der EU anbieten oder deren Verhalten verfolgen. Es empfiehlt sich, die konkrete Anwendbarkeit mit einem Anwalt zu klären.

Aufbewahrungsfristen, Löschverfahren und Verfahren zur Datenkorrektur. Falls Daten über einen externen Konnektor übertragen werden, ermitteln Sie den Standort der Server, ob Anfrageinhalte gespeichert werden und wie Backups gelöscht werden. Bei der WooCommerce-Integration mit einem CRM-System prüfen Sie separat, ob personenbezogene Daten ohne WordPress, CRM, Protokolle oder einen Zwischendienst dupliziert werden.

Testen und Support

Testen Sie die Integration vor dem Launch auf einer Testumgebung und erstellen Sie ein Backup. Ihr Ziel ist es, nicht nur die erfolgreiche Übermittlung von Anträgen oder Bestellungen zu bestätigen, sondern auch die korrekte Behandlung von Fehlern, Wiederholungsversuchen und Statusänderungen. Die Kompatibilität kann ohne Überprüfung der WordPress-Version, des Themes, der Formular-Plugins, von WooCommerce und der CRM-Einstellungen nicht gewährleistet werden.

Fehlerszenarien

Führen Sie Tests für zwei Hauptsequenzen durch: «Kontaktformular → Lead» und «WooCommerce-Bestellung → Deal». Verwenden Sie separate Testkontakte, damit Sie diese finden und entfernen können, ohne Ihre Live-Daten zu beeinträchtigen.

Checkliste für die Testanmeldung:

Füllen Sie alle Pflichtfelder mit korrekten Daten aus und stellen Sie sicher, dass der Lead im richtigen Vertriebstrichter erscheint.
Prüfen Sie, ob Name, Telefonnummer, E-Mail-Adresse, Quelle, Kommentar und UTM-Tags übereinstimmen.
Bitte geben Sie Ihre ukrainische Telefonnummer in einem der verschiedenen akzeptierten Formate ein, einschließlich der Vorwahl +380.
Senden Sie das Formular ohne das erforderliche Feld ab und vergewissern Sie sich, dass kein falscher Datensatz im CRM erfasst wurde.
Bitte senden Sie die gleichen Daten erneut ein und überprüfen Sie die Regel zur Behandlung von Duplikaten.
Geben Sie vorübergehend ein ungültiges Token an oder testen Sie eine nicht verfügbare API-Adresse und prüfen Sie anschließend, ob der Fehler behoben ist.
Stellen Sie die Verbindung wieder her und prüfen Sie, ob die automatische erneute Sendung erfolgt.

Erstellen Sie für WooCommerce zusätzlich eine Testbestellung mit mehreren Produkten, Rabatten, Versandoptionen und verschiedenen Zahlungsmethoden. Überprüfen Sie Artikelnummer, Menge, Preis, Währung, Gesamtbetrag, Kundendaten und Status. Wird die Bestellung geändert oder storniert, sollte das CRM-System den Vorgang gemäß einer vordefinierten Regel verarbeiten, anstatt eine neue Transaktion zu erstellen.

Achten Sie besonders auf Timeouts und wiederholte Webhook-Anfragen. Ohne Anfrage- oder Bestell-ID kann eine wiederholte Anfrage ein Duplikat erzeugen. Zum Schutz wird häufig Idempotenz eingesetzt: Das CRM-System oder der zwischengeschaltete Handler speichert die externe ID und aktualisiert den bestehenden Datensatz, anstatt einen neuen anzulegen.

Synchronisierungsüberwachung

Nach dem Start von WordPress erfordert die CRM-Integration eine regelmäßige Überwachung. Eine einzelne Erfolgsmeldung in der Formularoberfläche reicht nicht aus: Sie zeigt möglicherweise nur an, dass die Daten auf der Website gespeichert wurden, nicht aber, dass sie vom CRM empfangen wurden.

Erstellen Sie ein Protokoll, das Datum und Uhrzeit des Ereignisses, Objekttyp, externe ID, Zieladresse, Antwortcode, Anzahl der Versuche und eine kurze Fehlerbeschreibung enthält. Speichern Sie keine Token, Passwörter, vollständigen Zahlungs- oder persönlichen Daten in öffentlichen Protokollen.

Für Webhooks und REST-APIs sollten Sie eine begrenzte Anzahl von Wiederholungsversuchen mit zunehmenden Intervallen konfigurieren. Sobald alle Wiederholungsversuche ausgeschöpft sind, sollte das Ereignis zur manuellen Überprüfung in die Warteschlange gestellt und der zuständige Mitarbeiter benachrichtigt werden. Bei der WordPress-API-Integration ist es außerdem sinnvoll, den Tokenablauf, die Begrenzung der Anfragerate und Änderungen des Antwortformats zu überwachen.

Vergleichen Sie regelmäßig die Anzahl der eingereichten Formulare und Bestellungen mit der Anzahl der im CRM angelegten Objekte. Bei der WooCommerce-Integration mit dem CRM sollten Sie Abweichungen bei Beträgen und Status separat überwachen. Führen Sie nach Aktualisierungen von WordPress, WooCommerce, Formularen, Konnektoren oder PHP einen reduzierten Testsatz in der Testumgebung durch. Speichern Sie Beschreibungen von Feldern, Duplikatregeln und Wiederherstellungsverfahren: Dies verkürzt die Diagnosezeit bei Synchronisierungsfehlern.

Offizielle Dokumentation: WordPress REST-API Und Genehmigung anfordern.