How to Reauthorise your Data Connector with Natterbox

  • Updated on Oct 2, 2025
  • Published on Feb 1, 2024
  • 2 minute(s) read
Prev Next

A Natterbox support agent may inform you that there is an issue with your Data Connector or an API User.

Permissions Required for the Data Connector / API User

The Data Connector is responsible for connecting the Natterbox Platform on our backend system to your Natterbox App within Salesforce.

Natterbox, like many other Salesforce applications, strongly recommends the API user being assigned System Admin permissions. This is to prevent issues as the Natterbox solution is heavily customisable and can interact with many objects and fields.

Should System Administrator access not be provided, the following will need to be granted at a minimum:

  • API Enabled

  • View all Custom Settings

  • Customise Application

The Natterbox permissions sets (Administrator and User) should also be assigned.

Furthermore, depending on the routing policies configured and desired call logging, modify access to the following objects is strongly recommended:

  • Account

  • Contact

  • Case

  • Lead

  • Opportunity

  • Task

Should any queries or DML be configured within the routing policies, the API user must also have access to the fields specified.

When making any future changes, it is important to note the custom permission limitations setup and impact this could have. Any changes are strongly recommended to be tested in a sandbox environment first

Why Customise Application?

We use Salesforce Protected Custom settings for our API operation to store sensitive information and the API user will need modify access. Modify custom settings options is available for users with "Customize application" permission only.

Steps to Reauthorise

  1. The support agent will request you to provide them with the name and email address of a Salesforce Administrator user within your Org.
    Note: It would be beneficial and expedite the process if this user is also a Natterbox Administrator.

  2. Once you have provided this information, the support agent will proceed to request the reauthorisation of the Salesforce Administrator as your Data Connector user.

  3. The subsequent steps will need to be carried out by the designated Salesforce Administrator.

    1. They will receive an email from Natterbox, which will prompt them to authorise the Natterbox Platform to connect to their Natterbox App in Salesforce.

    2. Kindly advise the Salesforce Administrator to check their spam, junk, or similar email folders if they do not find the email from Natterbox.

    3. From the email, they will need to click the "Authorise" button or copy and paste the URL link provided at the bottom of the email into their browser.


    4. A separate page will open from Salesforce to confirm authorisation. Users are required to click the "Allow" button, which is highlighted in blue.


    5. Upon completion, the user should receive a notification confirming the successful authentication.

  4. The subsequent steps must be carried out by a Natterbox Administrator.

    1. The user needs to navigate to the Admin Home tab within the Natterbox App in Salesforce.

    2. Within the "Admin Home" tab, users should navigate to the "System and Security" section and locate the "Scheduled Jobs" option.


    3. It is necessary to restart each scheduled job individually. This can be accomplished by selecting the blue "Stop Job" button adjacent to each scheduled job. This action will halt the selected scheduled job.
      Note: Each scheduled job will need to be stopped and started one at a time going down the list. Please only restart each scheduled job that is currently running.

    4. The user will need to wait for approximately 10-15 seconds and then click on the button labeled "Start Job". This process should be repeated for each scheduled job individually.