Shopify Integration Template

Integrieren Sie Shopify E-Commerce-Plattform in Ihre Mid-Call-Tools und ermöglichen Sie es Ihrem 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

1

Private App erstellen

  • Melden Sie sich als Admin in Ihrem Shopify-Shop an
  • Navigieren Sie zu “Apps” → “App and sales channel settings”
  • Klicken Sie auf “Develop apps” → “Create an app”
  • App-Name: “Famulor Mid-Call Integration”
2

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)
3

Access Token generieren

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

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-Tool konfigurieren

Konfiguration im Famulor Interface

FeldWert
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-MethodeGET
Timeout (ms)5000
Endpoint*https://{{SHOPIFY_STORE}}.myshopify.com/admin/api/2024-01/orders/{order_id}.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

Szenario 2: Upselling & Cross-Selling

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?"

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

Performance & Analytics

E-Commerce-Service-KPIs

MetrikBeschreibungZielwert
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 SatisfactionRating nach Order-Service-Calls>4.7/5

Advanced Shopify Features

Multi-Store-Management


API-Rate-Limits: Shopify API hat strenge Rate-Limits (2 calls/Sekunde Standard, 4 calls/Sekunde Shopify Plus). Implementieren Sie intelligentes Caching für häufig abgefragte Orders.
Customer-Service-Tipp: Nutzen Sie die Customer-Total-Spent und Orders-Count aus der API für personalisierte Ansprache und VIP-Treatment-Entscheidungen.