# Shopify

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

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

Shopify wird über eine private App verbunden, die HAPP für Ihren Shop einrichtet. Danach findet der Agent die letzten Bestellungen eines Käufers anhand der Telefonnummer, legt neue Bestellentwürfe mit Checkout-Link 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 den Käufer über die Telefonnummer aus der Bestellung und nennt ihm Bestellnummer, Zahlungs- und Lieferstatus, Artikel, Gesamtsumme sowie die Sendungsnummer, falls für das Paket eine vorliegt.
* **Bestellung aufgeben** — legt in Shopify einen Bestellentwurf mit den gewählten Varianten (Größe, Farbe) sowie Name, Telefonnummer und Lieferadresse des Käufers an und sendet ihm einen Zahlungslink. Der Entwurf erhält das Tag `happ`, damit Sie ihn unter **Bestellungen > Entwürfe** finden.
* **Antworten aus dem Katalog** — kennt Ihre aktiven Produkte mit Preisen, Varianten und Verfügbarkeit und findet ein Produkt anhand eines Fotos, das der Käufer schickt.

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

* **Shopify-Shop** mit beliebigem Tarif. Basic reicht aus.
* **Inhaber- oder Mitarbeiterkonto des Shops**, mit dem Sie im Shop-Admin Apps installieren können.
* **HAPP-Workspace** mit mindestens einem Agenten, der für Kundengespräche eingerichtet ist.
* **Shopify für Ihren Workspace freigeschaltet** — die Integration wird pro Unternehmen freigeschaltet. Bitten Sie den HAPP-Support, sie zu aktivieren und die Shop-App einzurichten, und senden Sie ihm Ihre Shop-Adresse (`your-store.myshopify.com`).

## Verbinden [#connect]

1. Öffnen Sie in HAPP **Integrationen** und suchen Sie Shopify unter **CRM hinzufügen**.
2. Klicken Sie auf **Verbinden** und geben Sie Ihre Shop-Adresse ein — `your-store`, `your-store.myshopify.com` oder der Link aus Ihrem Shop-Admin funktionieren gleichermaßen.
3. Shopify öffnet sich und zeigt, worauf HAPP zugreifen darf: Produkte, Kunden und Bestellungen. Klicken Sie auf **Installieren**.
4. Sie gelangen zurück zu **Integrationen**; Shopify steht jetzt unter **Meine Integrationen**.

HAPP erhält Lesezugriff auf Produkte, Kunden und Bestellungen sowie das Recht, Bestellentwürfe anzulegen. Produkte, Preise, bestehende Bestellungen oder Kunden kann HAPP nicht ändern.

## 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** — Bestellentwürfe mit 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 aktive Produkte.

## Einschränkungen [#limits]

* Der Agent legt **Bestellentwürfe** an, keine abgeschlossenen Bestellungen. Der Käufer bezahlt über den Link; bis dahin bleibt die Bestellung unter **Entwürfe**.
* Als Land der Lieferadresse wird das Land Ihres Shops verwendet. Ist im Shop kein Land hinterlegt, wird die Ukraine verwendet.
* Die Telefonsuche ist exakt: Der Käufer muss die Telefonnummer angeben, die er bei der Bestellung verwendet hat. Formate wie `050 111 22 33` oder `+380501112233` funktionieren beide.

## Fehlerbehebung [#troubleshooting]

| Problem                                                      | Ursache                                                          | Lösung                                                                                                   |
| ------------------------------------------------------------ | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| „Shopify app for … is not set up yet“                        | HAPP hat die App für Ihren Shop noch nicht erstellt              | [Kontaktieren Sie den Support](https://happ.tools/contacts) und nennen Sie Ihre Shop-Adresse.            |
| „This Shopify store is already connected to another company“ | Der Shop ist mit einem anderen HAPP-Workspace verbunden          | Trennen Sie ihn zuerst dort oder bitten Sie den Support, ihn zu verschieben.                             |
| „Shopify refused access — reconnect the store“ (401)         | Die App wurde deinstalliert oder der Zugriff widerrufen          | Öffnen Sie **Integrationen** > **Shopify** und klicken Sie erneut auf **Verbinden**.                     |
| „Shopify blocks customer and order data for this app“        | Der Zugriff auf Kundendaten ist für die Shop-App nicht aktiviert | [Kontaktieren Sie den Support](https://happ.tools/contacts) — HAPP nimmt diese Einstellung einmalig vor. |
| Ein Produkt fehlt im Katalog                                 | Das Produkt ist in Shopify ein Entwurf oder archiviert           | Setzen Sie es in Shopify auf **Aktiv**; es erscheint nach der nächsten Synchronisierung.                 |

## Trennen [#disconnect]

Deinstallieren Sie die HAPP-App in Shopify (**Einstellungen** > **Apps**) oder trennen Sie die Karte in HAPP. Wird die App in Shopify deinstalliert, schaltet sich die Integration in HAPP automatisch ab. Bestellungen und Entwürfe, die bereits in Shopify 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