Integra un widget di preventivo 3D nel tuo sito

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 una pagina specifica dopo un calcolo riuscito. La destinazione deve essere un URL http o https.

Integrazioni di piattaforma: Shopify, WooCommerce e altro

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

Altre piattaforme e stack personalizzati

• 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 i risultati del calcolo alla tua pagina tramite l'API 'postMessage'. Usando l'SDK, gli eventi vengono consegnati solo all'origine che ha incorporato il widget anziché essere diffusi a qualsiasi listener.
• Ridimensionamento Automatico: Quando si utilizza l'SDK, il widget regola automaticamente la sua altezza in base al contenuto.

Usare l'API insieme al widget

Il widget gestisce internamente il proprio traffico API — quelle rotte non le chiami tu. Quando vuoi leggere o elaborare gli stessi dati dal tuo codice, usa gli endpoint pubblici v2 descritti nei Concetti chiave, puntando a https://api.quote3d.com/v2 con un vero token Bearer dell'API e non con un identificativo di token. Per reagire all'aggiunta al carrello di una parte configurata, iscriviti al webhook widget.added_to_cart invece di chiamare direttamente qualcosa.

Sicurezza e Verifica

Il widget chiama Quote3D dal browser, quindi il suo token è visibile a chiunque guardi il sorgente della pagina. Crea un token widget dedicato, limitalo all'ambito widget e vincolalo alle origini del tuo negozio. La rotazione conserva entrambe le restrizioni, così un token widget ruotato non diventa mai ad accesso completo.

File caricati e anteprime

I file caricati tramite il widget sono memorizzati in modo criptato e non sono accessibili pubblicamente. Il payload add-to-cart fornisce thumbnailUrl, un link assoluto che viene renderizzato dal proprio storefront: memorizzalo esattamente come ricevuto. Riscriverlo, rimuovere i parametri della query o ospitarlo nuovamente sotto il proprio dominio impedirà la visualizzazione dell'immagine.

Ambito del token widget

Un token creato con l'ambito widget può raggiungere solo gli endpoint di cui l'esperienza integrata ha davvero bisogno. Tutto il resto dell'API viene rifiutato, così un token prelevato dal sorgente della pagina non può essere usato contro il tuo account.

L'ambito widget consente:

• Leggere la configurazione di stampanti e materiali, così il modulo di preventivo può mostrare le tue opzioni.
• Richiedere un identificativo di caricamento e caricare un file di modello.
• Leggere, ed eliminare, il file che ha caricato.
• Avviare un preventivo asincrono per quel file e interrogare il lavoro risultante.
• Leggere un preventivo tramite id, salvarne la miniatura e inviare l'evento di aggiunta al carrello.

L'ambito widget rifiuta:

• La gestione dei webhook, così un token rubato non può dirottare il tuo flusso di eventi verso un altro server.
• I dati dell'account, la cronologia dei caricamenti, gli elenchi di preventivi, le analisi, l'utilizzo e le quote.
• L'attivazione della licenza e ogni altro endpoint non elencato sopra.

Vincolo di origine

Elenca i negozi autorizzati a usare il token, ad esempio https://shop.example.com. Quote3D controlla la pagina che incorpora il widget quando l'iframe si carica e rifiuta di apparire su qualsiasi sito non in elenco. Lasciandolo vuoto, il token funziona ovunque.

Cosa richiede alla tua pagina il vincolo di origine

• Il controllo legge il referrer che il browser invia quando carica l'iframe del widget. È il comportamento predefinito, quindi a una pagina normale non serve nulla.
• Se la tua pagina imposta referrer-policy: no-referrer, l'origine non può essere verificata e il widget rifiuta di caricarsi. Su queste pagine usa un token senza restrizione di origine.
• Le chiamate dirette all'API vengono controllate a parte: una richiesta inviata da un browser su un sito fuori elenco viene respinta, mentre le chiamate server-to-server, che non inviano l'header Origin, non sono interessate.

Cosa non può leggere un token widget

L'endpoint di configurazione restituisce solo ciò che il modulo di preventivo mostra — nomi delle stampanti, volumi di stampa, materiali, colori e limiti di layer. La tua base di costo (prezzo del materiale al chilogrammo, costo orario macchina, moltiplicatore dei supporti, consumo elettrico) non viene mai inviata al browser; il prezzo è calcolato sul server.

I token creati senza ambito mantengono l'accesso completo, quindi le integrazioni esistenti continuano a funzionare invariate. Aggiungere un ambito è il modo per applicare la restrizione a un token.