Интеграция виджета

Встройте мощный движок онлайн-расчета стоимости 3D-печати Quote3D непосредственно в ваш веб-сайт или платформу электронной коммерции.

Обзор

Виджет Quote3D Embed – это решение без кода/с минимальным кодированием, которое позволяет вам предоставлять мгновенные расчеты стоимости 3D-печати вашим клиентам на любом веб-сайте. Независимо от того, используете ли вы собственный сайт, WordPress или Shopify, вы можете беспрепятственно соединить просмотр 3D-модели и размещение заказа.

Ключевые особенности

Просмотрщик 3D-моделей: Интерактивный предварительный просмотр загруженных файлов STL, OBJ и 3MF.
Мгновенный расчет цены: Автоматический расчет стоимости на основе ваших собственных профилей материалов и принтеров.
Поддержка нескольких технологий: поддерживает технологии FDM, SLA и SLS со специализированной логикой расчетов.
Пользовательские темы: настройте внешний вид в соответствии с фирменным стилем, используя glassmorphism и собственные цветовые палитры.
Нулевая конфигурация для клиентов: Вашим клиентам не нужно знать технические детали слайсинга; всем этим управляет Quote3D.
Плагины для платформ: Готовые к использованию плагины для WooCommerce и Shopify.

Что вы можете сделать

Синхронизация с интернет-магазином в реальном времени: используйте события «Добавить в корзину», чтобы напрямую связать расчеты со корзиной вашего магазина.
Автоматизированный сбор лидов: Автоматически собирайте требования клиентов и данные модели.
Автоматическая генерация эскизов: автоматически захватывайте и сохраняйте скриншоты моделей для отслеживания производства.
Гибкие перенаправления: Отправляйте клиентов на определенные целевые страницы после успешного расчета.

Начало работы

Готовы к интеграции? Вы можете настроить тему виджета, язык, цвет, поведение перенаправления и сохранение сеанса непосредственно из вашей панели управления, а затем сгенерировать код для встраивания или фрагменты для платформы, которые вам нужны.

Перейти к настройкам виджета

💡 Примечание по ценам

Цены обновляются полностью автоматически в WooCommerce. В закрытых системах, таких как Shopify, PrestaShop и OpenCart, чтобы гарантировать автоматическое 'переопределение' цены на этапе корзины, рекомендуется определить продукт с единичным количеством (например, $1) в вашем магазине и отправлять количество, равное цене, или использовать хук обновления цены через API платформы. Виджет полностью передает все рассчитанные технические детали и цену в вашу систему как 'Свойство'.

Поддерживаемые платформы

Виджет Quote3D разработан с использованием современных веб-технологий и работает практически на любой платформе. У нас есть готовые решения для интеграции с популярными системами:

WooCommerce: Полная совместимость с корзиной покупок благодаря нашему готовому PHP плагину.
Shopify: Поддержка App Block на основе Liquid.
Wix: Продвинутая интеграция через Velo и Custom Elements.
Squarespace: Быстрая настройка через блоки кода.
PrestaShop: Структуры, совместимые с шаблонизатором Smarty.
OpenCart: Поддержка современных тем на основе Twig.
Пользовательское программное обеспечение: Может быть интегрировано в любой React, Vue или Vanilla JS проект с помощью JS SDK.

Технический принцип работы

Виджет Quote3D работает как высокопроизводительный Iframe или современный JS SDK. Вот как это работает:

Изолированная работа: Виджет работает в своей защищенной зоне (Iframe), поэтому он не нарушает стиль вашего сайта.
Общение в реальном времени: Виджет мгновенно передает результаты расчетов на ваш сайт через API 'postMessage'.
Автоматическое изменение размера: При использовании SDK виджет автоматически регулирует свою высоту в зависимости от контента.

API-интерфейсы виджетов

Эти эндпоинты поддерживают стандартные рабочие процессы виджетов, такие как синхронизация рассчитанных предложений с вашей корзиной и сохранение сгенерированных изображений предварительного просмотра. Внешние вызовы должны направляться на https://api.quote3d.com/v2 и использовать настоящий API Bearer token, а не ID токена.

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

Используйте эту конечную точку, когда виджету необходимо передать завершенную смету в ваш процесс электронной коммерции. Она регистрирует событие конверсии, сохраняет связь между сметой/корзиной и может активировать webhook виджета.added_to_cart для последующей автоматизации.

Отправьте окончательный контекст сметы, который необходим вашему магазину перед перенаправлением или открытием корзины.
Используйте ее как серверный мост между результатом виджета и вашей системой корзин/заказов.
Рассматривайте ее как каноническое событие добавления в корзину, если вы полагаетесь на webhook Quote3D или аудит отслеживания.

`POST /v2/thumbnail/save`

Используйте эту конечную точку для сохранения изображения предварительного просмотра модели, захваченного на стороне клиента. Сохраненную миниатюру затем можно прикрепить к элементам корзины, метаданным заказа или производственным процессам.

Отправьте сгенерированное изображение в формате base64 вместе с контекстом файла, чтобы Quote3D мог сохранить его в нужном месте загрузки.
В ответе возвращается URL сохраненной миниатюры, который вы можете хранить в полезных данных виджета или последующих данных заказа.
Это рекомендуемый способ сохранения скриншотов виджета вместо хранения временных данных изображений, доступных только в браузере.

Безопасность и верификация

Для интеграции виджета требуется настоящий API Bearer token, чтобы встроенный интерфейс мог вызывать Quote3D от имени вашей учетной записи. ID токена, отображаемый в списках токенов, не может аутентифицировать API-вызовы. Создайте отдельный токен для виджета в Dashboard > Tokens, скопируйте его при создании, регулярно меняйте, по возможности используйте короткий срок действия и проверяйте серверные веб-хуки с помощью HMAC-подписей, прежде чем доверять событиям корзины или конверсии.