Connecting OnceHub to a Salesforce Sandbox environment

A Salesforce Sandbox environment is a copy of your production environment. You can use a Salesforce Sandbox environment to test the OnceHub connector for Salesforce without compromising the data and applications in your production environment.

OnceHub enables you to connect to a Salesforce Sandbox environment and keep your Salesforce connector setup when you switch to your production environment.

In this article, you'll learn how to connect the OnceHub connector for Salesforce to your Salesforce Sandbox environment and how to switch to your production account after you finish testing.

Requirements

To connect OnceHub to a Sandbox environment, you must be:

You do not need an assigned product license to install and update Salesforce account settings. Learn more

The Salesforce API User

To connect to OnceHub, the Salesforce API User must have the following characteristics in your Salesforce Sandbox environment:

  • The User License field must be Salesforce. The Salesforce User License is designed for Users who require full access to standard CRM and Force.com AppExchange apps. Users with this User License are entitled to access the OnceHub connector for Salesforce managed application.
  • The Profile field must be System Administrator. The System Administrator profile must include the API Enabled profile permission and the ModifyAllData permission to ensure the access to the OnceHub connector for Salesforce connected app.

Connecting to the Salesforce Sandbox environment

ImportantIf OnceHub automatically logged you to your Salesforce production environment, you must disconnect and log out of Salesforce before trying to connect to the API User again.

  1. Select your profile picture or initials in the top right-hand corner → Profile settings → CRM.
  2. In the Salesforce box, click the Setup button (Figure 1).
    Figure 1: Set up API Connection in OnceHub
  3. On the API connection tab, check the Connect to a Salesforce Sandbox environment checkbox and connect to an API User created in your Salesforce Sandbox environment (Figure 2). Learn more about connecting to the API User 
    Figure 2: Connect to a Salesforce Sandbox environment

Once connected, you can proceed with the next steps in the Salesforce connector setup process:

Once the setup completed, you can test the OnceHub connector for Salesforce in your Salesforce Sandbox environment.

Switching from a Salesforce Sandbox environment to a Production Account

When you're ready to switch to your production environment, you must disconnect the API User from your Salesforce Sandbox environment and connect to your production environment.

  1. Select your profile picture or initials in the top right-hand corner → Profile settings → CRM.
  2. In the Salesforce box, click the Setup button.
  3. On the API Connection tab, click Disconnect.
    After disconnecting OnceHub from your Salesforce Sandbox environment, all Users connected to the Salesforce Sandbox will be disconnected automatically and won't be able to accept bookings.
  4. On the API connection tab, uncheck the Connect to a Salesforce Sandbox environment checkbox and connect to an API User created in your Salesforce production environment. Learn more about connecting to the API User

    ImportantIf OnceHub automatically signed you in to your Salesforce Sandbox environment, you must disconnect and sign out of Salesforce before trying to connect to the API User again.

Once connected, you can proceed with the setup:

ImportantIf the Salesforce Sandbox is a mirror of your production environment, your OnceHub setup will be kept when you switch to your production environment. However, you must complete the OnceHub connector for Salesforce setup to be able to accept bookings in your production environment.

You're done! Now you need to ask Users to connect to their Salesforce production account to integrate with Salesforce.

Was this article helpful?
Thank you for your feedback!