Skip to main content
Skip table of contents

Salesforce Chatter

Partner Setup

Salesforce uses OAuth 2 for remote API access. You must register Cyclr within Salesforce as your own Connected App to receive OAuth Client ID and Client Secret values to enable Cyclr to authenticate with Salesforce.

The official Salesforce documentation for creating a Connected App can be found here.

Salesforce set up - Register Your Application

Introduction

You can register for a free Salesforce developer account or log into your existing Salesforce account if you have one. You can use any Salesforce account to create a Connected App. It doesn't have to be a developer account.

Create your App within Salesforce:

The steps below are for Salesforce Classic. Settings are similar for Lightning Experience.

  • Log into the Salesforce account

  • click Setup in the top right

  • from the side menu down the left, under the Build heading click Create

  • choose Apps

  • from the Connected Apps table click the New button

When the New Connected App screen is shown, complete the form as follows:

Basic Information

Connected App Name: enter a name for your application

API Name: this will default to the same value as your Connected App Name

Contact Email: your email address

API (Enable OAuth Settings)

Tick the Enable OAuth Settings box to display further options.

Callback URL: you must add a callback URL to allow Salesforce to be used in your Cyclr Console and its accounts.

The URL is:

Selected OAuth Scopes: you must add the following 2 Scopes to enable Cyclr to use your App:

  • Full access (full)

  • Perform requests on your behalf at any time (refresh_token, offline_access)

The OAuth settings should look like this:

After saving your App, make a note of your Consumer Key and Consumer Secret values as you'll need to enter these into Cyclr.

Cyclr Salesforce Chatter Connector Set up

Set up Salesforce Chatter within Cyclr:

  • Go to your Cyclr Console

  • Click the Connectors menu along the top

  • Choose Connector Library

  • Scroll down to Salesforce Chatter

  • Click the Setup button

Enter the following values:

Client ID: the Consumer Key of your Salesforce Connected App

Client Secret: the Consumer Secret of your Salesforce Connected App

Instance URL: This is the url of your Salesforce server instance e.g. "https://mysalesforce.com"

Is Sandbox: Set this to "true" if you wish to test the connector against a sandbox instance of Salesfoce

Your Salesforce Chatter Connector is now set up! You can test it by installing it in one of your Cyclr accounts and executing one of the methods to confirm it can return some data.

Expired access/refresh token errors

Salesforce only allows up to five unique access/refresh token pairs to be issued for each user in a Connected App. Older tokens will be automatically revoked by Salesforce. More information.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.