Setting up the Salesforce Go Integrator Plugin - (REST API Version)

Setting up the Salesforce Go Integrator Plugin - (REST API Version)

Introduction

This document will guide the Salesforce Administrator through creating the API Connections so that their end users may use the Go Integrator app to connect their phone service with Salesforce.  These instructions will show both Lightning and Classic UI configurations. 

OAUTH Configuration

A Domain Name and "Connected App" must be configured or already exist in Salesforce. The following sections P1 – P4 describe the specific steps to fulfill the requirements for OAuth. Please read the following carefully as you may not need to follow each step. If you are unsure how to proceed, please consult with your Salesforce Administrator.

  1. -If your Salesforce account has a domain, go straight to "P2".
  2. -If the Domain and Connected App already exist, you can verify this information in section "P3".

P1 - Creating a Domain Name in Salesforce

  1. Log into your Salesforce account, and open the "Setup" menu. Search for "Domains" in the Quick Find Box, then select My Domains.

  2. Enter the Domain Name you want to use, and press "check availability", and then register.
  3. Your domain should be emailed to you shortly after.

P2 - Creating a Connected App

  1. In Salesforce Classic - Log into your Salesforce account, and open the "Setup" menu. Click on Build > Create > Apps, then at the bottom of the page, under "Connected Apps", press "New".


  2. In Salesforce Lightning - Log into your Salesforce account, and open the "Setup" menu. In the quick find box, enter "App" and then select "App Manager". Click "New Connected App".


  3. Enter a Connected App Name, API Name, and Email address for your app.
    1. Connected App Name: PressONE Integrator
    2. contact email: helpdesk@pressone.net
    3. contact phone: +1 718 360 1234
    4. Logo Image URL: https://pressone.net/wp-content/uploads/2023/07/apple-icon-120x120-1.png
    5. Icon URL: https://pressone.net/wp-content/uploads/2023/07/favicon-16x16-1.png




  4. Tick the "Enable OAuth Settings" option.
  5. Tick "Enable" for Device Flow.
  6. Add Callback URL as :https://login.salesforce.com/services/oauth2/success
  7. Under Available OAuth Scopes, bring over
    1. "Manage user data via APIs (api)"
    2. "Perform requests on your behalf at any time (refresh_token_offline_access)"


P3 -  Retrieving existing Consumer Keys (Client ID)

  1. In Salesforce Classic-Log into your Salesforce account, and open the "Setup" menu. Click on Build > Create > Apps, then at the bottom of the page, under "Connected Apps", click on your Connected App.
  2. In Salesforce Lightning-Log into your Salesforce account, and open the "Setup" menu. In the quick find box, enter "App" and then select "App Manager". Find your app, and press the drop down arrow and then "view".
  3. Here you will see "Consumer Key" under "API (Enable OAuth Settings)" tab.
The Rest of the Integations instructions can be found once you install the Go Integrator Nava Application  when clicking the "help" button in the CRM configuration.  Please find those instructions and the user Manual for the application here: https://help.nava.gointegrator.com/help?version=4.2&lang=uk&item=1184