← Alle Integrationen
WordPress plugin 1.0.0

WooCommerce, offen dokumentiert.

Das Widget-Plugin und die signierte Bestellanbindung sind zwei separate Integrationen. Das Plugin installiert den Chat. Die Bestellanbindung liest verifizierte Bestellungen über die WooCommerce REST API aus.

Development installation

ZIP-Datei und reproduzierbares Verifizierungsskript sind im Release-Kandidaten enthalten.

Plattformprüfung

Bei WordPress eingereicht und zur Freigabe ausstehend.

Öffentlicher Eintrag

Nicht im WordPress-Verzeichnis veröffentlicht. Die signierte ZIP-Datei ist ein separater Vertriebsweg.

01 / Von null zum Widget

Installation

Laden Sie saazly-chat.zip über den von Saazly angegebenen Vertriebsweg herunter.

Öffnen Sie Plugins im WordPress-Admin, wählen Sie Neues Plugin hinzufügen und anschließend Plugin hochladen.

Installieren Sie die ZIP-Datei und aktivieren Sie Saazly Chat.

Öffnen Sie Einstellungen und Saazly Chat. Fügen Sie die Widget-ID aus Saazly ein und speichern Sie.

Öffnen Sie die öffentliche Seite des Shops und prüfen Sie, ob die Chat-Schaltfläche angezeigt wird.

Für das Auslesen von Bestellungen erstellt ein WooCommerce-Administrator einen REST-API-Schlüssel mit Leseberechtigung und verbindet den Shop in Saazly unter Einstellungen und Bestellanbindungen.

02 / Minimaler Zugriff

Berechtigungen und Scopes

WordPress-Berechtigung

Nur Benutzer mit manage_options können die Widget-ID ändern.

Widget-Plugin

Das Plugin benötigt keine besondere WooCommerce-Berechtigung und verwendet keine REST-API-Schlüssel.

Bestellanbindung

Die separate Serveranbindung verwendet einen WooCommerce REST-API-Schlüssel mit Leseberechtigung. Saazly schreibt keine Bestell-, Zahlungs-, Fulfillment- oder Kundendaten.

Kundenabgleich

Eine E-Mail-Adresse oder Bestellnummer allein führt niemals zu einem verifizierten Treffer. Die Bestellnummer muss mit einem Namen oder einer E-Mail-Adresse kombiniert werden, die mit der Bestellung beim Provider übereinstimmt.

03 / Datenvertrag

Gelesene und geschriebene Daten

Lokal gelesen

Die gespeicherte öffentliche Widget-ID. Die Einstellungsseite kann den öffentlichen Namen des Widgets von Saazly abrufen.

Lokal geschrieben

Ein einzelner WordPress-Optionswert mit der öffentlichen Widget-ID.

Vom Browser gemeldeter Warenkorb

Das Widget kann Produkte, Menge, Preis und Währung aus dem aktuellen Warenkorb des Besuchers lesen. Dabei handelt es sich um Verhaltenskontext, nicht um verifizierte Bestelldaten.

Vom Provider verifizierte Bestellung

Bestell-ID, kundenfreundliche Bestellnummer, Betrag, Währung, Zahlungsstatus, Fulfillment-Status, Lieferungen, Provider-Zeitangaben, Datenquelle und Aktualität werden vom Serveradapter gelesen.

04 / Ereignisse

Webhooks

Das Plugin verwendet keine Webhooks

Version 1.0.0 des Widget-Plugins registriert und empfängt keine Webhooks.

Signierte Bestell-Webhooks

Die Serveranbindung registriert order.created und order.updated. Jede Zustellung wird mit HMAC SHA 256 verifiziert, anhand der Delivery-ID dedupliziert und mit der modified-Zeit des Providers abgeglichen.

Reconciliation

Ein signierter Serverlauf liest geänderte Bestellungen aus WooCommerce und stellt verpasste Webhooks wieder her, ohne dass ältere Ereignisse neuere Daten überschreiben.

Widget-Datenverkehr

Das geladene Widget verwendet die öffentliche Widget-Konfiguration und den Chatdienst von Saazly gemäß der Datenschutzrichtlinie von Saazly.

05 / Geheimnisse

Token-Speicherung

Das Plugin speichert keine Tokens

Das Widget-Plugin speichert keine Access-Tokens, Refresh-Tokens, API-Schlüssel oder Passwörter.

Verschlüsselte Server-Zugangsdaten

Consumer Key, Consumer Secret und Webhook Secret werden mit AES 256 GCM verschlüsselt, bevor sie in die Datenbank geschrieben werden. Authentifizierte Clients haben keinen Tabellenzugriff auf die Werte.

Widget-ID

Die Widget-ID ist eine öffentliche Kennung und wird als WordPress-Optionswert gespeichert.

06 / Saubere Entfernung

Deinstallation

Deaktivieren Sie Saazly Chat unter Plugins.

Löschen Sie das Plugin, wenn Sie es vollständig entfernen möchten.

Beim Löschen entfernt uninstall.php den Optionsschlüssel saazly_chat_widget_id aus einer regulären Installation, aus jeder Website in WordPress-Multisite und aus den Site Options des Netzwerks.

Die Bereinigung von Browserdaten richtet sich nach dem regulären Datenlöschverfahren von Saazly und wird durch das Entfernen der WordPress-Dateien nicht beeinflusst.

Die Bestellanbindung wird separat in Saazly getrennt. Verschlüsselte Credentials werden gelöscht, der lokale Zugriff wird gesperrt und registrierte Bestell-Webhooks werden in WooCommerce entfernt, sobald der Shop antwortet.

07 / Wenn etwas nicht weitergeht

Fehlerbehebung

Die Widget-ID wird nicht akzeptiert

Kopieren Sie den vollständigen UUID-Wert aus Saazly. Leerzeichen werden entfernt, ein unvollständiger Wert wird jedoch nicht gespeichert.

Das Widget wird nicht angezeigt

Prüfen Sie, ob das Plugin aktiv und die Widget-ID gespeichert ist und ob die Content Security Policy der Seite cdn.saazly.com zulässt.

Die Verifizierung erreicht Saazly nicht

Die Widget-ID wird auch dann gespeichert, wenn die Namensprüfung vorübergehend fehlschlägt. Prüfen Sie ausgehende HTTPS-Verbindungen vom WordPress-Server.

Die Bestellanbindung wird abgelehnt

Prüfen Sie, ob der Schlüssel Leseberechtigung besitzt, die HTTPS-Adresse exakt ist und der Systemstatus dieselbe Website-Adresse anzeigt.

Die Bestellung ist nicht aktuell

Prüfen Sie den Integrationsstatus in Saazly. Webhook-Replay ist unbedenklich und die Reconciliation ruft Bestellungen ab, die seit dem letzten Cursor geändert wurden.

Kommen Sie noch immer nicht weiter?

Senden Sie uns die Domain des Shops, den Zeitpunkt und die Fehlermeldung. Senden Sie niemals Token oder Passwörter.

Support kontaktieren
WooCommerce-Integration | Saazly-Dokumentation