Integration with Salesforce

Overview

MangoApps allows integration with Salesforce to provide access to sales opportunities within the CRM module. This integration enhances collaboration by synchronizing opportunity data from Salesforce and displaying it in MangoApps, where users can interact with and manage the data securely and efficiently.

Required Roles

To successfully configure the integration:

• Salesforce Admin Access is required to create and manage the Connected App.

• MangoApps Network Admin Access is required to configure the CRM module and complete the connection on the MangoApps side.

• Any non-admin Salesforce user involved in the setup must have appropriate API access permissions.

Salesforce Side Setup

Begin by logging in as a Salesforce admin and follow these steps to create a Connected App.

Navigate to: Apps > App Manager

Click New Connected App and select Create a Connected App.

Enter:

• App Name (API Name auto-generates)

• Contact Email

• (Optional) Upload logo images

Check both Enable OAuth Settings and Enable for Device Flow.

The Callback URL will auto-generate.

Assign OAuth Scopes

Add these permissions:

• custom_permissions

• sfap_api

• id, profile, email, address, phone

• full

• api

• web

• refresh_token, offline_access

Security Settings

Check all following:

• Require PKCE Extension

• Require Secret for Web Server Flow

• Require Secret for Refresh Token Flow

• Enable Client Credentials Flow

• Enable Authorization Code for Credentials Flow

• Enable Token Exchange Flow

• Require Secret for Token Exchange Flow

Save the app (it may take up to 10 minutes to take effect) and verify that the information on the details page is correct.

Access Consumer Key & Secret

Go to Apps > App Manager

Locate the app and click Manage Consumer Details

Complete the authorization step to view and copy the Key and Secret.

Next we will Authorize User Access for the new app.

Go to Apps > Connected Apps > Manage Connected Apps

Select the app and Edit Policies

• Permitted Users: All users may self-authorize

• IP Relaxation: Relax IP restrictions

• Refresh Token Policy: Refresh token is valid until revoked

Enable User Provisioning

Once user provisioning has been enabled, you will see a new section named User Accounts. In this section, click New User Account to add users.

After adding users, the provider side configuration setup is complete.

Before we move on to the MangoApps side of the setup, we will need the user Token ID.

To find this Token ID, we need to visit the provisioned user's profile.

Click the Settings link from the top right hand profile dropdown menu while logged in as that user.

Go to Profile Settings > Reset My Security Token

The Token will be emailed to the user.

MangoApps Side Setup

In MangoApps, complete the connection by navigating to: Admin Portal > Modules > CRM

Ensure the CRM module is enabled and click Module Settings

In the Setup Tab, select Salesforce as the provider from the dropdown menu.

Fill in the form with the following details:

• Web Services URL: Enter the URL of your Salesforce organization (e.g., https://yourdomain.my.salesforce.com).

• Username and Password: Use the credentials of the Salesforce user account that will be used for the integration.

• Security Token: Enter the security token generated for this user (received via email after clicking "Reset My Security Token").

• Consumer Key and Secret: Paste the key and secret obtained from the Salesforce Connected App setup.

Enable the checkbox labeled “Cache data in MangoApps” to store synced opportunity data locally for faster access.

Click Test Connection. If successful, click Save Settings. Opportunities from Salesforce will now auto-populate in MangoApps.

For manual sync, use the Synchronize button. Make sure to verify synced data under the All Opportunities tab

Testing Considerations

• Wait 10 minutes after creating the Connected App in Salesforce before testing.

• Use a valid user account with confirmed API permissions and an active security token.

• After saving the MangoApps integration settings, verify data is syncing under All Opportunities.

• If sync fails, recheck OAuth scopes, user access permissions, and credentials.

Security Considerations

• OAuth Scopes and Secret-based flows ensure secure authentication and access.

• Token exchange and PKCE enforcement protect against token interception.

• Only authorized users should have access to manage or view the app in Salesforce.

• MangoApps does not store raw credentials—only encrypted tokens for API access.

End User Experience

Once the integration is complete, users can navigate to the CRM Module > Opportunities in the MangoApps User Portal.

In the Opportunity detail view:

• A right-hand widget shows key details

• Clicking “See more details in CRM system” redirects users to Salesforce

Each user will see opportunities they are assigned to. Admins can assign users in MangoApps to opportunities from the Admin Portal > CRM > All Opportunities > Members Tab

Rollout Recommendations

• Pilot Test with a small group of users and key stakeholders

• Educate CRM users on how to view and navigate synced opportunities

• Confirm all OAuth scopes and tokens are valid and updated before broad rollout

• Monitor the initial sync logs for errors or access issues

• Gradually expand access by assigning users to opportunities via the admin portal