Shop verbinden
- Dein Shop braucht eine HTTPS-Adresse. Öffne in WordPress Einstellungen → Permalinks und wähle eine beliebige Option außer Einfach (Plain).
- Öffne in WooCommerce Einstellungen → Erweitert → REST-API → Schlüssel hinzufügen. Wähle einen Benutzer mit der Rolle Shop-Manager und die Berechtigung Lesen für Fragen oder Lesen/Schreiben für Anfrage-Notizen und Telefonbestellungen.
- Kopiere den Consumer Key (beginnt mit
ck_) und das Consumer Secret (beginnt mitcs_). WooCommerce zeigt das Secret nur einmal an. - Öffne Agent Tools → Marketplace → WooCommerce. Gib die Shop-Adresse, den Consumer Key und das Consumer Secret ein.
- Wähle Hinzufügen. Die Verbindung wird geprüft, bevor sie gespeichert wird: Der Schlüssel muss Produkte und Bestellungen lesen können. Weise die Verbindung danach deinem Assistenten zu.
Das kann der Assistent
Standardmäßig aktiv:- Produkte nach Name oder Kategorie suchen, mit Preis, Lagerstand und Varianten. Es erscheinen nur veröffentlichte Produkte, die im Katalog sichtbar sind. Der Assistent rät nie einen Preis.
- Status, Inhalt und Summe einer Bestellung nennen und die letzten Bestellungen eines Anrufers finden.
- Einen Stornierungswunsch für dein Team hinterlassen.
- Einen Rückgabe- oder Umtauschwunsch für dein Team hinterlassen.
- Telefonbestellungen.
Datenschutz bei Bestellungen
Die Bestellnummer allein reicht nie. Der Assistent zeigt eine Bestellung, wenn eines davon zutrifft:- Die Nummer des Anrufers passt zur Telefonnummer der Bestellung, und kein anderer Kunde (andere E-Mail-Adresse) nutzt diese Nummer.
- Der Anrufer nennt die E-Mail-Adresse der Bestellung oder die Postleitzahl der Lieferadresse.
Storno-, Rückgabe- und Umtauschwünsche
Ein Wunsch ist eine private Bestellnotiz für dein Team (für den Kunden nie sichtbar). Sie enthält eine Überschrift, den Grund, welche Prüfung bestanden wurde, eine Rückrufnummer und eine kurze Referenz. Beispiel:- Stornierungswünsche sind möglich, solange die Bestellung auf Zahlung wartet, angehalten ist oder vorbereitet wird.
- Rückgabe- und Umtauschwünsche sind für abgeschlossene Bestellungen möglich. Die Notiz nennt die Produkte und den Grund.
Telefonbestellungen
Telefonbestellungen sind standardmäßig aus. Schalte sie unter Bearbeiten ein. Der Assistent erfasst bis zu fünf verschiedene einfache Produkte, die auf Lager sind, dazu Name, E-Mail-Adresse und Lieferadresse. Er liest alles zurück und legt die Bestellung erst an, wenn der Anrufer Ja sagt. Produkte mit Varianten werden nicht unterstützt.- Die Bestellung startet unbezahlt (Zahlung ausstehend). Vor der Zahlung wird nichts reserviert.
- WooCommerce schickt dem Kunden den Zahlungslink als Kundennotiz per E-Mail, im Design deines Shops. Der Assistent liest den Link nie vor und nimmt keine Karten- oder Bankdaten entgegen.
- Der Assistent nennt die Produktpreise so, wie sie in deinem Shop stehen, ohne Versand. Die Zahlungsseite zeigt den endgültigen Betrag.
- Dieselbe Bestellung für dieselbe E-Mail-Adresse am selben Tag wird nur einmal angelegt.
Einstellungen
Drei Einstellungen gehören zur Verbindung:- Produkte pro Antwort: 3, 5 oder 10 Produkte (Standard 3).
- Nicht vorrätige Produkte nennen: ob ausverkaufte Produkte in Antworten vorkommen (Standard Ja).
- Telefonbestellungen über diesem Wert übergeben: der Bestellwert in der Währung deines Shops, ab dem der Assistent anbietet, den Anrufer an dein Team weiterzuleiten. 0 bedeutet kein Limit.
Anrufer erkennen
Liefert der Kanal die Nummer des Anrufers, bekommt der Assistent vor dem Gespräch eine kurze Zusammenfassung: den Vornamen, die letzte Bestellnummer mit Status und Datum und die Zahl der offenen Bestellungen. Das passiert nur, wenn genau ein Kunde die Nummer nutzt. E-Mail-Adresse, Telefonnummer, Adresse und Summe erhält der Assistent dabei nicht. Dein Shop hat für diese Abfrage etwa 2,5 Sekunden. Ein langsamer Shop überspringt sie, und der Assistent fragt stattdessen nach der Bestellnummer.Sicher testen
Wünsche schreiben echte Notizen an echten Bestellungen, und Telefonbestellungen legen echte unbezahlte Bestellungen an und senden eine echte E-Mail. Teste mit einem Testprodukt, deiner eigenen Nummer und deiner eigenen E-Mail-Adresse und lösche die Testbestellung danach.Kanäle
Telefon, Web-Chat, WhatsApp, Messenger und E-Mail nutzen dieselben Tools. Eine passende Anrufernummer bestätigt eine Bestellung nur dort, wo der Kanal die Nummer liefert. Überall sonst und bei unterdrückter Nummer fragt der Assistent nach der E-Mail-Adresse oder der Postleitzahl.Automationen
Verbinde WooCommerce unter Automationen → Verbindungen oder importiere die Agent-Tool-Verbindung. Jedes Tool steht als Aktion bereit. Eine Automation, die ein Anruf oder eine Textunterhaltung (SMS, WhatsApp) startet, kennt die Nummer der Gegenseite aus diesem Anruf selbst. Andere Läufe (Webhook, Zeitplan) haben keinen Anrufer: Bestellstatus braucht dort eine E-Mail-Adresse oder eine Postleitzahl, und Letzte Bestellungen des Anrufers meldet, dass keine Nummer vorliegt. Wunsch- und Telefonbestellungs-Aktionen brauchen einen Wert für Vom Anrufer bestätigt, der erst wahr ist, wenn der Anrufer Ja gesagt hat.API, MCP, CLI & SDK
POST /api/v1/tools/integrations/woocommerce · MCP connect_integration · CLI famulor connect-integration woocommerce · SDK client.api.connectIntegration.
products_per_answer, mention_out_of_stock und phone_order_limit.
Fehlersuche
- „Diese Adresse führt nicht zur WooCommerce-REST-API“: prüfe die Shop-Adresse. Auch WordPress-Permalinks auf Einfach verursachen das; wähle unter Einstellungen → Permalinks eine andere Option.
- „Der Shop hat statt Daten eine Webseite geliefert“: Ein Sicherheits-Plugin oder eine Firewall blockiert API-Anfragen. Erlaube Anfragen an
/wp-json/wc/v3/von außen. - „WooCommerce hat Consumer Key oder Secret abgelehnt“: Der Schlüssel wurde widerrufen, sein Benutzer wurde gelöscht, oder der Schlüssel darf keine Bestellungen lesen. Lege einen neuen Schlüssel für einen Shop-Manager an.
- Wünsche scheitern, und das Protokoll meldet, dass der Schlüssel nur lesen darf: Eine Anfrage-Notiz braucht die Berechtigung Lesen/Schreiben.
- Die Verbindungsprüfung scheitert, obwohl die Schlüssel stimmen: Manche Hoster entfernen den Authorization-Header. Bitte deinen Hoster, ihn durchzulassen. Die Verbindung versucht außerdem selbst einen Ausweg.
- Zur Nummer eines Anrufers findet sich keine Bestellung: Die Shop-Suche vergleicht die letzten 8 Ziffern der Nummer. Speichert dein Shop Nummern mit Leerzeichen, frage stattdessen nach der Bestellnummer.