Integrate Yeastar P-Series PBX System with Salesforce CRM

This topic describes how to integrate Yeastar P-Series PBX System with Salesforce CRM.

Prerequisites

Procedure

Step 1. Get PBX authentication information

Step 2. Create and configure an application on Salesforce CRM

Step 3. Make Authorization Request to Salesforce CRM

Step 4. Associate Salesforce CRM users with PBX extensions

Step 1. Get PBX authentication information

  1. Log in to PBX web portal, go to Integrations > CRM > Salesforce.

  2. 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

  1. Log in to Salesforce CRM.
  2. On the top-right corner of the Salesforce page, click , then click Setup to enter the Setup Home page.

  3. On the left navigation bar, go to PLATFORM TOOLS > Apps > App Manager.
  4. On the top-right corner of the App Manager page, click New Connected App to create a new application for integration.
    1. In the Basic Information section, complete the following settings.
      1. 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.

      2. In the Contact Email field, enter a contact email address.
      3. Fill in other information as needed.
    2. Scroll down to API (Enable OAuth Settings) section to complete the API configuration.

      1. Select the checkbox beside the Enable OAuth Settings.
      2. In the Callback URL field, paste the Callback URL obtained from the PBX web portal.
      3. 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)
    3. 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.

    4. Click Continue.
  5. Grant the application access permission for all Salesforce users related to this Salesforce organization.
    1. Go to PLATFORM TOOLS > Apps > App Manager, click beside the new connected application, then click Manage.

    2. In the detail information page of the application, click Edit Policies.

    3. Scroll down to the OAuth Policies, select All users may self-authorize from the drop-down list of Permitted Users.

    4. Click Save.

      All Salesforce users related to this Salesforce organization can use the application.

  6. Obtain the Authorization information of Salesforce CRM as you will use it later on PBX.
    1. Go to PLATFORM TOOLS > Apps > App Manager, click beside the new connected application, then click View.

    2. 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.

Step 3. Make Authorization Request to Salesforce CRM

  1. Go back to PBX web portal, go to Integrations > CRM.
  2. In the Authorization section, enter the API authorization information.

  3. Click Save.

    A new browser page will be launched to request for Salesforce CRM data access permission.

  4. Click Allow to allow the PBX to access data in your CRM account.

    If the authorization succeeds, the web page will display Authorization succeeded!.

  5. 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

  1. On the CRM integration page, click beside the Salesforce User to synchronize the latest list of Salesforce CRM users.

  2. Associate the Salesforce users with PBX extensions.
    Associate automatically
    1. Click the Associate Automatically button.
    2. On the pop-up window, click OK.
    3. 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.
    1. In the Extension drop-down list beside the Salesforce user, select the user's extension.
    2. Click Save.
    Note: If users in the organization have been changed, click to 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.

What to do next