All Collections
Developer Guide & Integrations
Integrations
Waitwhile Salesforce Integration Setup Guide
Waitwhile Salesforce Integration Setup Guide

How to connect Waitwhile with Salesforce.

Chris Klemming avatar
Written by Chris Klemming
Updated over a week ago

Salesforce integration is currently only provided on the Waitwhile Enterprise plan.

Waitwhile's CRM integration with Waitwhile offers some very powerful capabilities:

This guide will walk you through the necessary steps to integrate Waitwhile with your Salesforce instance.

Overview of setup

The setup consists of four steps:

  1. Create a connected app

  2. Create an integration user

  3. Create a permission set

  4. Share info with Waitwhile to apply configuration

To complete the setup, you will require a certificate file from Waitwhile. Please reach out to Waitwhile support, and they will provide you with the necessary certificate file separately.

Note: These instructions assume that you are using the Salesforce Classic UI. If you are not in the Classic UI, you can switch by clicking on your profile and selecting "Switch to Salesforce Classic."

1) Create the connected app

  1. In Salesforce, go to “Setup”

  2. Go to “Build > Create > Apps” in the left-hand navigation

  3. Under “Connected Apps”, click “New”

  4. Fill in the following:
    Connected App Name: Waitwhile Integration
    API Name: Waitwhile_Integration
    Contact Email: support@waitwhile.com

  5. Check “Enable OAuth Settings

  6. Fill in the following:
    Callback URL: https://api.waitwhile.com/v2/oauth/callback

  7. Check “Use digital signatures

  8. Upload the certificate provided by Waitwhile by using “Choose file”

  9. Add the following scopes to “Selected OAuth Scopes”:
    Manage user data via APIs (api)
    Perform requests at any time (refresh_token, offline_access)

  10. Leave the other settings with default values. Verify that your configuration looks similar to this:

  11. Click “Save”

  12. Go to “Build > Create > Apps” in the left-hand navigation

  13. Under “Connected Apps”, click on “Waitwhile Integration”

  14. Click on “Manage Consumer Details”

  15. Save the value of the “Consumer Key”. You will need to share this value with Waitwhile. Do not share the value of the “Consumer Secret”; It is not needed.

  16. Go to “Administer > Manage Apps > Connected Apps” in the left-hand navigation

  17. Find “Waitwhile Integration” and click “Edit”

  18. Under “OAuth Policies”, set “Permitted Users” to Admin approved users are pre-authorized

  19. Click “Save”

2) Create an integration user

  1. Go to “Administer > Manage Users > Users” in the left-hand navigation

  2. Click “New User”

  3. Fill in the following:
    Last Name: Waitwhile
    Alias: WW
    Email: waitwhile@<organization>.<domain> (e.g. waitwhile@example.com)
    Username: waitwhile@<organization>.<domain> (e.g. waitwhile@example.com)
    Nickname: Automatically filled out by Salesforce
    User License: Salesforce Platform
    Profile: Standard Platform User

    Save the username. You will need to share this value with Waitwhile.

  4. Click “Save”

3) Create a permission set

  1. Go to “Administer > Manage Users > Permission Sets” in the left-hand navigation

  2. Click “New”

  3. Fill in the following:
    Label: Waitwhile Integration
    API Name: Waitwhile_Integration

  4. Click “Save”

  5. You should see an overview of the permission set. Click “Assigned Connected Apps”.

  6. Under “Assigned Connected Apps”, click “Edit”

  7. Add “Waitwhile Integration” to “Enabled Connected Apps”

  8. Click “Save”

  9. Click “Manage Assignments”

  10. Click “Add Assignment”

  11. Select the Waitwhile integration user and click “Next”

  12. Click “Assign”

Note: The above user profile and permission set are a simple suggestion to get started quickly. You can manage the permissions in line with your policy. Preferably the user should be as restricted as possible and only have access to the data you intend to display in Waitwhile.

4. Share info with Waitwhile to apply configuration

  1. Go to “Administer > Domain Management > My Domain” in the left-hand navigation

  2. Save the value of “Current My Domain URL”. You will need to share this value with Waitwhile.

  3. Go to “Build > Develop > API” in the left-hand navigation

  4. Under “Enterprise WSDL”, click “Generate Enterprise WSDL”

  5. At the top of the generated file, you should see a line similar to “Salesforce.com Enterprise Web Services API Version 59.0”. Save the API version number. You will need to share this value with Waitwhile.

Share the following information with your Waitwhile account manager or partner:

  • Connected App Consumer Key

  • Integration User Username

  • Current My Domain URL

  • API Version Number

Waitwhile will create the necessary configuration to set up the connection!

Did this answer your question?