Famulor Shopify-App

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

Öffne Famulor AI Agent im Shopify-Admin als Store-Inhaber.
Wähle Connect Famulor workspace und melde dich im neuen Tab bei Famulor an.
Wähle einen Workspace, in dem du Owner oder Admin bist, und klicke Connect store.
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.

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 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`

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`

const payments = await famulor.shopify.associatedRevenue(storeId);

Automatisierung

Integrationen

Famulor Shopify-App

Workspace verbinden

Assistant-Tools hinzufügen

Aktivität prüfen

API, MCP, CLI und SDK

Natives Shopify-Plugin (Beta)

Externe Telefon-Zielgruppen (Beta)

Zugeordnete Nettozahlungen

​Workspace verbinden

​Assistant-Tools hinzufügen

​Aktivität prüfen

​API, MCP, CLI und SDK

​Natives Shopify-Plugin (Beta)

​Externe Telefon-Zielgruppen (Beta)

​Zugeordnete Nettozahlungen

Workspace verbinden

Assistant-Tools hinzufügen

Aktivität prüfen

API, MCP, CLI und SDK

Natives Shopify-Plugin (Beta)

Externe Telefon-Zielgruppen (Beta)

Zugeordnete Nettozahlungen