WooCommerce-Integration

Die WooCommerce-Integration holt Bestellverlauf, gekaufte Produkte und Kundendaten in die Konversation, damit Agenten und der KI-Bot Fragen zu Bestellungen im Kontext beantworten können. Für die Einrichtung brauchst du einen API-Schlüssel, den du im Admin-Bereich deines Shops erstellst. Dein Team hat den vollen Kontext, ohne den Tab zu wechseln, und dein KI-Bot kann beim Antworten auf Bestellinformationen zurückgreifen. Diese Anleitung zeigt dir die Einrichtung, was dich nach dem Verbinden erwartet und wie du häufige Probleme löst.

API-Schlüssel in WooCommerce erstellen

1. Öffne in deinem WordPress-Admin WooCommerce > Einstellungen > Erweitert > REST-API.
2. Klicke auf Schlüssel hinzufügen.
3. Gib eine Beschreibung ein (z. B. Deskwoot Integration), wähle einen Benutzer mit Admin-Rechten und setze die Berechtigungen auf Lesen/Schreiben, wenn dein Team Bestellungen aus Deskwoot erstatten und stornieren soll. Wähle Lesen, wenn du Bestellungen nur ansehen willst.
4. Klicke auf API-Schlüssel erstellen.
5. Kopiere sofort den Consumer Key und das Consumer Secret. Beide werden nur einmal angezeigt.

Tipp: Speichere die Schlüssel an einem sicheren Ort, bevor du die Seite schließt. Wenn du sie verlierst, musst du ein neues Paar erstellen.

In Deskwoot verbinden

1. Öffne in Deskwoot Einstellungen > Integrationen > WooCommerce.
2. Gib die Shop-URL (z. B. https://yourstore.com), den Consumer Key und das Consumer Secret ein.
3. Klicke auf Verbinden.

Deskwoot prüft die Verbindung mit einer Testanfrage an deinen Shop. Danach erscheinen Bestell- und Kundendaten in deinem Workspace.

Bestellverlauf in Konversationen

Nach dem Verbinden zeigt der Bereich Bestellungen im Tab Details einer Konversation die 10 neuesten Bestellungen des Kunden mit Bestellnummer, Status, Gesamtbetrag und Datum. Klicke auf eine Bestellung, um Positionen, Lieferadresse und Sendungsverfolgung zu sehen (für die Sendungsverfolgung brauchst du das kostenlose Plugin WooCommerce Shipment Tracking). Bestellungen werden über die E-Mail-Adresse des Kunden zugeordnet. Mit einem Schlüssel mit Lesen/Schreiben bietet der Bereich außerdem Erstatten, Bestellung stornieren und Als versendet markieren.

Abgleich der Kundendaten

Deskwoot übernimmt deine WooCommerce-Kunden beim Verbinden und danach einmal täglich als Kontakte, mit Name, E-Mail-Adresse, Telefonnummer, Firma, Stadt und Land sowie dem Gesamtumsatz. So sind die Kontaktprofile vollständiger und Agenten können persönlicher helfen.

Kontext für den KI-Bot

Wenn der KI-Bot aktiv ist, bekommt er den Bestellkontext des aktuellen Kunden. So kann er Fragen wie "Wo ist meine Bestellung?" oder "Was habe ich letztes Mal bestellt?" ohne Hilfe eines Agenten beantworten.

Fragt ein Besucher, der nicht verifiziert ist, wo seine Bestellung bleibt, fragt Fynn nach der Bestellnummer und der Postleitzahl der Lieferadresse (oder der Rechnungsadresse, wenn die Bestellung keine Lieferadresse hat). Das klappt für jede Bestellung in deinem Shop, auch für eine von vor dem Verbinden: Eine Bestellung, die Deskwoot noch nicht gespeichert hat, sucht Fynn direkt in WooCommerce. Passen Nummer und Postleitzahl nicht zusammen, bittet Fynn den Kunden, beides zu prüfen, und bietet danach an, ihn stattdessen per E-Mail zu bestätigen. Dafür muss in den Bot-Einstellungen (Einstellungen > Bots) unter Datenzugriff die Option Bestellungen & Transaktionen (via Shopify/Stripe/WooCommerce) eingeschaltet sein.

Fehlerbehebung

• Die Verbindung schlägt bei der Prüfung fehl: Prüfe, ob deine Shop-URL mit https:// beginnt und keinen Schrägstrich am Ende hat. Stell sicher, dass die REST-API erreichbar ist und nicht von einem Sicherheits-Plugin oder einer Firewall-Regel blockiert wird.
• Es erscheinen keine Bestellungen: Prüfe, ob die E-Mail-Adresse des Kunden in der Konversation mit der E-Mail-Adresse seines WooCommerce-Kontos übereinstimmt. Bestellungen werden über die E-Mail-Adresse zugeordnet, bei Abweichungen fehlen also Daten.
• Berechtigungsfehler: Prüfe, ob der API-Schlüssel mit einem Benutzer mit Admin-Rechten erstellt wurde. Erstattungen und Stornierungen aus Deskwoot brauchen die Berechtigung Lesen/Schreiben.

Empfehlungen

• Nutze für den API-Schlüssel ein eigenes WordPress-Benutzerkonto. Dann kannst du den Zugriff entziehen, ohne andere Integrationen zu stören.
• Wähle Lesen, wenn du Bestellungen in Deskwoot nur ansehen willst. Wähle Lesen/Schreiben nur, wenn dein Team Bestellungen aus Deskwoot erstatten, stornieren oder als versendet markieren soll.
• Prüfe deine WooCommerce-REST-API-Schlüssel regelmäßig und entferne alle, die du nicht mehr brauchst.

Häufige Fragen