Integrazione Widget

Integra direttamente nel tuo sito web o piattaforma eCommerce il potente motore di preventivazione 3D di Quote3D.

Panoramica

Il widget Embed di Quote3D è una soluzione no-code/low-code che ti permette di fornire preventivi istantanei per la stampa 3D ai tuoi clienti su qualsiasi sito web. Che tu utilizzi un sito personalizzato, WordPress o Shopify, puoi colmare il divario tra la visualizzazione del modello 3D e l'inserimento dell'ordine in modo fluido.

Caratteristiche Principali

Visualizzatore di Modelli 3D: Anteprima interattiva dei file STL, OBJ e 3MF caricati.
Prezzi Istantanei: Calcolo automatico dei costi basato sui tuoi profili di materiali e stampanti.
Multi-Tecnologia: Supporta le tecnologie FDM, SLA e SLS con logiche di calcolo specifiche.
Temi Personalizzati: Abbina l'estetica del tuo brand con il glassmorphism e palette di colori personalizzate.
Configurazione Zero per i Clienti: I tuoi clienti non hanno bisogno di conoscere i dettagli tecnici dello slicing; è tutto gestito da Quote3D.
Plugin per Piattaforme: Plugin pronti all'uso per WooCommerce e Shopify.

Cosa Puoi Fare

Sincronizzazione eCommerce in tempo reale: Utilizza gli eventi 'Aggiungi al carrello' per collegare i preventivi direttamente al carrello del tuo negozio.
Generazione automatica di lead: Acquisisci automaticamente i requisiti del cliente e i dati del modello.
Generazione di miniature: Acquisisci e memorizza automaticamente screenshot dei modelli per il tracciamento della produzione.
Reindirizzamenti flessibili: Invia i clienti a pagine di destinazione specifiche dopo un calcolo riuscito.

Primi Passi

Pronti per l'integrazione? Puoi personalizzare il tema del tuo widget, la lingua, il colore, il comportamento di reindirizzamento e la persistenza della sessione direttamente dalla tua dashboard, quindi generare il codice di incorporamento o gli snippet di piattaforma necessari.

Vai alle Impostazioni del Widget

💡 Nota sui Prezzi

I prezzi vengono aggiornati completamente automaticamente in WooCommerce. In sistemi chiusi come Shopify, PrestaShop e OpenCart, per garantire che il prezzo venga automaticamente 'sovrascritto' nella fase del carrello, si consiglia di definire un prodotto a 1 unità (ad esempio, $1) nel tuo negozio e inviare la quantità pari al prezzo, oppure utilizzare un hook di aggiornamento del prezzo tramite l'API della piattaforma. Il widget trasmette completamente tutti i dettagli tecnici calcolati e il prezzo al tuo sistema come 'Proprietà'.

Piattaforme Supportate

Il Widget Quote3D è costruito con tecnologie web moderne e funziona su praticamente qualsiasi piattaforma. Abbiamo soluzioni di integrazione pronte per i sistemi più popolari:

WooCommerce: Compatibilità completa con il carrello grazie al nostro plugin PHP pronto all'uso.
Shopify: Supporto tramite App Block basato su Liquid.
Wix: Integrazione avanzata tramite Velo e Elementi Personalizzati.
Squarespace: Configurazione rapida tramite blocchi di codice.
PrestaShop: Strutture compatibili con il motore di template Smarty.
OpenCart: Supporto per temi moderni basato su Twig.
Software Personalizzato: Può essere integrato in qualsiasi progetto React, Vue o Vanilla JS con l'SDK JS.

Principio di Funzionamento Tecnico

Il Widget Quote3D opera come un Iframe ad alte prestazioni o un moderno JS SDK. Ecco come funziona:

Funzionamento Isolato: Il widget viene eseguito nella sua zona protetta (Iframe), quindi non compromette lo stile del tuo sito web.
Comunicazione in Tempo Reale: Il widget trasmette istantaneamente i risultati dei calcoli al tuo sito web tramite l'API 'postMessage'.
Ridimensionamento Automatico: Quando si utilizza l'SDK, il widget regola automaticamente la sua altezza in base al contenuto.

Endpoint API Widget

Questi endpoint supportano i comuni workflow dei widget, come la sincronizzazione dei preventivi calcolati nel carrello e la memorizzazione delle immagini di anteprima generate. Le chiamate esterne devono puntare a https://api.quote3d.com/v2 e usare un vero token API Bearer, non un ID token.

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

Utilizza questo endpoint quando il widget deve passare una quotazione finale al tuo flusso di eCommerce. Registra l'evento di conversione, memorizza la relazione quotazione/carrello e può attivare il webhook widget.added_to_cart per l'automazione a valle.

Invia il contesto della quotazione finale di cui il tuo negozio ha bisogno prima di reindirizzare o aprire il carrello.
Utilizzalo come ponte lato server tra il risultato del widget e il tuo sistema di carrello/ordine.
Consideralo l'evento canonico di aggiunta al carrello se fai affidamento sul webhook Quote3D o sul monitoraggio degli audit.

`POST /v2/thumbnail/save`

Utilizza questo endpoint per salvare un'immagine di anteprima del modello acquisita sul lato client. La miniatura salvata può quindi essere allegata agli elementi del carrello, ai metadati dell'ordine o ai flussi di lavoro di produzione.

Invia l'immagine generata come base64 insieme al contesto del file in modo che Quote3D possa memorizzarla nella posizione di upload corretta.
La risposta restituisce un URL della miniatura salvata che puoi conservare nei payload del widget o nei dati dell'ordine a valle.
Questo è il metodo consigliato per salvare gli screenshot del widget invece di memorizzare dati di immagini temporanei solo nel browser.

Sicurezza e Verifica

Le integrazioni del widget richiedono un vero token API Bearer in modo che l'esperienza incorporata possa chiamare Quote3D per conto del tuo account. Gli ID token mostrati nelle liste dei token non possono autenticare le chiamate API. Genera un token dedicato per il widget da Dashboard > Tokens, copialo quando viene creato, ruotalo regolarmente, preferisci scadenze brevi quando possibile e verifica i webhook lato server con firme HMAC prima di fidarti degli eventi del carrello o delle conversioni.