WordPress-Plugin

→ API-Keys-Connector in SimpliServ öffnen

Mit dem WordPress-Plugin SimpliServ Customer Registration Form bettest du ein anpassbares Anmeldeformular direkt auf deiner WordPress-Seite ein. Jede Einsendung legt in SimpliServ automatisch eine Serviceanmeldung an und startet den dazugehörigen Kundenvorgang (CustomerFlow) – ganz ohne dass Besucher ein Login brauchen.

So funktioniert esCopy Anchor Link

Das Plugin rendert über einen Shortcode ein HTML-Formular auf deiner WordPress-Seite. Beim Absenden ruft das Plugin serverseitig die SimpliServ-API auf (POST /api/v1/service-registrations) und authentifiziert sich dabei mit einem API-Key (Bearer-Token). Der Token wird nie im Browser sichtbar, sondern bleibt in den WordPress-Einstellungen.

Daraus entsteht in SimpliServ:

• eine Serviceanmeldung mit eigener Nummer,
• ein Kundenvorgang, der die Anmeldung verarbeitet,
• bei bekannter E-Mail-Adresse die Zuordnung zu einem bestehenden Kunden.

Schritt 1 – API-Key in SimpliServ erstellenCopy Anchor Link

Das Plugin braucht einen Token, mit dem es sich gegenüber SimpliServ ausweist.

Schritt 2 – Plugin in WordPress installierenCopy Anchor Link

Schritt 3 – Verbindung konfigurierenCopy Anchor Link

Im Abschnitt General Settings legst du fest, wohin und womit das Plugin sendet:

• API Key (Bearer Token) – der in Schritt 1 kopierte Token (id|token).
• API Base URL – Standard ist https://api.simpliserv.com. Das Plugin hängt automatisch /api/v1/service-registrations an; eine Basis-URL mit oder ohne /api/v1 wird korrekt aufgelöst.
• Success Message – Text, der nach erfolgreichem Absenden angezeigt wird.
• Redirect URL (optional) – statt der Erfolgsmeldung wird zu dieser Adresse weitergeleitet.
• Enable Honeypot – verstecktes Spam-Schutzfeld (empfohlen, standardmäßig an).
• Rate Limit per Minute – maximale Einsendungen pro IP und Minute (Standard 10, 0 deaktiviert das Limit).
• Enable Debug Logging – schreibt Anfragen und API-Antworten in ein internes Log.

Schritt 4 – Felder anpassenCopy Anchor Link

Im Abschnitt Field Configuration steuerst du je Feld, ob es angezeigt (Enabled) und Pflicht (Required) ist, und überschreibst Label, Platzhalter und Beschreibung.

Basisfelder:

• Vorname (first_name), Nachname (last_name), E-Mail (email), Telefon (phone)
• Marke (brand), Modell (model)
• Beschreibung (description) – wird als mehrzeiliges Textfeld gerendert

Adressgruppen (Liefer- und Rechnungsadresse) sind standardmäßig deaktiviert. Aktivierst du Felder darin, erscheinen sie als eigene Gruppe (Adresse, Stadt, PLZ, Region, Ländercode) und werden als shipping_address bzw. billing_address mitgesendet.

Im Abschnitt Brand Field Settings kannst du das Marken-Feld wahlweise als freies Textfeld oder als Auswahl-Dropdown rendern. Für das Dropdown trägst du unter Brand Options die Werte ein – einer pro Zeile oder kommagetrennt.

Schritt 5 – Formular einbettenCopy Anchor Link

Füge den folgenden Shortcode in eine WordPress-Seite oder einen Beitrag ein:

[simpliserv_customer_form]

Das Formular übernimmt automatisch alle aktivierten Felder, das Honeypot-Feld und die hinterlegte Erfolgsmeldung. CSS und JavaScript des Formulars werden nur auf Seiten geladen, die den Shortcode enthalten.

DiagnoseCopy Anchor Link

Im unteren Bereich der Plugin-Einstellungen helfen mehrere Werkzeuge bei der Fehlersuche:

• REST endpoint – die WordPress-Adresse, die das Formular intern aufruft (…/simpliserv/v1/submit).
• Last form hit – Zeitpunkt und IP der letzten Einsendung.
• Debug Logs – bei aktivem Logging werden Anfragen und API-Antworten hier angezeigt; mit Clear logs leerst du das Protokoll, mit Write test log entry prüfst du, ob das Logging schreibt.

Häufige Meldungen:

• „Missing API key" – im Plugin ist kein Token hinterlegt.
• Validierungsfehler – ein Pflichtfeld fehlt oder die E-Mail ist ungültig; die Fehler erscheinen direkt am betreffenden Feld.
• „Too many requests" – das Rate-Limit pro IP wurde erreicht.

Weiterverarbeitung in SimpliServCopy Anchor Link

Eingegangene Einsendungen erscheinen als Serviceanmeldungen und können wie alle anderen Anmeldungen weiterverarbeitet werden – etwa in einen Auftrag, Kostenvoranschlag oder ein Angebot umgewandelt werden. Details dazu im Guide Service-Registrierung.

Verwandte ThemenCopy Anchor Link

• API-Zugriff & externe Apps — API-Schlüssel ausstellen und verwalten, mit dem sich das Plugin authentifiziert
• Service-Registrierungsformular anpassen — Felder, Texte und Logik des Formulars in SimpliServ konfigurieren
• Connectoren verwalten — Übersicht über alle Integrationen und den Connectoren-Hub
• Customer Flow — den Kundenvorgang automatisieren, der aus jeder Einsendung entsteht
• Öffentliche Auftragsregistrierung — Alternative ohne Plugin: Kunden legen ohne Login direkt einen Auftrag an