Shopify Integration Template

Integriere die Shopify E-Commerce-Plattform in deine Mid-call Actions und ermögliche es deinem KI-Assistenten, während Kundengesprächem Bestelldetails abzurufen, Versandstatus zu prüfen und Order-Management zu betreiben.

Überblick & Funktionen

Order-Management

Echtzeit-Zugriff auf Bestelldetails und -status
Versand- und Fulfillment-Tracking
Customer-Information und Order-History
Inventory und Product-Availability-Checks

Customer-Service-Excellence

Sofortige Bestellstatus-Updates
Retouren- und Refund-Management
Upselling und Cross-Selling-Opportunities
Proaktive Problem-Resolution

Shopify Admin API Setup

1. Shopify App & API-Zugang

Private App erstellen

Melde dich als Admin in deinem Shopify-Shop an
Navigiere zu “Apps” → “App and sales channel settings”
Klicke auf “Develop apps” → “Create an app”
App-Name: “Famulor Mid-Call Integration”

Admin API-Berechtigungen

Erforderliche API-Scopes:
  Orders:
    - read_orders (für Bestelldetails)
    - write_orders (für Order-Updates)
  
  Customers:
    - read_customers (für Customer-Info)
    
  Products:
    - read_products (für Produktdetails)
    
Optional für erweiterte Features:
  - read_inventory (Lagerbestände)
  - read_fulfillments (Versanddetails)
  - read_shipping (Versandoptionen)

Access Token generieren

Token-Generation:
"Admin API access token" → "Install app"
Access Token kopieren (sehr lang)
Token sicher speichern als {{SHOPIFY_ACCESS_TOKEN}}
Store-Name notieren als {{SHOPIFY_STORE}} (ohne .myshopify.com)

API-Version & Endpoints

Aktuelle API-Version verwenden: 2024-01
Base-URL: https://store-name.myshopify.com/admin/api/2024-01/
Rate-Limits beachten: 2 Calls/Sekunde (Standard-Plan)

Mid-call Action konfigurieren

Konfiguration im Famulor Interface

Werkzeugdetails
Header-Konfiguration

Feld	Wert
Name*	`Shopify Bestellung abrufen`
Beschreibung	”Ruft detaillierte Bestellinformationen aus Shopify ab für Customer-Service und Order-Management”
Funktionsname*	`get_shopify_order`
Funktionsbeschreibung*	“Ruft Details einer Bestellung aus Shopify ab. Verwenden Sie dies, wenn Kunden nach Bestellstatus, Versandinfos oder Produktdetails ihrer Bestellung fragen.”
HTTP-Methode	`GET`
Timeout (ms)	`5000`
Endpoint*	`https://{{SHOPIFY_STORE}}.myshopify.com/admin/api/2024-01/orders/{order_id}.json`

{
  "X-Shopify-Access-Token": "{{SHOPIFY_ACCESS_TOKEN}}",
  "Content-Type": "application/json"
}

Erweiterte Parameter-Schema

{
  "type": "object", 
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Shopify Order ID oder Order Name",
      "examples": ["12345678", "#1001", "1234567890123"]
    },
    "include_fulfillments": {
      "type": "boolean",
      "description": "Fulfillment-Details einbeziehen?",
      "default": true
    },
    "include_transactions": {
      "type": "boolean", 
      "description": "Payment-Transaction-Details einbeziehen?",
      "default": false
    }
  },
  "required": ["order_id"]
}

Praktische Anwendungsszenarien

Szenario 1: Bestellstatus-Inquiry

Standard-Bestellabfrage

Typisches Customer-Service-Gespräch:

Kunde: "Wo ist meine Bestellung #1001?"

KI: "Ich suche die Bestellung #1001..."

get_shopify_order:
  order_id: "1001"

Response-Integration:
  "Ihre Bestellung #1001 für 149,99€ wurde am 12. Januar versandt. 
   Die Sendung enthält 2 Artikel und sollte morgen bei Ihnen ankommen. 
   Die Tracking-Nummer ist DHL123456789."

Problem-Resolution

Verzögerte Lieferung:

Shopify-Response-Analysis:
  fulfillment_status: "unfulfilled"
  days_since_order: 5
  expected_shipping: "1-2 business days"
  
Proaktive-Communication:
  "Ich sehe, Ihre Bestellung verzögert sich. Das tut mir leid! 
   Normalerweise versenden wir binnen 1-2 Werktagen. 
   Ich eskaliere das an unser Fulfillment-Team und Sie erhalten 
   heute noch ein Update."

Automatic-Actions:
  - Fulfillment-Team-Benachrichtigung
  - Customer-Compensation-Workflow
  - Shipping-Delay-Analysis für Process-Improvement

Szenario 2: Upselling & Cross-Selling

Order-History-Analysis
Inventory-Based-Offers

Customer-Purchase-Pattern:
  
Historical-Orders-Analysis:
  - Frequently-bought-together-Products
  - Average-Order-Value-Trends
  - Seasonal-Purchase-Patterns
  - Category-Preferences

Real-time-Recommendations:
  Wenn Customer fragt nach Bestellung:
    "Ihre Bestellung für den Laptop-Stand kommt morgen an. 
     Übrigens - viele Kunden kaufen dazu auch unser ergonomisches 
     Maus-Pad. Interessiert Sie das?"

Stock-Level-Integration:
  
Wenn Produkt-Inventar niedrig:
  "Ihr bestelltes Modell ist sehr beliebt und fast ausverkauft. 
   Falls Sie weitere benötigen, sollten wir das heute bestellen."

Wenn Related-Products verfügbar:
  "Zu Ihrer Bestellung passen diese Ergänzungen perfekt: 
   [Produktname] ist gerade im Angebot - 20% Rabatt bis Wochenende."

Shopify Response-Verarbeitung

Vollständige Order-Response

{
  "order": {
    "id": 12345678,
    "name": "#1001",
    "email": "max@beispiel.de",
    "created_at": "2024-01-12T10:30:00-05:00",
    "updated_at": "2024-01-12T14:20:00-05:00",
    "total_price": "149.99",
    "subtotal_price": "124.99", 
    "tax_lines": [{"price": "25.00", "rate": 0.2, "title": "VAT"}],
    "currency": "EUR",
    "financial_status": "paid",
    "fulfillment_status": "fulfilled",
    "customer": {
      "id": 987654321,
      "first_name": "Max",
      "last_name": "Mustermann",
      "email": "max@beispiel.de",
      "phone": "+49123456789",
      "total_spent": "1249.85",
      "orders_count": 8
    },
    "shipping_address": {
      "first_name": "Max",
      "last_name": "Mustermann", 
      "address1": "Musterstraße 123",
      "city": "München",
      "zip": "80331",
      "country": "Germany"
    },
    "line_items": [
      {
        "id": 123456,
        "title": "Ergonomischer Laptop-Stand",
        "quantity": 1,
        "price": "124.99",
        "sku": "STAND-ERG-001"
      }
    ],
    "fulfillments": [
      {
        "id": 456789,
        "status": "success",
        "tracking_company": "DHL",
        "tracking_number": "DHL123456789",
        "tracking_url": "https://tracking.dhl.de/..."
      }
    ]
  }
}

Natürliche Sprach-Response

Comprehensive Order-Summary

Template: "Bestellung {{order_number}} für {{customer_name}}, Gesamtbetrag: {{total}}, Status: {{status}}"Erweiterte Customer-Communication:

Vollständige Information:
  "Hallo Herr {{customer_name}}! Ihre Bestellung {{order_number}} 
   für {{total}}€ wurde {{#if fulfillment_status}}bereits versandt{{else}}vorbereitet{{/if}}.
   
   {{#if tracking_number}}
   Die Sendung kommt mit DHL und hat die Tracking-Nummer {{tracking_number}}.
   {{/if}}
   
   {{#if financial_status == 'paid'}}
   Die Zahlung ist bestätigt.
   {{else}}
   Die Zahlung wird noch bearbeitet.
   {{/if}}"

Problem-Solving-Integration

Context-Aware-Responses:
  
Wenn fulfillment_status == "unfulfilled":
  "Ihre Bestellung wird gerade für den Versand vorbereitet. 
   Bei unserem aktuellen Auftragsvolumen dauert das 1-2 Werktage."
  
Wenn days_since_order > 5 UND status == "unfulfilled":
  "Das dauert ungewöhnlich lange. Ich prüfe sofort, 
   was los ist und Sie erhalten innerhalb einer Stunde ein Update."
  
Wenn customer.orders_count > 10:
  "Als treuer Kunde mit {{orders_count}} Bestellungen haben Sie 
   natürlich Priorität. Wie kann ich Ihnen helfen?"

Performance & Analytics

E-Commerce-Service-KPIs

Metrik	Beschreibung	Zielwert
Order Lookup Success Rate	% erfolgreicher Shopify-Abfragen	>98%
Customer Service Resolution	% sofort gelöste Bestellanfragen	>85%
Cross-sell Conversion	% zusätzlicher Käufe durch Mid-Call-Offers	>12%
Customer Satisfaction	Rating nach Order-Service-Calls	>4.7/5

Advanced Shopify Features

Multi-Store-Management

Shopify Plus Features

Multi-Store-Configuration:
  
Regional-Stores:
  EU-Store: "shop-eu.myshopify.com"
  US-Store: "shop-us.myshopify.com" 
  UK-Store: "shop-uk.myshopify.com"
  
Automatic-Store-Detection:
  - Customer-Phone-Number → Region-Detection
  - Order-ID-Pattern → Store-Identification
  - Currency-Preference → Store-Routing

B2B-Features für Shopify Plus

B2B-Order-Features:
  - Company-Account-Management
  - Bulk-Order-Tracking
  - Custom-Pricing-Tiers
  - Purchase-Order-Numbers
  
Integration-Enhancements:
  - Company-Name in Customer-Communication
  - Bulk-Discount-Calculations
  - B2B-specific Order-Status-Messages
  - Account-Manager-Assignment-Logic

API-Rate-Limits: Die Shopify API hat strenge Rate-Limits (2 calls/Sekunde Standard, 4 calls/Sekunde Shopify Plus). Implementiere intelligentes Caching für häufig abgefragte Orders.

Customer-Service-Tipp: Nutze die Customer-Total-Spent und Orders-Count aus der API für personalisierte Ansprache und VIP-Treatment-Entscheidungen.

Passende Seiten: Introduction und Building Flows und Debugging Runs.

Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen MCP-Server verbinden — Tools werden automatisch erkannt. Siehe MCP-Server.

Mid-Call-Tools

Mid-Call-Tools Integrationen

Shopify Integration

Shopify Integration Template

Überblick & Funktionen

Order-Management

Customer-Service-Excellence

Shopify Admin API Setup

1. Shopify App & API-Zugang

Mid-call Action konfigurieren

Konfiguration im Famulor Interface

Erweiterte Parameter-Schema

Praktische Anwendungsszenarien

Szenario 1: Bestellstatus-Inquiry

Szenario 2: Upselling & Cross-Selling

Shopify Response-Verarbeitung

Vollständige Order-Response

Natürliche Sprach-Response

Performance & Analytics

E-Commerce-Service-KPIs

Advanced Shopify Features

Multi-Store-Management

​Shopify Integration Template

​Überblick & Funktionen

Order-Management

Customer-Service-Excellence

​Shopify Admin API Setup

​1. Shopify App & API-Zugang

​Mid-call Action konfigurieren

​Konfiguration im Famulor Interface

​Erweiterte Parameter-Schema

​Praktische Anwendungsszenarien

​Szenario 1: Bestellstatus-Inquiry

​Szenario 2: Upselling & Cross-Selling

​Shopify Response-Verarbeitung

​Vollständige Order-Response

​Natürliche Sprach-Response

​Performance & Analytics

​E-Commerce-Service-KPIs

​Advanced Shopify Features

​Multi-Store-Management

Shopify Integration Template

Überblick & Funktionen

Shopify Admin API Setup

1. Shopify App & API-Zugang

Mid-call Action konfigurieren

Konfiguration im Famulor Interface

Erweiterte Parameter-Schema

Praktische Anwendungsszenarien

Szenario 1: Bestellstatus-Inquiry

Szenario 2: Upselling & Cross-Selling

Shopify Response-Verarbeitung

Vollständige Order-Response

Natürliche Sprach-Response

Performance & Analytics

E-Commerce-Service-KPIs

Advanced Shopify Features

Multi-Store-Management