Installing & Connecting Cloudingo
  • 29 Aug 2023
  • 7 Minutes to read
  • PDF

Installing & Connecting Cloudingo

  • PDF

Article summary

Getting started with Cloudingo:

  1. Install the Cloudingo Agent from the Salesforce AppExchange.
  2. Create an account at cloudingo.com.
  3. Connect Salesforce to the Cloudingo account.
Note:
  • The Salesforce profile must have admin-level access with full read/write/update/delete permissions for the objects (standard, related, and custom) and all fields within those objects that the Cloudingo user will be working with. 
  • ‘View All’ and ‘Modify All’ access is also required.  If these permission requirements aren't met, Cloudingo will not be able to select field values for merging, which can result in potential data loss.


Step 1: Install the Cloudingo Agent

  1. Find the Cloudingo Agent at the Salesforce AppExchange here and follow the installation instructions.
    1. Make note of which users will be connecting using their own credentials. Also, make note of their respective Salesforce profiles assigned.
    2. During the installation process, choose the appropriate profiles when prompted. Choose all profiles for all users that will be connecting using their own credentials. Shared connections or single-user connections need to choose the profile for the Admin user connecting. Trial users will only have single-user login during the trial.


Step 2: Create a Cloudingo Account




  1. Go to the Cloudingo registration form here.
  2. Fill out the form to create an account.


Step 3: Login and Connect Cloudingo to Salesforce

login page

 
For Administrators:

  1. Log in to Cloudingo using the email used to register the account.
    1. If the password has been forgotten, reset the password here.
  2. If not already connected, use the 'Salesforce Account' option at the top left corner of the dashboard and choose 'Add Account'.
  3. Provide the connection with a display name (ex: Production or Sandbox).
  4. Use the 'Login with Salesforceoption and enter the desired Salesforce credentials to establish the connection.
    1. Ensure that the main user has appropriate Salesforce permissions.


For Secondary Users:

  1. An email will be sent to new users created by the Cloudingo administrator. Check the email for instructions from Cloudingo.
    1. Follow the instructions to activate the login and set up a password.
      1. Login to Cloudingo using the Cloudingo username and password. Do not use the ‘Login with Salesforce’ option yet.
    2. If the Cloudingo administrator set up Cloudingo to use individual connections:
      1. Choose the 'Salesforce Account' option at the top left.
      2. Choose the down arrow to expand the connection.
      3. Choose 'Change your Salesforce login'.
      4. Choose 'Change Login'. 
      5. Use the 'Login with Salesforce' option to connect using individual Salesforce credentials.
        Note:
        If this option is not available, no action is necessary. The admin configured Cloudingo to use a shared connection. When using a shared connection, use the Cloudingo login at the login page instead of 'Login with Salesforce' option for future logins.


Step 4. Initial Indexing

Cloudingo will index the org data and field schema and then generate a dashboard of default filters showing the results of the initial duplicate scan.

Note:
No changes are being made to the data at this point.


Step 5. Use Existing Filters or Create New Ones

Use prebuilt filters from Cloudingo or create new ones.



Step 6. Set up Rules for Merging Records

Set up rules defining the master record selection and field value choices based on business requirements.



Step 7. Automate Jobs and Set Filters to Run on a Schedule

Start automation manually or use schedules to process merges. Make sure to preview results for accuracy before automating.



Troubleshooting Connection Problems

  1. Check if Cloudingo is installed in Salesforce.
    1. In Salesforce: 'Setup' → search for ‘Installed Packages'.
    2. If Cloudingo Agent is not listed, install the app from the Salesforce AppExchange.
  2. Make sure to use the same credentials used to log in to Salesforce.
  3. Make sure the connecting user has the appropriate Salesforce permissions. See below for permission requirements.
  4. Based on the Salesforce org’s security settings, whitelisting Cloudingo's IP ranges may be required. Note: The org's security settings determine if IP ranges need to be whitelisted. Consult with the Salesforce administrator for your organization if unsure.
    1. In Salesforce: 'Setup' → 'Security Controls' → 'Network Access' → 'Trusted IP Ranges'.
    2. Click the ‘New’ button.
    3. Enter the following under ‘Trusted IP Ranges’: Starting IP Address 169.61.150.226 to Ending IP Address 169.61.150.238.
    4. In some cases, whitelisting the IP range under the user’s profile is necessary as well.
      1. For more information, here is the full help article.
  5. If using a custom URL for Salesforce, configure it in Cloudingo to auto-redirect. Cloudingo will auto-populate the URL if left blank when the connection is successful. Blank out the custom URL if it has changed and re-connecting is failing. Then, try connecting again.
  6. Apex classes must be enabled for the Cloudingo user's Salesforce profile:
    1. In Salesforce:  'Setup' 'Manage Users' 'Users'.
    2. Choose the Profile link for the Cloudingo user.
    3. Select Edit for Apex Classes.
    4. Select any classes beginning with 'Cloudingo' on the left side (disabled classes) and move them to the right to enable them.
    5. Save the changes and retry the previous actions to see if the problem is resolved.


Salesforce Permission Requirements

Connected users' profiles must have admin-level permissions and meet the following requirements:

  1. Full read/write/update/delete permissions to the standard objects, related objects, and any custom objects (if applicable).
  2. Update access to all fields within those objects.
  3. 'View All' and 'Modify All' access on the objects.
  4. Access to all Cloudingo Apex Classes (assigned during the installation of the Cloudingo agent).
Warning:
If the profile does not have the required permissions, Cloudingo will be unable to select field values for merging, which can result in potential data loss.


Connecting to Additional Orgs

  1. Cloudingo licenses allow for one Production and one Sandbox connection to be connected simultaneously within the same Cloudingo Account.
    1. To add more than one Sandbox or Production instance, contact your Cloudingo Account Representative (contact@cloudingo.com).
  2. To add a second connection
    1. Install Cloudingo to the org.
      1. When installing to a Sandbox from AppExchange, enter the Production credentials first. Then, choose the Sandbox for the environment to be installed.
    2. Log in to Cloudingo and add the new connection.
      1. Choose the 'Salesforce Account' option in the left-hand navigation options.
      2. Choose 'Add Account'.
      3. Give the connection a display name (such as "Production" or "Sandbox").
      4. Choose the 'Login with Salesforce' option to enter in the Salesforce credentials to the org being connected.
        Note:
        The 'Use token instead' option should only be used if advised to do so by our Support Team.
  3.  When the connection is successful, the indexing process will begin. Once indexing is complete, the dashboard will display standard filters.
    1. If the connection fails, refer back to the connection troubleshooting steps above.
  4. Toggle between the two environments using the checkbox.
  5. Choose the 'Make Default Account' link to default the desired connection for future logins.



Broken Connections

  • If a connection is broken, errors will display on the main dashboard with a red dot next to the 'Salesforce Account' icon (top left navigation icon).

    image

    1. “Invalid Account Credentials” or some other error alert will show as an alert in the Salesforce Account → Platform details.
    2. “Cloudingo Agent is not installed” may appear on the main dashboard.
    3. If errors appear, the connection failure to Salesforce has occurred and re-authentication is required. Some reasons for disconnect are:
      1. General communication errors.
      2. The connected user was deactivated in Salesforce.
        1. If the deactivated user is also set as the only (or the main) user, and no other users have a login to Cloudingo, contact Cloudingo Support.
      3. The Cloudingo agent may have inadvertently been uninstalled.
      4. The org has been refreshed (Sandboxes).

To Reconnect Production

  1. Log in to Cloudingo using the Cloudingo username & password instead of ‘Login with Salesforce’.
    1. Use the forgotten password link on the main cloudingo.com login page if the password is not known.
  2. Choose ‘Salesforce Account’ → ‘Edit Salesforce Account’ → ‘Edit Account’. Make sure to choose the appropriate environment (Production vs. Sandbox).

    3. Use the ‘Login with Salesforce’ option to enter the desired credentials.
    1. If the using the same credentials as the previously connected user, log in to Salesforce and verify the agent is installed (see troubleshooting steps above for connectivity issues).
    2. If the previously connected user has been deactivated in Salesforce, assign a new Admin to establish the connection.

To Reconnect Sandbox

  1. Log in to Cloudingo.
  2. Choose ‘Salesforce Account’ → ‘Edit Salesforce Account’. Make sure to choose the appropriate environment (Sandbox vs. Production).

  3. Choose the ‘Update Sandbox after Refresh’ option.
    1. If the username & URL are not changing (this is a straight reconnect to the same Sandbox using the same credentials), use the ‘Log in with Salesforce' button to re-enter the Sandbox credentials.
      Once the connection is successful, the Account should begin reindexing.

    2. If the connection username and/or Sandbox URL are changing from what was previously connected, choose the 'My Sandbox was refreshed and has a new login URL' option.
      1. Enter the correct username & hit next.
        1. If the main portion of the username domain is changing, this is hardcoded and cannot be updated manually. Contact Support to have it updated.
      2. Choose the 'Log in with Salesforce' option.
        1. If the custom URL is changing, choose the 'Use Custom Domain' (link at the bottom right of the login box). Enter the new custom URL & continue.
      3. Enter the Sandbox credentials. Once the connection is successful, the Account should begin reindexing.

Note:
  • If the connection is successful, the indexing process begins.
  • If the connection fails, refer back to our troubleshooting steps.
  • Production environments are not interchangeable. To switch the connection to a new Production instance, contact your Cloudingo Account Representative or contact@cloudingo.com.
  • Sandbox environments are interchangeable and can be swapped out with other Sandboxes.
    • If the Salesforce username/domain's main portion changes, contact Support. This will have to be rectified on the Cloudingo server side.
Warning:
Filters and Rules will be retained when switching Sandbox connections. Filter or rule errors can happen if the field schema is not the same in both environments. Modify any filters or rules and apply changes with fields available in the new Sandbox.

Was this article helpful?

What's Next