> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify verbinden

> Verbinde deinen Shopify-Store mit deiner eigenen Dev-Dashboard-App mit Automations – ohne App-Store-Review, ohne Anmeldefenster

Shopify bietet keine gemeinsame Anmelde-App für Drittplattformen: Eine App, die viele Stores installieren, muss zuerst Shopifys App-Store-Review bestehen. Famulor verbindet **deinen** Store deshalb über **deine eigene** Shopify-App. Du legst sie in wenigen Minuten im Shopify Dev Dashboard an, installierst sie auf deinem Store und trägst Client-ID und Secret in Famulor ein. Famulor tauscht sie gegen ein Admin-API-Token und erneuert es automatisch.

Das bekommst du: alle Shopify-**Auslöser und -Aktionen** im [App Catalog](/de/automations/app-catalog) – Bestellungen, Produkte, Kunden, Lagerbestände, Fulfillments, Rabatte und mehr – plus die Shopify-Tools, die deine Assistenten über eine Automatisierung aus einem Gespräch heraus aufrufen können.

<Note>
  Das ist etwas anderes als die Verbindung **Shopify (Storefront MCP)**, die nur den öffentlichen Katalog, Warenkörbe und Richtlinien eines Stores liest und keine App braucht. Nutze diese Anleitung, wenn eine Automatisierung Store-Daten über die Admin-API lesen oder ändern soll.
</Note>

## Bevor du startest

* Du bist **Inhaber oder Mitarbeiter mit App-Entwicklungsrechten** des Shopify-Stores.
* Dein Famulor-Workspace hat die Automation-Plattform im Plan und **Beta Features** aktiviert (Settings → Workspace → Beta Features).
* Halte den permanenten Store-Namen bereit – das `acme` in `acme.myshopify.com` (Shopify-Admin → Einstellungen → Domains). Deine eigene Domain funktioniert nicht.

Die Einrichtung dauert etwa zehn Minuten. Client-ID und Secret bleiben beim App-Connector; Famulor speichert sie nie in deinem Workspace.

## Schritt 1 – Dev Dashboard öffnen

Tippe im Shopify-Admin **App development** in die Suchleiste und öffne den Einstellungs-Eintrag, oder gehe zu **Einstellungen → Apps und Vertriebskanäle → Apps entwickeln**.

<Frame caption="Shopify-Admin: nach „App development“ suchen">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/01-search-app-development.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=3b0db84fe64cdd662f0612bf6b51e733" alt="Shopify-Admin-Suche mit hervorgehobenem Eintrag App development" width="1696" height="991" data-path="images/automations/shopify/01-search-app-development.png" />
</Frame>

Klicke **Build apps in Dev Dashboard**. Die Option für Legacy-Custom-Apps kannst du ignorieren – Shopify stellt sie ein, und Famulors Verbindung nutzt das neue App-Modell.

<Frame caption="Dev Dashboard aus App development öffnen">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/02-build-apps-dev-dashboard.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=09cde8ff3c07b94c431427688e551647" alt="Seite App development mit dem Button Build apps in Dev Dashboard" width="1696" height="951" data-path="images/automations/shopify/02-build-apps-dev-dashboard.png" />
</Frame>

## Schritt 2 – App anlegen

Klicke im Dev Dashboard oben rechts auf **Create app**.

<Frame caption="Dev Dashboard → Create app">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/03-dev-dashboard-create-app.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=11b82225a30b0018c57ceff3f3b30e6e" alt="Apps-Seite im Dev Dashboard mit dem Button Create app" width="1696" height="996" data-path="images/automations/shopify/03-dev-dashboard-create-app.png" />
</Frame>

Wähle **Start from Dev Dashboard**, gib der App einen Namen, den du später wiedererkennst (zum Beispiel `famulor-voice`), und klicke **Create**. Shopify CLI brauchst du nicht.

<Frame caption="App benennen und Create klicken">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/04-create-app-name.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=e24cb166914f14b3a7cb9866505e7fb6" alt="Dialog Create an app mit Feld für den App-Namen" width="1696" height="994" data-path="images/automations/shopify/04-create-app-name.png" />
</Frame>

## Schritt 3 – Version mit den nötigen Scopes konfigurieren

Öffne **Versions** und klicke **Create a version**. Lass **App URL** auf einem Platzhalter wie `https://example.com` – Famulor hostet keine eingebettete App – und lass die Redirect-URLs leer. Dieser Verbindungstyp nutzt sie nicht.

<Frame caption="Version anlegen: Name und URLs">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/05-create-version.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=3d2e5dda95ed37510896c7d9ddb976fe" alt="Formular Create a version mit App-Name und URLs" width="1696" height="991" data-path="images/automations/shopify/05-create-version.png" />
</Frame>

Scrolle zu **Access → Scopes** und klicke **Select scopes**.

<Frame caption="Access → Scopes → Select scopes">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/06-access-scopes.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=56a882032e9ec7f9e3adde5671193482" alt="Bereich Access mit dem Feld Scopes und dem Link Select scopes" width="1696" height="991" data-path="images/automations/shopify/06-access-scopes.png" />
</Frame>

Hake die Admin-API-Scopes für die Daten an, die deine Automatisierungen anfassen sollen. Ein sinnvoller Standardsatz:

| Bereich            | Scopes                                                                                                                  |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| Bestellungen       | `read_orders`, `write_orders` (plus `read_all_orders`, wenn du Bestellungen älter als 60 Tage brauchst)                 |
| Produkte & Lager   | `read_products`, `write_products`, `read_inventory`, `write_inventory`                                                  |
| Kunden             | `read_customers`, `write_customers`                                                                                     |
| Fulfillment        | `read_fulfillments`, `write_fulfillments`, `read_assigned_fulfillment_orders`, `write_assigned_fulfillment_orders`      |
| Rabatte & Entwürfe | `read_discounts`, `write_discounts`, `read_draft_orders`, `write_draft_orders`, `read_price_rules`, `write_price_rules` |
| Store-Einrichtung  | `read_locations`, `read_shipping`, `write_shipping`, `read_content`, `write_content`                                    |

Nur `read_*`-Scopes für die genutzten Bereiche reichen ebenfalls. Scheitert eine Automatisierung später an einer Berechtigung, ergänze den Scope hier, veröffentliche eine neue Version und verbinde in Famulor neu.

<Frame caption="Admin-API-Scopes auswählen">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/07-select-scopes-dialog.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=9e691ff69be57648eb8c52c8822647f8" alt="Dialog Select scopes mit Admin-API-Scopes" width="1696" height="1215" data-path="images/automations/shopify/07-select-scopes-dialog.png" />
</Frame>

Klicke unten auf **Release**. Im Dialog kannst du die Version benennen (zum Beispiel `v1`) – dann **Release** bestätigen.

<Frame caption="Version veröffentlichen">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/09-release-version.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=9466a02bdc3ead49820d69537ad0cf70" alt="Dialog Release this new version" width="1696" height="1074" data-path="images/automations/shopify/09-release-version.png" />
</Frame>

Die neue Version ist jetzt als **Active** markiert.

<Frame caption="Die Version ist aktiv">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/10-version-active.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=6016f152d2fe5f953727b34946f2fe13" alt="Versionsliste mit der neuen, als Active markierten Version" width="1696" height="911" data-path="images/automations/shopify/10-version-active.png" />
</Frame>

## Schritt 4 – Distribution festlegen und App auf dem Store installieren

Famulor tauscht die App-Credentials mit Shopifys Client-Credentials-Grant gegen ein Admin-API-Token. Das erlaubt Shopify erst, wenn die App **auf dem Store installiert** ist, und App und Store müssen zur selben Shopify-Organisation gehören – was der Fall ist, wenn du die App aus deinem eigenen Store heraus anlegst.

1. Öffne im linken Menü der App **Distribution** (bei manchen Konten unter **Home → Distribution**).
2. Wähle **Custom distribution** und bestätige. Custom Distribution ist die richtige Wahl für eine App, die nur dein(e) eigene(r) Store(s) nutzen; sie braucht keinen App-Store-Review.
3. Trage die `.myshopify.com`-Domain deines Stores ein, klicke **Generate link** und öffne den Installationslink.
4. Prüfe im Shopify-Admin die angeforderten Scopes und klicke **Installieren**.

<Warning>
  Die Distribution lässt sich pro App nur einmal festlegen. Wähle **Custom** – eine öffentliche App bräuchte Shopifys App-Store-Review, bevor irgendein Store sie installieren könnte.
</Warning>

## Schritt 5 – Client-ID und Secret kopieren

In den **Settings** der App findest du **Credentials**. Kopiere die **Client ID**, blende das **Secret** ein und kopiere es.

<Frame caption="Settings → Credentials: Client ID und Secret">
  <img src="https://mintcdn.com/ouraicall/yKC9j80hMG-IufiE/images/automations/shopify/11-credentials.png?fit=max&auto=format&n=yKC9j80hMG-IufiE&q=85&s=66c834d04f86aff6717c7b2c17ad7cac" alt="Einstellungsseite der App mit Client ID und Secret" width="1696" height="987" data-path="images/automations/shopify/11-credentials.png" />
</Frame>

Behandle das Secret wie ein Passwort. Wenn du es in Shopify jemals rotierst, verbinde in Famulor mit dem neuen Wert neu.

## Schritt 6 – In Famulor verbinden

1. Öffne in Famulor **Automations → Connections** und klicke **Add connection**.
2. Wähle **Browse apps (Beta)**, suche **Shopify** und wähle es aus.
3. Trage den **Store-Namen** ein (`acme` oder `acme.myshopify.com` – Famulor kürzt ihn), die **Client ID** und das **Client secret**.
4. Klicke **Connect Shopify**.

<Frame caption="Famulor: Shopify mit eigener App verbinden">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/ouraicall/images/automations/shopify/12-famulor-connect-shopify.png" alt="Famulor-Verbindungsdialog für Shopify mit Store-Name, Client ID und Client secret" />
</Frame>

Famulor prüft die Credentials sofort bei Shopify. Bei Erfolg erscheint die Verbindung in der Connections-Liste als **ok**, und Shopify steht im App Catalog für jede Automatisierung im Workspace bereit.

## Fehlerbehebung

| Meldung                                                       | Bedeutung                                                                                 | Lösung                                                                                                                           |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| *Shopify does not know this Client ID*                        | Die ID gehört zu keiner App oder enthält einen Tippfehler.                                | Erneut aus Dev Dashboard → deine App → Settings → Credentials kopieren.                                                          |
| *Shopify rejected the client secret*                          | Falsches oder rotiertes Secret.                                                           | Aktuelles Secret unter Settings → Credentials einblenden oder rotieren und den neuen Wert verwenden.                             |
| *The app is not installed on this store yet*                  | Schritt 4 wurde übersprungen oder der Installationslink für einen anderen Store geöffnet. | Custom Distribution setzen, Link für diesen Store erzeugen und installieren.                                                     |
| *This store name does not exist*                              | Eine eigene Domain oder ein Tippfehler wurde eingegeben.                                  | Den permanenten Namen aus Einstellungen → Domains verwenden (`acme` für `acme.myshopify.com`).                                   |
| Ein Automatisierungsschritt scheitert mit Berechtigungsfehler | Der App-Version fehlt ein Scope.                                                          | Scope in Schritt 3 ergänzen, neue Version veröffentlichen, dann auf der Verbindung in Famulor **Replace credentials** ausführen. |

## Neu verbinden und entfernen

* **Credentials ersetzen:** Öffne die Verbindung unter Automations → Connections und wähle **Edit**. Trage neue Client-ID und Secret ein; Famulor ersetzt die hinterlegten App-Credentials in einem Schritt.
* **Entfernen:** Beim Löschen der Verbindung werden auch die App-Credentials aus dem App-Connector entfernt. Automatisierungen, die die Verbindung genutzt haben, zeigen *Connect needed*, bis du Shopify erneut verbindest.
* Um den Zugriff auf Shopify-Seite zu widerrufen, deinstalliere die App von deinem Store oder rotiere das Secret im Dev Dashboard.

## Verwandt

* [App Catalog](/de/automations/app-catalog) – die nutzbaren Shopify-Auslöser und -Aktionen
* [Referenz der Automatisierungs-Knoten](/de/automations/nodes)
* [Automatisierungen im Überblick](/de/automations/overview)