Widget Integration

Embed Quote3D's powerful 3D quoting engine directly into your own website or eCommerce platform.

Overview

The Quote3D Embed Widget is a no-code/low-code solution that allows you to provide instant 3D printing quotes to your customers on any website. Whether you use a custom site, WordPress, or Shopify, you can bridge the gap between 3D model viewing and order placement seamlessly.

Key Features

3D Model Viewer: Interactive preview of uploaded STL, OBJ, and 3MF files.
Instant Pricing: Automated cost calculation based on your own material and printer profiles.
Multi-Technology: Supports FDM, SLA, and SLS technologies with specific calculation logic.
Custom Themes: Match your brand aesthetics with glassmorphism and custom color palettes.
Zero Configuration for Clients: Your customers don't need to know technical slicing details; it's all handled by Quote3D.
Platform Plugins: Ready-to-use plugins for WooCommerce and Shopify.

What You Can Do

Real-time eCommerce Sync: Use 'Add to Cart' events to link quotes directly to your store's basket.
Automated Lead Generation: Capture customer requirements and model data automatically.
Thumbnail Generation: Automatically capture and store model screenshots for manufacturing tracking.
Flexible Redirects: Send customers to specific landing pages after a successful calculation.

Getting Started

Ready to integrate? You can customize your widget theme, language, color, redirect behavior, and session persistence directly from your dashboard, then generate the embed code or platform snippets you need.

Go to Widget Settings

Pricing Note

Prices are updated completely automatically in WooCommerce. In closed systems like Shopify, PrestaShop and OpenCart, to ensure the price is automatically 'overridden' at the cart stage, it is recommended to define a 1-unit (e.g., $1) product in your store and send the quantity as much as the price, or use a price update hook via the platform's API. The widget fully transmits all calculated technical details and the price to your system as a 'Property'.

Supported Platforms

The Quote3D Widget is built with modern web technologies and works on virtually any platform. We have ready integration solutions for popular systems:

WooCommerce: Completed cart compatibility with our ready PHP plugin.
Shopify: Liquid-based App Block support.
Wix: Advanced integration via Velo and Custom Elements.
Squarespace: Fast setup via code blocks.
PrestaShop: Structures compatible with the Smarty template engine.
OpenCart: Modern theme support based on Twig.
Custom Software: Can be integrated into any React, Vue or Vanilla JS project with the JS SDK.

Technical Working Principle

The Quote3D Widget operates as a high-performance Iframe or a modern JS SDK. Here is how it works:

Isolated Operation: The widget runs in its own protected zone (Iframe), so it doesn't break your website's style.
Real-time Communication: The widget instantly transmits calculation results to your website via the 'postMessage' API.
Automatic Sizing: When using the SDK, the widget automatically adjusts its height based on the content.

Widget API Endpoints

These endpoints support common widget workflows such as syncing calculated quotes to your cart and storing generated preview images. External calls should target https://api.quote3d.com/v2.

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

Use this endpoint when the widget needs to hand off a finished quote to your eCommerce flow. It records the conversion event, stores the quote/cart relationship, and can trigger the widget.added_to_cart webhook for downstream automation.

Send the final quote context that your store needs before redirecting or opening the cart.
Use it as the server-side bridge between the widget result and your basket/order system.
Treat it as the canonical add-to-cart event if you rely on Quote3D webhook or audit tracking.

`POST /v2/thumbnail/save`

Use this endpoint to persist a model preview image captured on the client side. The saved thumbnail can then be attached to cart items, order metadata, or manufacturing workflows.

Send the generated image as base64 together with file context so Quote3D can store it in the correct upload location.
The response returns a saved thumbnail URL that you can keep in widget payloads or downstream order data.
This is the recommended way to persist widget screenshots instead of storing temporary browser-only image data.

Security and Verification

Widget integrations require a client-side token so the embedded experience can call Quote3D on behalf of your account. Use a dedicated token for the widget, rotate it regularly, prefer short expirations and IP restrictions where possible, and verify server-side webhooks with HMAC signatures before trusting cart or conversion events.