Widget Entegrasyonu
Quote3D'nin güçlü 3D fiyatlandırma motorunu doğrudan kendi web sitenize veya e-ticaret platformunuza entegre edin.
Genel Bakış
Quote3D Gömülebilir Widget'ı, herhangi bir web sitesinde müşterilerinize anında 3D baskı fiyat teklifleri sunmanıza olanak tanıyan kodsuz/az kodlu bir çözümdür. İster özel bir site, ister WordPress veya Shopify kullanın, 3D model görüntüleme ile sipariş verme arasındaki boşluğu sorunsuz bir şekilde kapatabilirsiniz.
Temel Özellikler
- 3D Model Görüntüleyici: Yüklenen STL, OBJ ve 3MF dosyalarının etkileşimli önizlemesi.
- Anında Fiyatlandırma: Kendi malzeme ve yazıcı profillerinize dayalı otomatik maliyet hesaplaması.
- Çoklu Teknoloji: Belirli hesaplama mantığıyla FDM, SLA ve SLS teknolojilerini destekler.
- Özel Temalar: Glassmorphism ve özel renk paletleri ile marka estetiğinize uyum sağlayın.
- Müşteriler İçin Sıfır Yapılandırma: Müşterilerinizin teknik dilimleme detaylarını bilmesine gerek yoktur; her şey Quote3D tarafından halledilir.
- Platform Eklentileri: WooCommerce ve Shopify için kullanıma hazır eklentiler.
Neler Yapabilirsiniz?
- Gerçek Zamanlı E-Ticaret Senkronizasyonu: Fiyat tekliflerini doğrudan mağazanızın sepetine bağlamak için 'Sepete Ekle' olaylarını kullanın.
- Otomatik Potansiyel Müşteri Oluşturma: Müşteri gereksinimlerini ve model verilerini otomatik olarak yakalayın.
- Küçük Resim Oluşturma: Üretim takibi için model ekran görüntülerini otomatik olarak yakalayın ve saklayın.
- Esnek Yönlendirmeler: Başarılı bir hesaplamadan sonra müşterileri belirli açılış sayfalarına yönlendirin.
Başlarken
Entegre etmeye hazır mısınız? Widget temasını, dilini, rengini, yönlendirme davranışını ve oturum devamlılığını doğrudan panelinizden özelleştirip ihtiyacınız olan embed kodunu veya platform snippet'lerini oluşturabilirsiniz.
Widget Ayarlarına Git💡 Fiyatlandırma Notu
WooCommerce'de fiyatlar tamamen otomatik güncellenir. Shopify, PrestaShop ve OpenCart gibi kapalı sistemlerde fiyatın sepet aşamasında otomatik 'geçersiz kılmanızı' sağlamak için mağazanızda 1 birimlik (örn: 1 TL) bir ürün tanımlayıp adet miktarını fiyat kadar göndermeniz veya platformun API'si üzerinden bir fiyat güncelleme kancası kullanmanız önerilir. Widget, hesaplanan tüm teknik detayları ve fiyatı sisteminize 'Mülk/Property' olarak eksiksiz iletir.
Desteklenen Platformlar
Quote3D Widget, modern web teknolojileriyle oluşturulmuştur ve neredeyse her platformda çalışır. Popüler sistemler için hazır entegrasyon çözümlerimiz bulunmaktadır:
- WooCommerce: Hazır PHP eklentisi ile tamamlanmış sepet uyumluluğu.
- Shopify: Liquid tabanlı Uygulama Bloğu (App Block) desteği.
- Wix: Velo ve Custom Element üzerinden gelişmiş entegrasyon.
- Squarespace: Kod blokları üzerinden hızlı kurulum.
- PrestaShop: Smarty şablon motoru ile uyumlu yapılar.
- OpenCart: Twig tabanlı modern tema desteği.
- Özel Yazılımlar: Her türlü React, Vue veya Vanilla JS projesine JS SDK ile entegre edilebilir.
Teknik Çalışma Prensibi
Quote3D Widget, yüksek performanslı bir Iframe veya modern bir JS SDK olarak çalışır. İşte nasıl çalıştığı:
- İzole Çalışma: Widget, kendi korumalı alanında (Iframe) çalışır, böylece web sitenizin stilini bozmaz.
- Gerçek Zamanlı İletişim: Widget, hesaplama sonuçlarını 'postMessage' API'si aracılığıyla anında web sitenize iletir.
- Otomatik Boyutlandırma: SDK kullanıldığında, widget içeriğe göre yüksekliğini otomatik olarak ayarlar.
Widget API Uç Noktaları
Bu uç noktalar, hesaplanan tekliflerin sepetinize senkronize edilmesi ve oluşturulan önizleme resimlerinin saklanması gibi yaygın widget iş akışlarını destekler. Harici çağrılar https://api.quote3d.com/v2 adresini hedeflemeli ve token ID değil gerçek bir API Bearer token kullanmalıdır.
POST /v2/widget/add-to-cart
Bu uç noktayı, widget'ın tamamlanmış bir teklifi e-ticaret akışınıza devretmesi gerektiğinde kullanın. Dönüşüm olayını kaydeder, teklif/sepet ilişkisini saklar ve aşağı yönlü otomasyon için widget.added_to_cart webhook'unu tetikleyebilir.
- Mağazanızın sepeti yönlendirmeden veya açmadan önce ihtiyaç duyduğu son teklif bağlamını gönderin.
- Bunu, widget sonucu ile sepet/sipariş sisteminiz arasındaki sunucu tarafı köprü olarak kullanın.
- Quote3D webhook'una veya denetim izlemeye güveniyorsanız, bunu standart 'sepete ekle' olayı olarak değerlendirin.
POST /v2/thumbnail/save
Bu uç noktayı, istemci tarafında yakalanan bir model önizleme görüntüsünü kalıcı hale getirmek için kullanın. Kaydedilen küçük resim daha sonra sepete eklenen öğelere, sipariş meta verilerine veya üretim iş akışlarına eklenebilir.
- Oluşturulan görüntüyü base64 olarak ve Quote3D'nin doğru yükleme konumunda saklayabilmesi için dosya bağlamıyla birlikte gönderin.
- Yanıt, widget yüklerinde veya aşağı yönlü sipariş verilerinde saklayabileceğiniz kaydedilmiş küçük resim URL'sini döndürür.
- Bu, geçici tarayıcı tabanlı görüntü verilerini depolamak yerine widget ekran görüntülerini kalıcı hale getirmenin önerilen yoludur.
Güvenlik ve Doğrulama
Widget entegrasyonları, gömülü deneyimin hesabınız adına Quote3D API'sini çağırabilmesi için gerçek bir API Bearer token gerektirir. Token listelerinde görünen token ID değerleri API çağrılarını doğrulamaz. Dashboard > Tokens üzerinden widget için ayrı bir token oluşturun, oluşturulduğu anda kopyalayın, düzenli olarak yenileyin, mümkünse kısa son kullanma süreleri tercih edin ve sepet ya da dönüşüm olaylarına güvenmeden önce sunucu tarafındaki webhook'ları HMAC imzası ile doğrulayın.