Integración del Widget

Integre el potente motor de cotización 3D de Quote3D directamente en su propio sitio web o plataforma de comercio electrónico.

Descripción general

El widget Embed de Quote3D es una solución sin código/con poco código que le permite proporcionar cotizaciones instantáneas de impresión 3D a sus clientes en cualquier sitio web. Ya sea que utilice un sitio personalizado, WordPress o Shopify, puede cerrar la brecha entre la visualización de modelos 3D y la realización de pedidos sin problemas.

Características principales

Visualizador de modelos 3D: Vista previa interactiva de archivos STL, OBJ y 3MF subidos.
Precios instantáneos: Cálculo de costos automatizado basado en sus propios perfiles de materiales e impresoras.
Multi-Tecnología: Soporta tecnologías FDM, SLA y SLS con lógica de cálculo específica.
Temas Personalizados: Adapta la estética de tu marca con glassmorphism y paletas de colores personalizadas.
Cero Configuración para Clientes: Tus clientes no necesitan conocer detalles técnicos de slicing; todo está gestionado por Quote3D.
Plugins para Plataformas: Plugins listos para usar para WooCommerce y Shopify.

Lo Que Puedes Hacer

Sincronización de eCommerce en Tiempo Real: Utiliza eventos 'Añadir al Carrito' para vincular cotizaciones directamente a la cesta de tu tienda.
Generación Automática de Leads: Captura los requisitos del cliente y los datos del modelo automáticamente.
Generación de Miniaturas: Captura y almacena automáticamente capturas de pantalla del modelo para el seguimiento de la fabricación.
Redirecciones Flexibles: Envía a los clientes a páginas de destino específicas después de un cálculo exitoso.

Comenzando

Listo para integrar? Puede personalizar el tema de su widget, idioma, color, comportamiento de redirección y persistencia de sesión directamente desde su panel de control, y luego generar el código para insertar o los fragmentos de plataforma que necesita.

Ir a la configuración del widget

💡 Nota sobre Precios

Los precios se actualizan completamente de forma automática en WooCommerce. En sistemas cerrados como Shopify, PrestaShop y OpenCart, para asegurar que el precio se 'sobrescriba' automáticamente en la etapa del carrito, se recomienda definir un producto de 1 unidad (por ejemplo, $1) en tu tienda y enviar la cantidad como mucho como el precio, o usar un hook de actualización de precios a través de la API de la plataforma. El widget transmite completamente todos los detalles técnicos calculados y el precio a tu sistema como una 'Propiedad'.

Plataformas Soportadas

El Widget Quote3D está construido con tecnologías web modernas y funciona en prácticamente cualquier plataforma. Tenemos soluciones de integración listas para sistemas populares:

WooCommerce: Compatibilidad completa con carritos completados gracias a nuestro plugin PHP listo para usar.
Shopify: Soporte para Bloques de Aplicación basados en Liquid.
Wix: Integración avanzada a través de Velo y Elementos Personalizados.
Squarespace: Configuración rápida a través de bloques de código.
PrestaShop: Estructuras compatibles con el motor de plantillas Smarty.
OpenCart: Soporte de temas modernos basado en Twig.
Software Personalizado: Se puede integrar en cualquier proyecto React, Vue o Vanilla JS con el SDK de JS.

Principio de Funcionamiento Técnico

El Widget Quote3D opera como un Iframe de alto rendimiento o un moderno JS SDK. Así es como funciona:

Operación Aislada: El widget se ejecuta en su propia zona protegida (Iframe), por lo que no interfiere con el estilo de su sitio web.
Comunicación en Tiempo Real: El widget transmite instantáneamente los resultados del cálculo a su sitio web a través de la API 'postMessage'.
Ajuste de Tamaño Automático: Cuando se utiliza el SDK, el widget ajusta automáticamente su altura según el contenido.

Puntos finales de la API de Widget

Estos endpoints admiten flujos de trabajo comunes de widgets, como la sincronización de cotizaciones calculadas con su carrito y el almacenamiento de imágenes de vista previa generadas. Las llamadas externas deben dirigirse a https://api.quote3d.com/v2 y usar un token API Bearer real, no un ID de token.

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

Utilice este endpoint cuando el widget necesite transferir una cotización final a su flujo de comercio electrónico. Registra el evento de conversión, almacena la relación cotización/carrito y puede activar el webhook widget.added_to_cart para la automatización posterior.

Envíe el contexto final de la cotización que su tienda necesita antes de redirigir o abrir el carrito.
Úselo como el puente del lado del servidor entre el resultado del widget y su sistema de carrito/pedido.
Trátelo como el evento canónico de agregar al carrito si confía en el webhook de Quote3D o en el seguimiento de auditoría.

`POST /v2/thumbnail/save`

Utilice este endpoint para persistir una imagen de vista previa del modelo capturada en el lado del cliente. La miniatura guardada se puede adjuntar a los artículos del carrito, los metadatos del pedido o los flujos de trabajo de fabricación.

Envíe la imagen generada como base64 junto con el contexto del archivo para que Quote3D pueda almacenarla en la ubicación de carga correcta.
La respuesta devuelve una URL de miniatura guardada que puede mantener en las cargas útiles del widget o en los datos del pedido posteriores.
Esta es la forma recomendada de persistir capturas de pantalla del widget en lugar de almacenar datos de imagen temporales solo en el navegador.

Seguridad y Verificación

Las integraciones del widget requieren un token API Bearer real para que la experiencia integrada pueda llamar a Quote3D en nombre de su cuenta. Los ID de token que aparecen en las listas de tokens no autentican llamadas API. Genere un token dedicado para el widget desde Dashboard > Tokens, cópielo al crearlo, rótelo regularmente, prefiera expiraciones cortas cuando sea posible y verifique los webhooks del lado del servidor con firmas HMAC antes de confiar en eventos de carrito o conversión.