> ## 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.

# Famulor Shopify-App

> Verbinde einen bestehenden Famulor-Workspace und nutze Sprachsupport direkt im Shopify-Admin.

Die **Famulor AI Agent**-App verbindet einen Shopify-Store mit einem bestehenden Famulor-Workspace. Der Store-Inhaber installiert die App, öffnet sie im Shopify-Admin und bestätigt die Workspace-Verknüpfung. API-Secrets und die manuelle Eingabe der Store-Domain sind nicht nötig.

Die Shopify-App hat keine zusätzliche App-Gebühr. Dein bestehendes Famulor-Abonnement und die Nutzungskosten gelten weiter. Ein bestehendes Famulor-Konto ist erforderlich.

## Workspace verbinden

1. Öffne **Famulor AI Agent** im Shopify-Admin als Store-Inhaber.
2. Wähle **Connect Famulor workspace** und melde dich im neuen Tab bei Famulor an.
3. Wähle einen Workspace, in dem du Owner oder Admin bist, und klicke **Connect store**.
4. Kehre zum Shopify-Admin zurück und klicke **Refresh**.

Der Verknüpfungslink ist fünf Minuten gültig und einmal verwendbar. Starte bei Ablauf erneut im Shopify-Admin. Nur der Store-Inhaber kann die verbundenen Workspace-Daten in der App öffnen.

## Assistant-Tools hinzufügen

Öffne **Famulor Tools** aus Shopify Admin. Konfiguriere die native Verbindung und weise Store-Aufgaben über die bestehenden Tools- und Assistant-Einstellungen zu. Der Assistent kann aktuelle Produkte suchen, Bestand und Richtlinien lesen und nach genauer Kundenverifizierung den Bestellstatus abrufen.

Die **Anfrage-Tools** für Storno, Erstattung und Adressänderung erfassen Händleranfragen und ändern keine Shopify-Bestellungen. Tatsächliche Änderungen sind separate Aktionen mit den unten beschriebenen Voraussetzungen.

## Aktivität prüfen

**Store activity** zeigt Aktionen und Gespräche, die diesem Store zugeordnet sind. Gespräche anderer Stores oder Workspaces werden nicht angezeigt. Öffne ein Gespräch für Transkript und verfügbare Aufnahme.

Verwalte verbundene Stores in Famulor unter **Automations → Connections → Shopify app connections**. Trennen verhindert den Zugriff der Assistant-Tools auf diesen Store. Deinstalliere die App in Shopify, um den Shopify-Zugriff zu widerrufen.

## API, MCP, CLI und SDK

Die erste Verknüpfung erfordert die Bestätigung des Store-Inhabers im Shopify-Admin. Anschließend können Owner/Admin-Zugangsdaten den Store programmatisch verwalten.

| Aufgabe | REST API | MCP-Tool | CLI-Befehl |
| - | - | - | - |
| Stores auflisten | `GET /api/v1/shopify/installations` | `list_shopify_installations` | `famulor list-shopify-installations` |
| Aktionskatalog | `GET /api/v1/shopify/actions` | `list_shopify_actions` | `famulor list-shopify-actions` |
| Tools hinzufügen | `POST /api/v1/shopify/installations/{id}/tools` | `provision_shopify_assistant_tools` | `famulor provision-shopify-assistant-tools STORE_ID --assistant-id ASSISTANT_ID --actions lookup_order` |
| Store-Verlauf | `GET /api/v1/shopify/installations/{id}/history` | `list_shopify_history` | `famulor list-shopify-history STORE_ID` |
| Supportanfragen | `GET /api/v1/shopify/installations/{id}/requests` | `list_shopify_support_requests` | `famulor list-shopify-support-requests STORE_ID` |
| Bearbeitung erfassen | `PATCH /api/v1/shopify/installations/{id}/requests` | `resolve_shopify_support_request` | `famulor resolve-shopify-support-request STORE_ID --request-id REQUEST_ID --status completed` |
| Gespräch | `GET /api/v1/shopify/installations/{id}/calls/{callId}` | `get_shopify_call` | `famulor get-shopify-call STORE_ID CALL_ID` |
| Datenschutzberichte | `GET /api/v1/shopify/installations/{id}/privacy-exports` | `list_shopify_privacy_exports` | `famulor list-shopify-privacy-exports STORE_ID` |
| Datenschutzbericht | `GET /api/v1/shopify/installations/{id}/privacy-exports/{exportId}` | `get_shopify_privacy_export` | `famulor get-shopify-privacy-export STORE_ID EXPORT_ID` |
| Trennen | `DELETE /api/v1/shopify/installations/{id}` | `disconnect_shopify_installation` | `famulor disconnect-shopify-installation STORE_ID` |

Lesen nutzt `integrations:read`. Tool-Einrichtung benötigt zusätzlich `assistants:write`, der Store-Verlauf `calls:read`. Store-Änderungen nutzen `integrations:write`.

```ts theme={null}
import { Famulor } from "famulor-sdk";
const famulor = new Famulor({ apiKey: process.env.FAMULOR_API_KEY! });
const stores = await famulor.shopify.installations();
const actions = await famulor.shopify.actions();
const activity = await famulor.shopify.history(stores.data[0].id);
```

Der separate [Automations-Connector mit eigener App](/de/automations/shopify) bleibt für eigene Shopify-App-Zugangsdaten verfügbar. Die native App und der Connector haben getrennte Verbindungen und Fähigkeiten.

## Natives Shopify-Plugin (Beta)

Aktiviere Beta-Funktionen im Workspace. Öffne **Tools → Agent Connectors** oder **Automations → Connections** und verbinde **Shopify AI Agent App (Beta)**. Beide verwenden dieselbe Store-Verbindung. Erstelle oder wähle einen Assistenten unter **Assistants** und weise die nativen Shopify-Tools über die zentralen **Tools** zu. Wissen, SMS, Übergaben, Rückrufe, Telefonrouting und Kampagnen nutzen die bestehenden Famulor-Einstellungen.

Produkte, Varianten, Preise und Bestand werden live aus Shopify gelesen; Famulor importiert keinen Produktkatalog. Preise und Bestand sind Momentaufnahmen, die endgültige Summe entsteht im Checkout. Private Bestelldaten erfordern eine genaue Bestellreferenz, passende E-Mail und Lieferpostleitzahl. Die Rufnummer allein reicht nicht.

Anfragen zur Händlerprüfung bleiben von tatsächlichen Shopify-Änderungen getrennt. Entwürfe, Rechnungs-E-Mails, Stornierungen, Lieferadressänderungen und Retouren erfordern Händlerfreigabe, Store-Berechtigungen und die unterstützte Telefonlaufzeit. Änderungen bestehender Kunden/Bestellungen erfordern zusätzlich private Verifizierung und eine ausdrückliche, an die vorbereitete Aktion gebundene Bestätigung. Fehlende Voraussetzungen blockieren die Ausführung. Stornierung erstattet kein Geld automatisch; ein Bestellentwurf belastet niemanden. Retouren hängen von aktuellen Lieferungen und Händlerregeln ab; Umtausch kann Händlerbearbeitung erfordern. Die Verbindung garantiert keine Recovery-Zielgruppen, Abonnementzugriffe oder zusätzlichen Umsatz.

| REST API | MCP | CLI |
| - | - | - |
| `GET /api/v1/shopify/setup` | `get_shopify_setup` | `famulor get-shopify-setup` |
| `PATCH /api/v1/shopify/installations/{id}/capabilities` | `update_shopify_capabilities` | `famulor update-shopify-capabilities STORE_ID --enabled-capabilities voice_checkout --expected-version VERSION` |

```ts theme={null}
const setup = await famulor.shopify.setup();
await famulor.shopify.updateCapabilities(storeId, { enabled_capabilities: ["voice_checkout"], expected_version: setup.data.capabilities!.version });
```

## Externe Telefon-Zielgruppen (Beta)

Wähle in den bestehenden Campaign Settings eine berechtigte Shopify- oder Klaviyo-Verbindung und ein aktuelles Quellsegment. Lokale Lead-Kampagnen behalten ihr Verhalten. Shopify unterstützt ausgewählte Segmente einschließlich VIP, Rückgewinnung, Nachbestellung, abgebrochenen Checkout und das unterstützte Zahlungsausfall-Szenario. Klaviyo unterstützt derzeit nur ausgewählte Segmente. Wähle Nachbestellprodukte im Live-Produktpicker. Rückgewinnung und Nachbestellung benötigen ältere Bestellungen. Zahlungsausfall umfasst unbezahlte, nicht stornierte echte Bestellungen mit vollständigem Fehlernachweis und ohne spätere erfolgreiche/ausstehende Zahlung oder neuere Bestellung; Abonnementereignisse und ungespeicherte Checkouts sind nicht enthalten.

Nur Telefonanrufe; Follow-up auf Off setzen. Vor jedem Versuch prüft Famulor Segmentzugehörigkeit, Szenario, Rufnummer und eine ausdrückliche positive Telefon-Marketing-Einwilligung. E-Mail/SMS-Abonnement, Caller-ID oder fehlender Sperrlisteneintrag reichen nicht. Fehlender Nachweis schließt Empfänger aus. Zeitfenster, Sperrlisten, Wiederholungen und Kapazität gelten weiter. Nach Beginn der Quellausführung kann die Zielgruppe nicht mehr geändert werden.

Ordne einen maßgeblichen JSON-Datensatz über Namespace und Schlüssel zu (Namespace ist für Shopify erforderlich). Er muss aktuelle `subject_ref` und `phone`, `channel: "voice"`, `purpose: "marketing"`, `granted: true`, `revoked: false`, einen nicht zukünftigen `granted_at`, `evidence_ref` und aktuelle `source_revision` enthalten. Famulor speichert Betriebsreferenzen und Ausführungszustand, keine Kopie der Kunden, Bestellungen oder Produkte.

## Zugeordnete Nettozahlungen

Aktualisiere die zugeordneten Zahlungen in der bestehenden Shopify-App-Aktivität. Famulor liest aktuelle Zahlungs-, Erstattungs- und Stornozustände nur für gespeicherte Anrufreferenzen. Konvertierte Entwürfe werden ihrer Bestellung zugeordnet; jede Bestellung zählt einmal und gehört zur frühesten Store-Anrufzuordnung, bei Gleichstand entscheidet die Anruf-ID. Kampagnenfilter gelten danach. Exakte Dezimalsummen bleiben nach Store-Währung getrennt. Zeitpunkt, Erstattungen, Stornos und unvollständige Abfragen werden angegeben. Fehlende Referenzen, Zugriff oder ältere/begrenzte Historie zählen nicht als Nullumsatz. Dies ist eine Zuordnung, kein zusätzlicher oder kausal erzeugter Umsatz.

| REST | MCP | CLI |
| - | - | - |
| `GET /api/v1/shopify/installations/{id}/revenue` | `get_shopify_associated_revenue` | `famulor get-shopify-associated-revenue STORE_ID` |

```ts theme={null}
const payments = await famulor.shopify.associatedRevenue(storeId);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.