Salesforce troubleshooting: Connector issues

This article describes potential issues with the Salesforce integration and how these issues can be fixed. If you’re still having problems, please contact us and we will be happy to assist you.

If Users connected to Salesforce cannot accept bookings, there could be a number of different causes for this. To identify the root cause, you need to determine whether the issue affects all Users connected to Salesforce, or if it affects individual Users only.

Issues affecting all Users connected to Salesforce

In this case, you should first check errors related to the Salesforce API User. Then, you should check the status of the Salesforce API call usage in your Salesforce account.

Checking the Salesforce API User

The Salesforce API User connection in your OnceHub account

If we have detected a problem with the API User connection, the API User will be disconnected from your OnceHub account. In this case, you must reconnect the Salesforce API User. 

This typically happens for the following reasons:

  • The API User credentials are no longer valid. The Salesforce password may have been reset and the security token may have changed. OnceHub uses these credentials to validate the API User connection, so they must be up to date.

  • The OnceHub connector for Salesforce managed package was uninstalled and then reinstalled in your Salesforce organization. When this occurs, the Salesforce API token expires.

To resolve this issue, follow the steps below:

  1. Hover over the lefthand menu and go to the Booking pages icon → open the lefthand sidebar, then select Integrations -> CRM. In the Salesforce box, click Setup (Figure 1).
    Figure 1: Salesforce API User Disconnected
  2. Click the Reconnect the API User button (Figure 2).
    Figure 2: Reconnect the API User

Check the Salesforce API User settings in your Salesforce account

The Salesforce API User is used as a funnel for transferring data between OnceHub and Salesforce. If the API user is properly connected and a global connection problem still exists, it may be the case that changes have been made to the Salesforce API User license, a System Administrator profile, and the OnceHub permission set.

Check the API Usage limit in the past 24 hours

Each Salesforce organization has a limited number of API calls. Each Salesforce organization can be integrated with several applications at a time—OnceHub may just be one of many applications talking with your Salesforce account. This limited number of API calls per Salesforce organization is made available every 24 hours. The number of API calls depends on your contract with Salesforce.

If you have exceeded the API call limit for your Salesforce account, the OnceHub connector for Salesforce will not be able to make API calls to your Salesforce account and connected Users will not be able to accept bookings.

In your Salesforce account, you should check the API Usage limit across your third-party applications and adjust your settings. Go to the Setup page, then select Platform tools -> Environments -> System Overview. Learn more about System Overview: API Usage

Issues affecting only single Users connected to Salesforce

There are many ways in which OnceHub bookings can update Salesforce. For example, some bookings may be made with existing Salesforce contacts and not create new records, while others can be made with Leads and create new Lead records in Salesforce. Since most Salesforce organizations have a wide range of required fields and validation rules, these rules may block specific booking scenarios and not allow creation of new records in Salesforce.

When validation errors are encountered, you need to pinpoint the validation problem by identifying the Booking pages and Salesforce standard objects that are affected. In this case, you should first check the Field validation step of the Salesforce connector setup process. Then you should check if you have custom fields that are universally required in Salesforce and not supported by the integration.

Check the Field validation step of the Salesforce connector setup process

You might have recently added universally required custom fields to the affected Salesforce object. When these fields are supported field types in the Salesforce integration and do not have a Salesforce default value, they will appear in the Field validation step of the Salesforce connector setup process.

When a booking is made and a required field in Salesforce has not been mapped to a field in OnceHub, a Field validation error will be detected. OnceHub will pass a default value to the field in Salesforce. Learn more about default values for universally required fields

Check for non-supported universally required custom fields

You might have recently added universally required custom fields to the affected Salesforce object. When these fields are non-supported field types in the Salesforce integration and do not have a Salesforce default value, they will be indicated in the Field validation step of the Salesforce connector setup process and will not be able to accept a value from OnceHub.

The only solution to this is to set these fields as non-mandatory for the affected Salesforce object, or to set a default value in Salesforce. If you cannot associate a default value for these fields in Salesforce and still want these fields to be required fields for manual entry, you can make these fields required on the Page Layout of the object. Learn more about Page Layouts

Other issues

If you’re still seeing issues, please contact us and we'll be happy to assist you.

Was this article helpful?
Thank you for your feedback!