Quote3D ドキュメントへようこそ！⏳
Quote3D LogoQuote3Dドキュメント

ウィジェット連携

Quote3Dの強力な3D見積もりエンジンを、お客様自身のウェブサイトまたはeコマースプラットフォームに直接組み込みます。

概要

Quote3D埋め込みウィジェットは、ノーコード/ローコードソリューションであり、あらゆるウェブサイトで顧客に即時の3Dプリント見積もりを提供できます。カスタムサイト、WordPress、Shopifyなどを使用している場合でも、3Dモデルの表示と注文の配置の間のギャップをシームレスに埋めることができます。

主要機能

  • 3Dモデルビューワー：アップロードされたSTL、OBJ、3MFファイルのインタラクティブなプレビュー。
  • 即時価格計算：独自の材料とプリンタープロファイルに基づいた自動コスト計算。
  • マルチテクノロジー：FDM、SLA、SLSテクノロジーを特定の計算ロジックでサポート。
  • カスタムテーマ：グラスモーフィズムとカスタムカラーパレットでブランドの美学に合わせることができます。
  • クライアント向けの設定不要：お客様は技術的なスライシングの詳細を知る必要はありません。すべてはQuote3Dによって処理されます。
  • プラットフォームプラグイン：WooCommerceとShopify向けのすぐに使用できるプラグイン。

できること

  • リアルタイムのeコマース同期：'カートに追加'イベントを利用して、見積もりをストアのバスケットに直接リンクできます。
  • 自動リード生成：顧客の要件とモデルデータを自動的に取得します。
  • サムネイル生成：製造追跡のために、モデルのスクリーンショットを自動的にキャプチャして保存します。
  • 柔軟なリダイレクト：正常な計算後に、顧客を特定のランディングページに送信します。

はじめに

統合の準備はできましたか？ダッシュボードからウィジェットのテーマ、言語、色、リダイレクト動作、セッションの永続性をカスタマイズし、必要な埋め込みコードまたはプラットフォームスニペットを生成できます。

ウィジェット設定へ

💡 価格に関する注意

WooCommerceでは価格が完全に自動的に更新されます。Shopify、PrestaShop、OpenCartなどのクローズドシステムでは、カート段階で価格が自動的に「上書き」されるようにするために、ストアに1ユニット（例：$1）の製品を定義し、価格と同じ量だけ数量を送信するか、プラットフォームのAPIを介して価格更新フックを使用することをお勧めします。ウィジェットは、計算されたすべての技術的詳細と価格を「プロパティ」としてシステムに完全に送信します。

対応プラットフォーム

Quote3Dウィジェットは最新のWebテクノロジーで構築されており、事実上あらゆるプラットフォームで動作します。一般的なシステム向けの統合ソリューションを準備しています:

  • WooCommerce: 当社のPHPプラグインによる、完了したカートとの互換性。
  • Shopify: LiquidベースのApp Blockサポート。
  • Wix: VeloとCustom Elementsによる高度な統合。
  • Squarespace: コードブロックによる迅速なセットアップ。
  • PrestaShop: Smartyテンプレートエンジンに対応した構造。
  • OpenCart: Twigベースの最新テーマサポート。
  • カスタムソフトウェア: JS SDKを使用して、React、Vue、またはVanilla JSプロジェクトに統合できます。

技術的な動作原理

Quote3Dウィジェットは、高性能なIframeまたは最新のJS SDKとして動作します。その仕組みは以下のとおりです。

  • 独立した動作：ウィジェットは独自の保護された領域（Iframe）で実行されるため、ウェブサイトのスタイルを壊すことはありません。
  • リアルタイム通信：ウィジェットは計算結果を'postMessage' APIを介してウェブサイトに即座に送信します。
  • 自動サイズ調整：SDKを使用する場合、ウィジェットはコンテンツに基づいて高さを自動的に調整します。

ウィジェットAPIエンドポイント

これらのエンドポイントは、計算された見積もりをカートに同期したり、生成されたプレビュー画像を保存したりといった、一般的なウィジェットのワークフローをサポートしています。外部呼び出しは https://api.quote3d.com/v2 を対象とし、トークンIDではなく実際のAPI Bearerトークンを使用する必要があります。

POST /v2/widget/add-to-cart

ウィジェットが完了した見積もりをeコマースフローに引き渡す必要がある場合に、このエンドポイントを使用します。コンバージョンイベントを記録し、見積もり/カートの関係を保存し、ダウンストリームの自動化のためにwidget.added_to_cart webhookをトリガーできます。

  • ストアがリダイレクトまたはカートを開く前に必要な、最終的な見積もりコンテキストを送信してください。
  • ウィジェットの結果とバスケット/注文システム間のサーバーサイドブリッジとして使用してください。
  • Quote3D webhookまたは監査追跡に依存している場合は、これを標準的なカートに追加イベントとして扱ってください。

POST /v2/thumbnail/save

このエンドポイントは、クライアント側でキャプチャされたモデルプレビュー画像を保存するために使用します。保存されたサムネイルは、カートアイテム、注文メタデータ、または製造ワークフローに添付できます。

  • 生成された画像をbase64形式で、ファイルコンテキストとともに送信して、Quote3Dが正しいアップロード場所に保存できるようにします。
  • レスポンスには、ウィジェットのペイロードまたは下流の注文データに保持できる保存されたサムネイルのURLが返されます。
  • これは、一時的なブラウザのみの画像データを保存するのではなく、ウィジェットのスクリーンショットを保存するための推奨される方法です。

セキュリティと検証

ウィジェットの統合には、埋め込み環境がお客様のアカウントの代わりにQuote3Dを呼び出せるように、実際のAPI Bearerトークンが必要です。トークン一覧に表示されるトークンIDではAPI呼び出しを認証できません。Dashboard > Tokens からウィジェット専用のトークンを生成し、作成時にコピーして、定期的にローテーションし、可能な場合は短い有効期限を優先し、カートまたはコンバージョンイベントを信頼する前にサーバーサイドのwebhookをHMAC署名で検証してください。