Connect Limio and Salesforce

How to connect Limio and Salesforce

Limio offers multiple integration options with Salesforce, as described in Choosing the Right Salesforce Integration.

The two primary integration flows are:

Online → Salesforce: Limio sends data to Salesforce, such as creating new Accounts and Opportunities for online orders. This setup is typically used in B2B scenarios.
Salesforce ←→ Limio: In addition to the use case above, Limio for Salesforce allows customer service agents to seamlessly transfer data from Salesforce to Limio, facilitating order capture, or a sales person to create quotes and convert them to order.

Regardless of the model, you will need to connect Limio and Salesforce, so you are in the right place. However:

To only send data from Limio to Salesforce, follow Section 1.
For bidirectional data exchange, complete Section 1 before proceeding to Section 2.

1. Write data from Limio to Salesforce

Pre-requisites:

Limio account: You will need to login into Limio and have permissions to access the General Settings.
Salesforce account: You will need to login into Salesforce to grant access to Limio. It is best practice for the Salesforce user being used to connect to Limio to be an integration user with the API enabled administrative permission checked on.
- The Limio App will also need to be installed and visible in your Salesforce accounts App Manager with the Permitted Users -> OAuth Policy set to All users may self-authorize.
IP Range: For security purposes, you can check the IP range for delivering webhook events here, which is also used to set up the External Access between Salesforce and Limio.

Step 1.A: Grant External Access

If you only need to send Limio data into Salesforce, the setup is streamlined. Go to your Limio application (e.g.https://{{tenant}}.prod-us.limio.com/). Click on your persona in the top right corner, navigate to Settings, then select Integration and click the Salesforce button.

Select the Salesforce Endpoint. For a sandbox, it'll be https://test.salesforce.com/ . For production, it'll be https://test.salesforce.com/

You will then be asked to grant Allow Access for Limio to communicate to Salesforce.

If you do not see this page and are redirected to Limio Settings, you may be currently logged into a Salesforce environment, which may not be the one you want to connect. In this case, log out of your Salesforce instance and try again. If this is still not working, go into the Incognito mode of your browser and follow the step here.

Once done, you should see it added to your Integration tab under the Salesforce section.

Step 1.B: Request Salesforce Plugin Activation from Limio

Now, we need to start feeding orders into Salesforce. This will use Limio's Order Orchestration Framework to sequence correctly order between different systems, for example with Zuora or Stripe, and your Entitlement system. You will need to decide whether you want Limio to enable the following options:

Account: Create Person Account (typical in B2C) or Account/Contact (typical in B2B).
Duplicate Rules: Whether you use any Duplicate Rules in Salesforce, as Limio can leverage them to identify the right Accounts at the time of Order. You can say No if you're not sure - we can always change this later.
Salesforce Platform Events: Whether you plan to use Salesforce Platform Events to populate your data flexibly in Salesforce. Typically the answer is yes!

More details on those features are available here:

How Limio Updates Salesforce Data

To enable this with the necessary configuration, contact [email protected] to request activation of the Limio Salesforce Plugin from Limio Support.

Please copy paste the below in your email:

Template: "Please setup the Salesforce Order Plugin v3 in Limio to start sending orders to Salesforce with the following options:
- [A. Create Salesforce Person Account] OR [B. create Salesforce Account/Contact]
- [A. I currently use Duplicate Rules] OR [B. I don't use Duplicate Rules in Salesforce]
- [A. I will use Limio Salesforce Platform Events to populate my data in Salesforce] OR [B. I won't use Limio Salesforce Platform Events]

Once setup, you will see Salesforce setup in Settings > Order Processing Configuration.

Any issues? Activation of Salesforce can take up to 20 minutes. If you encounter the following error in Limio: “No default instance, please select a default external key for this service”, this error usually indicates that the Salesforce environment is not fully connected to Limio. If the connection was established recently, it might still be in the syncing process. If the issue persists beyond this timeframe, contact [email protected] for help.

Step 1.C: (Optional) Customise your Limio → Salesforce integration

Salesforce is usually highly customised and you may have your own business processes to recognise an online order or a subscription change. To enable full flexibility while avoiding the need for custom code, Limio uses two Salesforce framework:

Salesforce Platform Events, which will stream to you all online orders and change to Salesforce
Salesforce Lightning Flows, which provides a no-code interface to map your online orders and changes to your Salesforce data

Salesforce is often highly customized, with unique business processes for recognizing online orders and subscription changes. To provide full flexibility without the need for custom code, we leverage two key Salesforce frameworks:

Salesforce Platform Events Platform Events stream all online orders and subscription changes directly to Salesforce, enabling real-time updates.
Salesforce Lightning Flows Lightning Flows offer a no-code interface to map online orders and subscription changes to your Salesforce data, streamlining your business processes.

To learn how to customise your integration, go to:

Salesforce Platform Events Overview

Platform Events

Salesforce Platform Event Definition

Platform Events Definitions

Salesforce Flows to ingest Events

Listen to OrderEvent Flow

2. Push Orders from Salesforce into Limio

Once you have installed the Limio for Salesforce Managed Package into your Salesforce environment, you will need to set up an authentication provider and named credentials in Salesforce.

This will allow you Limio for Salesforce to send orders from Salesforce into Limio. This process is entirely done from Salesforce, though you will need to have some Limio information handy.

To connect Limio for Salesforce to a Limio tenant, we use the following native Salesforce framework:

Authentication Provider: The authentication provider allows you to set up a trust relationship between Limio and Salesforce via OpenID Connect, a universal identity federation framework.
Named credentials: Named credentials then enables you, the person with a Limio account going through this setup, to authenticate yourself in Limio and enable Salesforce to have External Access to Limio.

In other words, this process enables you to authorise Salesforce to talk with Limio and vice versa. This guide will walk you through the process.

Pre-requisites:

Salesforce Setup access: You will need to use the Salesforce Setup. This will require usually administrator permission or profile in Salesforce. If you cannot see Salesforce Setup in your org, contact your Salesforce administration.
Limio Commerce account: To do this setup, you will need to already have a user in Limio (i.e. within your Limio application: https://{{tenant}}.prod-us.limio.com). You will be asked to login via your username as part of this setup, so keep your Limio username and password handy.
- If you're not sure what your Limio application URL is, it's very easy. Just check the URL in your browser, for example:
Receive your Consumer Key and Secret from Limio: Request from Limio Support at [email protected] your Consumer Key and Consumer Secret by clicking here.

Note that URL to do this setup will vary depending on your hosting (EU or US).

Step 2. A: Setup the Authentication Provider in Salesforce

Head to https://login.salesforce.com/, then once logged-in, go to Salesforce Setup in the upper right corner *
Search for Auth Providers 1.
1. Create a new Auth Provider by clicking the 'New' button.
  - Select Open ID Connect as the Auth Provider
2. Populate the fields:
  1. Enter a Name, you can use 'Limio' or any different name like your tenant or domain.
  2. Fill in the Consumer Key and Consumer Secret with values provided by Limio Support
  3. Provide the following values:
    Authorize Endpoint URL:
    US: https://{{tenant}}.prod-us.limio.com/api/sf/oauth2/authorize?authProvider=app
    EU: https://{{tenant}}.prod.limio.com/api/sf/oauth2/authorize?authProvider=app
    Token Endpoint URL:
    US: https://{{tenant}}.prod-us.limio.com/api/sf/oauth2/token?authProvider=app
    EU: https://{{tenant}}.prod.limio.com/api/sf/oauth2/token?authProvider=app
  4. Keep Send access token in header and Include Consumer Secret in API responses ticked.