Rubens Knowledge Base
Configurator Integration Guide: Key Steps & Best Practices
This guide will walk you through everything you need to seamlessly embed our configurator into your existing website or webshop.
You’ll learn how to:
- Integrate the configurator smoothly within your current site
- Implement pricing for configurations using either your webshop’s price logic or the Rubens Price Service
- Process configurations effectively – whether by adding them directly to the cart or using lead generation forms
- Customize shareable links to keep users within your brand environment
Whether you’re a developer, marketer, or e-commerce specialist, this tutorial will help you brief your team or agency and ensure a successful integration.
1. Embedding the Configurator into Your Existing Website
The Roomle Configurator is integrated into your existing website using our Embedding API. This allows you to embed the configurator directly on any page via iFrame or JavaScript, providing a seamless user experience without redirecting visitors.
2. Pricing Calculation for Configurations
When integrating pricing for your configurations, you have two main options depending on your product complexity and webshop setup. We generally recommend implementing pricing logic directly in your webshop because this allows you to account for dynamic pricing scenarios such as promotions, discounts, or customer-specific prices — and keeps all pricing data centralized in one place.
For very simple product logics or fixed pricing models, the Rubens Price Service can be a convenient alternative. In this case, pricing is managed entirely within the configurator model, reducing the need for webshop-side pricing logic. However, this approach is best suited for straightforward pricing without frequent changes or special offers.
Option 1: Implement Pricing Logic in Your Webshop
To display prices in the configurator, your webshop needs to implement the pricing logic based on the automatically generated part list. This list contains all individual components and their corresponding article numbers.
Since Rubens operates fully API-based, it exposes all events externally. The onPartlistUpdate callback is triggered with every change in the configurator, ensuring your webshop always receives the most up-to-date part list for accurate price calculation.
Option 2: Use the Rubens Price Service
For very simple product pricing scenarios, you can use the Rubens Price Service, where all pricing information is stored directly within the configurator model. This includes fixed prices for components or pricing rules based on configuration values. The price calculation is handled entirely within the Rubens system, which means no webshop-side pricing logic is required.
However, this option is recommended only for simple product logics without complex or frequently changing prices. Also, keep in mind that prices must always be kept up to date manually within the Rubens Admin platform, as they are not dynamically linked to your webshop or ERP system.
3. Processing Configurations (Cart Integration vs. Lead Generation)
Depending on your sales strategy, a finished configuration can either be transferred directly into the purchase process or used to generate leads. Both options can be flexibly integrated into your webshop or website. It’s important to define early on which approach (or combination) will be implemented.
Option 1: Add Configuration Directly to the Cart
For a seamless purchase process, the configuration can be transferred directly to the shopping cart. This handover needs to be technically implemented in the webshop. Among other things, the following aspects should be defined:
- How should the configuration appear in the cart (as individual components or grouped as one item)?
- Should a preview image of the configuration be shown?
- Is there a way to return to the configuration for edits?
- What data should be passed to ERP, webshop, or CRM systems?
The technical implementation is – similar to the pricing setup – based on the automatically generated part list. The configuration data can be captured using an event listener. Once the user clicks the “Add to Cart” button, the requestProduct event is triggered, providing the current configuration including:
- configurationId: Unique ID of the configuration
- partList: Complete list of components with article numbers and quantities
- previewImageUrl: Image URL for the preview
- configurationUrl: Link to reopen the configuration from the cart or reuse the configuration later
Option 2: Lead Generation via Contact Form
Not every configuration results in an immediate purchase – especially for complex or customized products. In many cases, the next step is direct communication with your sales team. This is where lead generation via a contact form becomes valuable.
Instead of sending the configuration to the cart, users can click a "Request Product" button, which triggers a contact form implemented on your website. Through this form, potential customers can submit their configuration as a product inquiry.
This option is particularly well suited for:
- products with individual pricing or delivery models
- B2B customers or consulting-heavy use cases
- quote-based sales processes with additional questions or requirements
- early stages of the customer journey for lead qualification
Technically, this process is also based on the requestProduct event. When triggered, it provides the same configuration data as in the cart flow. The data can be used to pre-fill the form, passed to a CRM system, or stored for internal review.
Typical data passed includes:
- configurationId: Unique ID of the configuration
- partList: Technical basis for pricing or product details for your sales & service team
- previewImageUrl: Preview image for sales or internal use
- configurationUrl: Link to revisit or edit the configuration
4. Customizing Shareable Links
By default, configurations shared via Rubens are published under a Roomle-branded URL. These shareable links should be customized to match your own domain in order to ensure a consistent brand experience across all touchpoints.
This is especially important to make sure that users who access a shared configuration—whether from a saved link, email, or social media—are always brought back to your company’s website rather than to an external URL.
The setup is done via a redirect or proxy configuration and can be seamlessly integrated into existing webshop or CMS structures.