Integrate Yeastar P-Series PBX System with Salesforce CRM
This topic describes how to integrate Yeastar P-Series PBX System with Salesforce CRM.
Prerequisites
- You have configured network for remote access by a Yeastar FQDN.
- Only a system administrator of a Salesforce CRM account can enable the Salesforce CRM integration.
Procedure
Step 1. Get PBX authentication information
Step 2. Create and configure an application on Salesforce CRM
Step 1. Get PBX authentication information
- Log in to PBX web portal, go to
- In the Network section, take note of the
Callback URL as you will use it later on
Salesforce CRM.Note: The Homepage URL displays the FQDN domain name of your PBX, which is used to compose the Callback URL.
Step 2. Create and configure an application on Salesforce CRM
- Log in to Salesforce CRM.
- On the top-right corner of the Salesforce page, click
, then click Setup to enter the Setup Home page.
- On the left navigation bar, go to .
- On the top-right corner of the App Manager page, click
New Connected App to create a new application for
integration.
- In the Basic Information section, complete
the following settings.
- In the Connected App Name field,
enter a name to help you identify the application.
The API Name is synchronized with the application name automatically.
- In the Contact Email field, enter a contact email address.
- Fill in other information as needed.
- In the Connected App Name field,
enter a name to help you identify the application.
- Scroll down to API (Enable OAuth Settings)
section to complete the API configuration.
- Select the checkbox beside the Enable OAuth Settings.
- In the Callback URL field, paste the Callback URL obtained from the PBX web portal.
- In the Selected OAuth Scopes section,
select the following permission options from
Available OAuth Scopes box to
Selected OAuth Scopes box.
- Full access (full)
- Manage user data via APIs (api)
- Manage user data via Web browsers (web)
- Access unique user identifiers (openid)
- Access the identity URL service (id, profile, email, address, phone)
- Perform requests at any time (refresh_token, offline_access)
- Scroll down to the bottom of the page, click
Save.
The web page prompts that the change may take up to 10 minutes to take effect.
- Click Continue.
- In the Basic Information section, complete
the following settings.
- Grant the application access permission for all Salesforce users related to this
Salesforce organization.
- Go to
beside the new connected application, then click Manage.
, click - In the detail information page of the application, click Edit
Policies.
- Scroll down to the OAuth Policies, select
All users may self-authorize from the
drop-down list of Permitted Users.
- Click Save.
All Salesforce users related to this Salesforce organization can use the application.
- Go to
- Obtain the Authorization information of Salesforce CRM as you will use it later
on PBX.
- Go to
beside the new connected application, then click View.
, click - Scroll down to API (Enable OAuth Settings)
section, obtain the API Authorization information.
- Consumer Key: Click Copy to take note of the Consumer Key.
- Consumer Secret: Click Click to reveal, then click Copy to take note of the Consumer Secret.
- Go to
Step 3. Make Authorization Request to Salesforce CRM
- Go back to PBX web portal, go to .
- In the Authorization section, enter the API
authorization information.
- Consumer Key: Paste the Salesforce API Consumer Key.
- Consumer Secret: Paste the Salesforce API Consumer Secret.
- Click Save.
A new browser page will be launched to request for Salesforce CRM data access permission.
- Click Allow to allow the PBX to access data in your CRM account.
If the authorization succeeds, the web page will display Authorization succeeded!.
- Go back to the PBX configuration page, a pop-up window also displays the
authorization result. Click OK to confirm.
The Status field displays Connected, indicating that the Salesforce CRM integration is successfully set up.
Step 4. Associate Salesforce CRM users with PBX extensions
- On the CRM integration page, click
beside the Salesforce User to synchronize the latest list of Salesforce CRM users.
- Associate the Salesforce users with PBX extensions.
- Associate automatically
-
- Click the Associate Automatically button.
- On the pop-up window, click OK.
- Click Save.
The Salesforce users and PBX extensions that share the same email address will be matched and associated with each other automatically.
- Associate manually
- If a user binds different email addresses to his or her
Salesforce account and PBX extension, you need to manually
associate the user's Salesforce user account and PBX
extension.
- In the Extension drop-down list beside the Salesforce user, select the user's extension.
- Click Save.
Note: If users in the organization have been changed, clickto refresh the Salesforce user list, and re-assign extensions.
Result
Once integration is enabled by the Salesforce system administrator, the integration is activated for all users.