Zum Hauptinhalt springen
connic
Starte kostenlos

Shopify

Lass connic-Agenten auf Bestellungen in deinem Shopify-Shop reagieren. Die Agenten taggen Bestellungen und hinterlassen Notizen für dein Team.

Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
Shopify Docs
Publisher
Von connic

Reagiere auf neue, bezahlte und stornierte Bestellungen

Schickt Shopify ein Event zu einem Topic einer eingehenden Verbindung, startet jeder damit verknüpfte Agent. Eine ausgehende Verbindung mit derselben Connection taggt die Bestellung oder ergänzt eine Notiz.

Topics wählen
Neue, bezahlte, ausgeführte, teilweise ausgeführte und stornierte Bestellungen. Jede Verbindung abonniert nur ihre eigenen Topics.
Ein Verlauf pro Bestellung
Alle Events einer Bestellung haben dieselbe conversation_id. Ein Agent mit Session weiß also, was vorher mit der Bestellung passiert ist.
Keine doppelten Runs
Eine Zustellung, die Shopify noch einmal schickt, startet keinen zweiten Run.
  1. Mit einer Bestellung passiert etwas

    Jemand bestellt, oder eine Bestellung wird bezahlt, ausgeführt oder storniert.

    ORDERS_CREATE
  2. connic prüft und bestätigt die Zustellung

    connic prüft die Signatur von Shopify mit dem Client Secret der App und antwortet sofort.

    X-Shopify-Hmac-Sha256
  3. Verknüpfte Agenten starten

    Der Run bekommt das Topic, Name und ID der Bestellung, einen Link in den Shopify-Admin und die vollständige Bestellung.

    ORDERS_PAID
  4. Das Ergebnis landet an der Bestellung

    Eine ausgehende Verbindung mit derselben Connection ergänzt Tags oder eine Notiz an der Bestellung, die den Run gestartet hat.

Eine App, die Webhooks richtet connic ein

Du legst im Shopify Dev Dashboard eine App an und fügst Client-ID und Client Secret einmal ein. Beim Speichern einer eingehenden Verbindung abonniert connic ihre Topics für die App, und beim Löschen entfernt connic die Abonnements wieder.

Deine App, dein Shop
Die App gehört zu deiner Shopify-Organisation und ist in deinem Shop installiert. Du legst ihre Scopes fest und welche Kundendaten sie lesen darf.
Keine Tokens zu rotieren
connic holt sich bei jedem Aufruf mit Client-ID und Client Secret ein kurzlebiges Token von Shopify.
Abonnements kommen zurück
Nach 8 fehlgeschlagenen Zustellungen in Folge löscht Shopify ein Abonnement. Speicherst du die Verbindung erneut, richtet connic es wieder ein.
connectors/shopify-orders.yaml
type: shopify
mode: inbound
connection: acme-shopify
config:
  topics: [ORDERS_CREATE, ORDERS_PAID]
agents:
  - order-review

Tagge Bestellungen und ergänze Notizen

Eine ausgehende Shopify-Verbindung überträgt den Output des Agenten auf eine Bestellung, egal ob der Run von dieser Bestellung oder von einer anderen Verbindung kommt.

Routing
Eine order_id im Output hat Vorrang. Ohne sie ändert ein Run, den eine Bestellung über dieselbe Connection gestartet hat, genau diese Bestellung.
Drei Wege zu senden
Sende nach jedem abgeschlossenen Run, gib dem Modell ein Tool oder rufe send_connector aus Middleware auf, wenn dein Code entscheidet.
Rate Limits inklusive
Bremst Shopify eine Änderung per Rate Limit aus, wartet connic und stellt erneut zu.
connectors/shopify-tags.yaml
type: shopify
mode: outbound
connection: acme-shopify
agents:
  - name: order-review
    outbound: { usage: automatic, source: [shopify-orders] }
output.json
{
  "tags": ["review", "high-value"],
  "note": "Billing and shipping country differ."
}
connector-payload.json
{
  "remove_tags": ["review"],
  "tags": ["address-confirmed"],
  "order_id": "5841234567"
}

Wo Shopify passt

Wähle ein Szenario und sieh, was beim Agenten ankommt und was er an die Bestellung schreibt.

Eine neue Bestellung geht ein, und der Agent taggt Bestellungen, die vor dem Versand jemand prüfen sollte.

Neue Bestellung
Inbound Shopify
order-review
Tag an der Bestellung
shopify-payload.json
{
  "topic": "orders/create",
  "order": "#1042",
  "order_id": 5841234567,
  "url": "https://acme.myshopify.com/admin/orders/5841234567",
  "raw": { "total_price": "1249.00", "currency": "EUR", ... }
}
output.json
{
  "tags": ["review"],
  "note": "Over 1,000 EUR. Check the address before shipping."
}

Eine Bestellung wird bezahlt, und der Agent liest die Notiz des Kunden und taggt Geschenkbestellungen für das Lager.

Bezahlte Bestellung
Inbound Shopify
gift-check
Tag und Notiz
shopify-payload.json
{
  "topic": "orders/paid",
  "order": "#1043",
  "order_id": 5841234601,
  "url": "https://acme.myshopify.com/admin/orders/5841234601",
  "raw": { "note": "Please gift wrap, no invoice in the parcel.", ... }
}
output.json
{
  "tags": ["gift-wrap"],
  "note": "Gift wrap, no invoice in the parcel."
}

Eine Bestellung wird storniert, und der Agent notiert den Grund und taggt sie, wenn jemand nachfassen sollte.

Stornierte Bestellung
Inbound Shopify
cancellation-review
Notiz an der Bestellung
shopify-payload.json
{
  "topic": "orders/cancelled",
  "order": "#1038",
  "order_id": 5841233987,
  "url": "https://acme.myshopify.com/admin/orders/5841233987",
  "raw": { "cancel_reason": "customer", ... }
}
output.json
{
  "tags": ["follow-up"],
  "note": "Cancelled by the customer before shipping."
}

Dein Helpdesk sendet ein Ticket zu einer Bestellung, und der Agent ergänzt eine Notiz an dieser Bestellung.

Helpdesk
Inbound Webhook
support-desk
Notiz an #1042
ticket.json
{
  "ticket_id": "T-20931",
  "order_id": "5841234567",
  "subject": "Wrong delivery address",
  "message": "Please ship order #1042 to Hauptstr. 5 instead."
}
output.json
{
  "order_id": "5841234567",
  "tags": ["address-change"],
  "note": "T-20931: ship to Hauptstr. 5."
}

FAQ zu Shopify

Client-ID und Client Secret einer App, die du im Shopify Dev Dashboard für deinen Shop anlegst, dazu die myshopify.com-Domain des Shops. Damit holt sich connic bei jedem Aufruf ein kurzlebiges Token von Shopify. Ein Access Token musst du also weder kopieren noch rotieren.

read_orders für eingehende Verbindungen und write_orders für ausgehende. Webhooks zu Bestellungen enthalten Kundendaten, deshalb braucht die App auch Zugriff auf geschützte Kundendaten. App und Shop müssen zur selben Organisation in Shopify gehören.

Nein. Beim Speichern einer eingehenden Verbindung abonniert connic ihre Topics für die App im Shop, und beim Löschen entfernt connic die Abonnements wieder. Löscht Shopify ein Abonnement nach 8 fehlgeschlagenen Zustellungen in Folge, richtet connic es beim nächsten Speichern der Verbindung wieder ein.

Ja, mit type: shopify, bei eingehenden Verbindungen den Topics und dem Namen einer Shopify-Connection, die die Zugangsdaten der App enthält.