Widget-Integration

Integrieren Sie die leistungsstarke 3D-Angebotsberechnungs-Engine von Quote3D direkt in Ihre eigene Website oder eCommerce-Plattform.

Überblick

Das Quote3D Embed Widget ist eine No-Code/Low-Code-Lösung, mit der Sie Ihren Kunden sofortige 3D-Druckangebote auf jeder Website anbieten können. Egal, ob Sie eine benutzerdefinierte Website, WordPress oder Shopify verwenden, Sie können die Lücke zwischen der Anzeige von 3D-Modellen und der Auftragserteilung nahtlos schließen.

Hauptmerkmale

3D-Modell-Viewer: Interaktive Vorschau hochgeladener STL-, OBJ- und 3MF-Dateien.
Sofortige Preisberechnung: Automatisierte Kostenkalkulation basierend auf Ihren eigenen Material- und Druckerprofilen.
Multi-Technologie: Unterstützt FDM-, SLA- und SLS-Technologien mit spezifischer Berechnungslogik.
Benutzerdefinierte Designs: Passen Sie das Erscheinungsbild an Ihre Markenästhetik mit Glassmorphismus und benutzerdefinierten Farbpaletten an.
Konfiguration nicht erforderlich für Kunden: Ihre Kunden müssen keine technischen Slicing-Details kennen; alles wird von Quote3D übernommen.
Plattform-Plugins: Sofort einsatzbereite Plugins für WooCommerce und Shopify.

Was Sie tun können

Echtzeit-eCommerce-Synchronisierung: Verwenden Sie 'In den Warenkorb'-Ereignisse, um Angebote direkt mit dem Warenkorb Ihres Shops zu verknüpfen.
Automatisierte Lead-Generierung: Erfassen Sie Kundenanforderungen und Modelldaten automatisch.
Thumbnail-Generierung: Erfassen und speichern Sie automatisch Modell-Screenshots für die Fertigungsnachverfolgung.
Flexible Weiterleitungen: Senden Sie Kunden nach einer erfolgreichen Berechnung an bestimmte Landing Pages weiter.

Erste Schritte

Bereit zur Integration? Sie können Ihr Widget-Theme, die Sprache, die Farbe, das Weiterleitungsverhalten und die Sitzungsdauer direkt über Ihr Dashboard anpassen und dann den Einbettungscode oder die Plattform-Snippets generieren, die Sie benötigen.

Zu den Widget-Einstellungen

💡 Hinweis zur Preisgestaltung

Die Preise werden in WooCommerce vollständig automatisch aktualisiert. Bei geschlossenen Systemen wie Shopify, PrestaShop und OpenCart wird empfohlen, um sicherzustellen, dass der Preis im Warenkorb automatisch 'überschrieben' wird, ein Produkt mit 1 Einheit (z. B. 1 $) in Ihrem Shop zu definieren und die Menge als Preis zu senden oder einen Preisaktualisierungshook über die API der Plattform zu verwenden. Das Widget überträgt alle berechneten technischen Details und den Preis vollständig als 'Eigenschaft' an Ihr System.

Unterstützte Plattformen

Das Quote3D Widget wurde mit modernen Webtechnologien entwickelt und funktioniert auf praktisch jeder Plattform. Wir haben fertige Integrationslösungen für beliebte Systeme:

WooCommerce: Vollständige Warenkorbkompatibilität mit unserem fertigen PHP-Plugin.
Shopify: Unterstützung für App-Blöcke, die auf Liquid basieren.
Wix: Erweiterte Integration über Velo und benutzerdefinierte Elemente.
Squarespace: Schnelle Einrichtung über Codeblöcke.
PrestaShop: Strukturen, die mit der Smarty-Template-Engine kompatibel sind.
OpenCart: Moderne Theme-Unterstützung basierend auf Twig.
Individuelle Software: Kann mit dem JS SDK in jedes React-, Vue- oder Vanilla JS-Projekt integriert werden.

Technisches Funktionsprinzip

Das Quote3D Widget funktioniert als leistungsstarkes Iframe oder ein modernes JS SDK. So funktioniert es:

Isolierter Betrieb: Das Widget läuft in einer eigenen geschützten Zone (Iframe), wodurch der Stil Ihrer Website nicht beeinträchtigt wird.
Echtzeitkommunikation: Das Widget überträgt Berechnungsergebnisse sofort an Ihre Website über die 'postMessage' API.
Automatische Größenanpassung: Bei Verwendung des SDK passt das Widget seine Höhe automatisch an den Inhalt an.

Widget API-Endpunkte

Diese Endpunkte unterstützen gängige Widget-Workflows, wie das Synchronisieren berechneter Angebote mit Ihrem Warenkorb und das Speichern generierter Vorschaubilder. Externe Aufrufe sollten sich an https://api.quote3d.com/v2 richten und ein echtes API Bearer Token verwenden, keine Token-ID.

`POST /v2/widget/add-to-cart`

Verwenden Sie diesen Endpunkt, wenn das Widget ein fertiges Angebot an Ihren E-Commerce-Workflow übergeben muss. Er zeichnet das Konvertierungsereignis auf, speichert die Angebots-/Warenkorb-Beziehung und kann den Widget.added_to_cart-Webhook für nachgelagerte Automatisierung auslösen.

Senden Sie den endgültigen Angebotskontext, den Ihr Shop benötigt, bevor Sie den Benutzer weiterleiten oder den Warenkorb öffnen.
Nutzen Sie ihn als die serverseitige Brücke zwischen dem Widget-Ergebnis und Ihrem Warenkorb-/Bestellsystem.
Betrachten Sie ihn als das kanonische 'Zum Warenkorb hinzufügen'-Ereignis, wenn Sie sich auf den Quote3D-Webhook oder die Überwachungsaufzeichnung verlassen.

`POST /v2/thumbnail/save`

Verwenden Sie diesen Endpunkt, um ein Modell-Vorschau-Bild, das auf der Client-Seite aufgenommen wurde, dauerhaft zu speichern. Die gespeicherte Miniaturansicht kann dann an Warenkorbpositionen, Bestellmetadaten oder Fertigungs-Workflows angehängt werden.

Senden Sie das generierte Bild als Base64 zusammen mit dem Dateikontext, damit Quote3D es am richtigen Upload-Ort speichern kann.
Die Antwort gibt eine gespeicherte Miniaturansicht-URL zurück, die Sie in Widget-Payloads oder nachgelagerten Bestelldaten speichern können.
Dies ist die empfohlene Methode, um Widget-Screenshots dauerhaft zu speichern, anstatt temporäre, browser-exklusive Bilddaten zu speichern.

Sicherheit und Verifizierung

Widget-Integrationen benötigen ein echtes API Bearer Token, damit die eingebettete Anwendung Quote3D im Namen Ihres Kontos aufrufen kann. Token-IDs aus Token-Listen können API-Aufrufe nicht authentifizieren. Erstellen Sie unter Dashboard > Tokens ein dediziertes Widget-Token, kopieren Sie es direkt nach der Erstellung, rotieren Sie es regelmäßig, bevorzugen Sie kurze Ablaufzeiten, wenn möglich, und verifizieren Sie serverseitige Webhooks mit HMAC-Signaturen, bevor Sie Warenkorb- oder Conversion-Ereignissen vertrauen.