# WooCommerce

Verbinden Sie Ihren WooCommerce-Shop, damit der Agent den Bestellstatus anhand der Telefonnummer prüft, Bestellungen mit Zahlungslink anlegt und Fragen aus Ihrem Katalog beantwortet

> Full REST + WebSocket API reference: https://api.happ.tools/reference

WooCommerce wird über einen Schlüssel verbunden, den Ihr Shop für HAPP ausstellt, nachdem Sie den Zugriff auf Ihrer eigenen Website bestätigt haben. Danach findet der Agent die letzten Bestellungen eines Käufers anhand der Telefonnummer, legt neue Bestellungen mit Zahlungslink an und beantwortet Produktfragen aus Ihrem Katalog — auch die Frage „Haben Sie das?“ anhand eines Fotos.

## Was der Agent kann [#what-the-assistant-can-do]

* **Bestellstatus per Telefonnummer** — findet die Bestellungen des Käufers über die beim Checkout angegebene Telefonnummer und nennt ihm Bestellnummer, Status, Artikel, Gesamtbetrag sowie die Sendungsnummer, falls Ihr Shop eine erfasst.
* **Bestellung aufgeben** — legt in WooCommerce eine Bestellung mit dem Status **Pending payment** an, mit den gewählten Produkten und Optionen (Größe, Farbe) sowie Name, Telefonnummer und Lieferadresse des Käufers, und sendet ihm den Zahlungslink dieser Bestellung.
* **Antworten aus dem Katalog** — kennt Ihre veröffentlichten Produkte mit Preisen, Varianten und Lagerstatus und findet ein Produkt anhand eines Fotos, das der Käufer schickt.

## Bevor Sie beginnen [#before-you-start]

* **WooCommerce-Shop** auf WordPress, erreichbar über **HTTPS**.
* **WordPress-Administratorkonto** — Sie bestätigen den Zugriff, während Sie angemeldet sind.
* **HAPP-Workspace** mit mindestens einem Agenten, der für Kundengespräche eingerichtet ist.
* **WooCommerce für Ihren Workspace freigeschaltet** — die Integration wird pro Unternehmen freigeschaltet. Bitten Sie den HAPP-Support um die Aktivierung.

Ein Plugin müssen Sie nicht installieren.

## Verbinden [#connect]

1. Melden Sie sich im selben Browser in Ihrem WordPress-Admin an.
2. Öffnen Sie in HAPP **Integrationen** und suchen Sie WooCommerce unter **CRM hinzufügen**.
3. Klicken Sie auf **Verbinden** und geben Sie Ihre Shop-Adresse ein — `your-store.com` oder der Link aus wp-admin funktionieren beide.
4. Ihr Shop zeigt die Seite „HAPP would like to connect to your store“ mit Zugriff **Read/Write**. Klicken Sie auf **Approve**.
5. Sie gelangen zurück zu **Integrationen**; WooCommerce steht jetzt unter **Meine Integrationen**.

Mit dem Schlüssel, den HAPP erhält, lassen sich Produkte, Kunden und Bestellungen lesen und Bestellungen anlegen. Sie finden und widerrufen ihn unter **WooCommerce > Settings > Advanced > REST API**.

## Einstellungen [#settings]

Klicken Sie im Tab **Integrationen** des Agenten auf das Zahnradsymbol der Karte und aktivieren Sie, was der Agent tun darf.

* **Suchen** — Bestellstatus anhand der Telefonnummer des Käufers.
* **Erstellen** — Bestellungen mit ausstehender Zahlung samt Zahlungslink.
* **Katalog** — Produktsuche per Text und per Foto. Die erste Synchronisierung dauert einige Minuten; danach wird der Katalog alle 6 Stunden aktualisiert. Synchronisiert werden nur veröffentlichte Produkte, höchstens 5.000.

## Einschränkungen [#limits]

* Bestellungen werden mit dem Status **Pending payment** angelegt; sobald der Käufer bezahlt, ändert WooCommerce den Status.
* Die Telefonsuche akzeptiert die üblichen Formate (`050 111 22 33`, `+380501112233`, `0501112233`). Gibt es keinen Treffer, durchsucht der Agent Ihre letzten 100 Bestellungen.
* Eine Sendungsnummer wird nur angezeigt, wenn Ihr Shop sie per Plugin speichert — mit WooCommerce Shipment Tracking oder einem Plugin des Versanddienstleisters, das die Frachtbriefnummer (TTN) speichert.

## Fehlerbehebung [#troubleshooting]

| Problem                                                  | Ursache                                                                     | Lösung                                                                                   |
| -------------------------------------------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| „Enter the store address as https\://…“                  | Die Adresse nutzt kein HTTPS oder ist keine öffentliche Website             | Verwenden Sie die `https://`-Adresse Ihres Shops.                                        |
| „The store address redirects to …“                       | Die eingegebene Adresse leitet auf eine andere weiter (z. B. ohne `www`)    | Verwenden Sie zum Verbinden die Adresse aus der Meldung.                                 |
| „Access was not granted on the store“                    | Auf der Freigabeseite wurde **Deny** geklickt                               | Klicken Sie erneut auf **Verbinden** und wählen Sie **Approve**.                         |
| „The store did not send the key to Happ“                 | Ihre Website konnte HAPP nicht erreichen (Firewall oder Sicherheits-Plugin) | Erlauben Sie ausgehende Anfragen an `api.happ.tools` und versuchen Sie es erneut.        |
| „The store refused access — reconnect WooCommerce“ (401) | Der Schlüssel wurde in WooCommerce widerrufen oder gelöscht                 | Öffnen Sie **Integrationen** > **WooCommerce** und klicken Sie erneut auf **Verbinden**. |
| Ein Produkt fehlt im Katalog                             | Das Produkt ist ein Entwurf, privat oder liegt über dem Limit von 5.000     | Veröffentlichen Sie es; es erscheint nach der nächsten Synchronisierung.                 |

## Trennen [#disconnect]

Trennen Sie die Karte in HAPP oder widerrufen Sie den HAPP-Schlüssel unter **WooCommerce > Settings > Advanced > REST API**. Bestellungen, die bereits in Ihrem Shop sind, bleiben unverändert.

## Weiter [#next]

* [CRM](/docs/integrations/crm) — alle CRM-Integrationen
* [Tools](/docs/agents/tools) — was der Agent während des Gesprächs aufruft
* [Integrationen](/docs/integrations) — der vollständige Katalog