This integration is designed to synchronize data from Salesforce to OnePlan. It is currently unidirectional (Salesforce → OnePlan) and does not support write-back from OnePlan to Salesforce.
OnePlan Setup
Create an authentication key for this integration in OnePlan. For the steps to create a key, see How to Create and Rotate Authentication Keys in OnePlan. When you create the key, select the following settings.
Global Scopes — None required. Leave OData and Backup cleared.
| Data Type | Permissions |
|---|---|
| Configuration | Read |
| Plans | Read, Create, Update |
| Resources | Read |
| Integrations | All (Read, Create, Update, Delete) |
Note: Selecting Update or Delete also selects Read. The Integrations permissions allow OneConnect to add and remove the integration in OnePlan when it is installed or uninstalled. Grant only the permissions listed so the key has the minimum access the integration needs.
After you create the key, save the OnePlan group name and the authentication key in a secure location. You enter both in OneConnect during setup. The key cannot be viewed again after you leave the page.
Note: It is recommended to generate a new authentication key for every integration and to give each key a descriptive name that identifies its integration. This practice enhances security, simplifies management, and makes tracking and troubleshooting easier.
OneConnect Setup Process
To complete the OneConnect setup, you need have Administrator or Editor privileges in the OneConnect group you wish to set the integration up in.
- Go to https://my.oneconnect.ai (or https://eu.oneconnect.ai for European customers utilizing eu.oneplan.ai).
- Click on the Add Integration button.
- Navigate to Salesforce to OnePlan.
- Click on the tile.
Salesforce Connector
-
Username
- Enter the Username to be logged in as.
-
Password
- Enter the password.
-
Security Token
- Enter the Security Token generated within Salesforce.
-
Consumer Key
- Enter the Consumer Key generated within Salesforce.
-
Consumer Secret
- Enter the Consumer Secret generated within Salesforce.
-
Additional Options
- Expand the section for additional configuration options.
-
(Optional - Checkbox) Utilizing sandbox environment
- Sandbox (if checked) the login will push you to the Sandbox environment/interface.
-
Custom Object used for integration
- This will be the Object name to be brought over into OnePlan (Account, Opportunity, etc.).
-
Test Connection
- Click Test to verify the correctness of the connection settings to Salesforce.
- A notification indicating Connected Successfully should appear in the top-right corner of the browser upon successful testing.
-
Save Changes
- After verifying the connection, click Next to retain the configured settings.
OnePlan Connector
-
Group Name
- Input the name of the OnePlan Group name you intend to integrate with.
-
Authentication Key
- Paste the generated OnePlan Authentication Key obtained from OnePlan.
-
Additional Options
- Expand the section for additional configuration options.
-
(Optional) Alternate OnePlan Environment URL
- If using an environment other than the default (https://my.oneplan.ai), select the appropriate URL from the available options:
-
(Optional) OnePlan Default Plan Type
- Specify a default plan type if the integration doesn’t automatically provide a plan type for plan-level work items in OnePlan. Enter a single value for this purpose.
-
Test Connection
- Click Test to verify the correctness of the connection settings to OnePlan.
- A notification indicating Connected Successfully should appear in the top-right corner of the browser upon successful testing.
-
Save Changes
- After verifying the connection, click Next to retain the configured settings.
Comments
0 comments
Please sign in to leave a comment.