Intégration du widget

Intégrez directement le puissant moteur de devis 3D de Quote3D dans votre propre site web ou plateforme de commerce électronique.

Vue d'ensemble

Le widget d'intégration Quote3D est une solution sans code/low-code qui vous permet de fournir instantanément des devis d'impression 3D à vos clients sur n'importe quel site web. Que vous utilisiez un site personnalisé, WordPress ou Shopify, vous pouvez combler le fossé entre la visualisation de modèles 3D et la passation de commandes de manière transparente.

Fonctionnalités clés

Visualiseur de modèle 3D : Aperçu interactif des fichiers STL, OBJ et 3MF téléchargés.
Tarification instantanée : Calcul automatisé des coûts basé sur vos propres profils de matériaux et d'imprimantes.
Multi-technologie : Prend en charge les technologies FDM, SLA et SLS avec une logique de calcul spécifique.
Thèmes personnalisés : Adaptez l'esthétique de votre marque avec le glassmorphism et des palettes de couleurs personnalisées.
Zéro configuration pour les clients : Vos clients n'ont pas besoin de connaître les détails techniques de slicing ; tout est géré par Quote3D.
Plugins pour plateformes : Plugins prêts à l'emploi pour WooCommerce et Shopify.

Ce que vous pouvez faire

Synchronisation eCommerce en temps réel : Utilisez les événements « Ajouter au panier » pour lier les devis directement au panier de votre boutique.
Génération de prospects automatisée : Capturez automatiquement les exigences des clients et les données du modèle.
Génération de miniatures : Capturez et stockez automatiquement des captures d'écran de modèles pour le suivi de la fabrication.
Redirections flexibles : Envoyez les clients vers des pages de destination spécifiques après un calcul réussi.

Premiers pas

Prêt à intégrer ? Vous pouvez personnaliser le thème de votre widget, la langue, la couleur, le comportement de redirection et la persistance de session directement depuis votre tableau de bord, puis générer le code d'intégration ou les extraits de code de plateforme dont vous avez besoin.

Accéder aux paramètres du widget

💡 Note sur les prix

Les prix sont mis à jour complètement automatiquement dans WooCommerce. Dans les systèmes fermés comme Shopify, PrestaShop et OpenCart, pour garantir que le prix est automatiquement 'écrasé' au niveau du panier, il est recommandé de définir un produit à 1 unité (par exemple, 1 $) dans votre boutique et d'envoyer la quantité autant que le prix, ou d'utiliser un hook de mise à jour du prix via l'API de la plateforme. Le widget transmet entièrement tous les détails techniques calculés et le prix à votre système en tant que 'Propriété'.

Plateformes prises en charge

Le widget Quote3D est construit avec des technologies web modernes et fonctionne sur pratiquement n'importe quelle plateforme. Nous avons des solutions d'intégration prêtes à l'emploi pour les systèmes populaires :

WooCommerce : Compatibilité avec le panier terminée grâce à notre plugin PHP prêt à l'emploi.
Shopify : Prise en charge du bloc d'application basé sur Liquid.
Wix : Intégration avancée via Velo et Éléments personnalisés.
Squarespace : Installation rapide via des blocs de code.
PrestaShop : Structures compatibles avec le moteur de template Smarty.
OpenCart : Prise en charge des thèmes modernes basée sur Twig.
Logiciel personnalisé : Peut être intégré à n'importe quel projet React, Vue ou Vanilla JS avec le SDK JS.

Principe de fonctionnement technique

Le Widget Quote3D fonctionne comme un Iframe haute performance ou un SDK JS moderne. Voici comment cela fonctionne :

Fonctionnement isolé : Le widget s'exécute dans sa propre zone protégée (Iframe), ce qui évite de casser le style de votre site web.
Communication en temps réel : Le widget transmet instantanément les résultats des calculs à votre site web via l'API 'postMessage'.
Redimensionnement automatique : Lors de l'utilisation du SDK, le widget ajuste automatiquement sa hauteur en fonction du contenu.

Points de terminaison de l'API Widget

Ces points de terminaison prennent en charge les workflows de widgets courants, tels que la synchronisation des devis calculés vers votre panier et le stockage des images d'aperçu générées. Les appels externes doivent cibler https://api.quote3d.com/v2 et utiliser un vrai token API Bearer, pas un ID de token.

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

Utilisez ce point de terminaison lorsque le widget doit transmettre un devis final à votre flux de commerce électronique. Il enregistre l'événement de conversion, stocke la relation devis/panier et peut déclencher le webhook widget.added_to_cart pour l'automatisation en aval.

Envoyez le contexte final du devis dont votre boutique a besoin avant de rediriger ou d'ouvrir le panier.
Utilisez-le comme pont côté serveur entre le résultat du widget et votre système de panier/commande.
Considérez-le comme l'événement d'ajout au panier canonique si vous vous appuyez sur le webhook Quote3D ou le suivi d'audit.

`POST /v2/thumbnail/save`

Utilisez ce point de terminaison pour enregistrer une image de prévisualisation du modèle capturée côté client. La miniature enregistrée peut ensuite être attachée aux éléments du panier, aux métadonnées de la commande ou aux flux de travail de fabrication.

Envoyez l'image générée au format base64 avec le contexte du fichier afin que Quote3D puisse la stocker dans le bon emplacement de téléchargement.
La réponse renvoie une URL de miniature enregistrée que vous pouvez conserver dans les charges utiles du widget ou les données de commande en aval.
C'est la méthode recommandée pour enregistrer les captures d'écran du widget au lieu de stocker des données d'image temporaires propres au navigateur.

Sécurité et Vérification

Les intégrations de widget nécessitent un vrai token API Bearer afin que l'expérience intégrée puisse appeler Quote3D au nom de votre compte. Les ID de token affichés dans les listes de tokens ne peuvent pas authentifier les appels API. Générez un token dédié au widget depuis Dashboard > Tokens, copiez-le lors de sa création, faites-le tourner régulièrement, privilégiez des expirations courtes lorsque c'est possible et vérifiez les webhooks côté serveur avec des signatures HMAC avant de faire confiance aux événements de panier ou de conversion.