Integration

Der WebKatalog kann in bestehende Websites und Shopsysteme integriert werden. Es gibt zwei Haupt-Szenarien:

iFrame-Integration

Der WebKatalog wird als <iframe> in eine bestehende Website eingebettet. Dies ermöglicht:

• Einbettung in jede beliebige Website
• Eigenes Design und Layout der umgebenden Seite
• Kommunikation über postMessage API

→ Mehr zur iFrame-Integration

postMessage-Kommunikation

Die bidirektionale Kommunikation zwischen WebKatalog und Elternseite ermöglicht:

• Lead-Generierung: Kontaktanfragen mit konfigurierten Artikeldaten
• Benutzer-Tracking: Analytics-Events für alle Benutzerinteraktionen
• Fehlerbehandlung: Automatische Fehlerbenachrichtigungen
• Warenkorb-Integration: Aktualisierungen des Warenkorbs
• Dynamische Konfiguration: Live-Updates von Einstellungen

→ Mehr zur postMessage-Kommunikation

Architektur

graph TB
    subgraph "Kunden-Website"
        FE[Frontend / Shop]
    end
    
    subgraph "WebKatalog (iFrame)"
        WK[WebKatalog Frontend]
        PM[postMessage Service]
    end
    
    subgraph "3D office APIs"
        XCF[XCF - Katalog]
        OFML[OFML - Artikel]
        ODB[ODB - Grafik]
    end
    
    FE <-->|"postMessage"| WK
    WK --> XCF
    WK --> OFML
    WK --> ODB

Voraussetzungen

Für die Integration wird benötigt:

• Gültiges Session-Token für die Authentifizierung
• Berechtigung zur iFrame-Einbettung (CORS-Konfiguration)
• Optional: postMessage-Handler für erweiterte Integration

Gut zu wissen

Die einfachste Art der Integration ist die direkte iFrame-Einbettung ohne postMessage. Für erweiterte Funktionen wie Lead-Generierung oder Analytics empfehlen wir die vollständige postMessage-Implementierung.