Connecting to Gmail by using the Chrome extension
Pega Sales Automation provides a Pega for Google Chrome extension so that you can boost sales productivity and increase the efficiency of the entire sales process. As a Gmail user, you no longer have to leave Pega Sales Automation in order to see Gmail insights in your explorer view.
The Pega for Google Extension supports the following features:
- Single sign-on (SSO) – after you log in to the extension side panel for the first time, you can access it from any other device, without reentering your login credentials.
- Pinnable task pane – when you switch between messages, you can leave the extension side panel open in your mailbox.
Use the Pega for Google Chrome extension to perform the following actions:
- Search, open, and display Pega Sales Automation leads, contacts, opportunities, organizations, and accounts.
- Associate emails or appointments with contacts, leads, opportunities, organizations, and accounts.
- Create contacts, leads, opportunities, activities, and tasks.
The Pega for Google Chrome extension has the following limitations:
- The integration of attachments in Google Calendar is not supported.
- Replies using templates are not supported for calendar events.
- Calendar events cannot be related to any sales entities before the initial save or send.
- The Gmail extension works with Microsoft Windows and Mac Chrome browsers only, and is valid only for G Suite accounts. The extension does not work with personal accounts.
Installing the Pega for Google Chrome extension
The Pega for Google Chrome extension is available in the Chrome Web Store.
- In your Chrome web browser, go to the Chrome Web Store and search for the Pegasystems extension.
- Click Add to Chrome.
- Choose how you want to install the extension.
- For Microsoft Windows users, you can update the Chrome policy in the Extension Settings or Individual Policy (ExtensionInstallForcelist). The Extension Settings policy overrides the Individual Policy. For more information, refer to the suggested articles in the Google Chrome Enterprise Help documentation listed above.
- For Mac users, to update the policy, use the mcxpreference setting in the configuration profile, or individual policy plist settings in the managed preferences. For more information about how to install extensions for multiple users and Google Chrome policy management, see the ExtensionInstallForcelist section in the Policy List article on The Chromium Projects website.
- Optional: If you are a Google administrator, you can install the Pegasystems extension for multiple users by searching for Automatically installing apps and extensions or managing extensions in your enterprise in the Google Chrome Enterprise Help documentation. For more information, search for Chrome policy management in the Google Chrome Enterprise Help documentation.
Configuring Google Identity services
After you configure the extension points, you must configure Google Identity services.
- In your browser, open https://console.developers.google.com and log in as an administrator.
- Click .
- Select an existing project or create a new project, and then open it.
- In the navigation pane, click Library, and then search for and enable Gmail API and Calendar API.
- Click Credentials, and then click .
- Optional: To configure the consent screen on a first-time login, perform the following
steps:
- Choose the application type.
- Add the following scopes:
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
https://www.goodleapis.com/auth/gmail.labels
If the scope is set to public, then these scopes are validated by the Google team to verify client IDs.
- In the Authorized domains field, enter your private domain.
- Add your organization's homepage and privacy policy links.
For a public application type, this information goes through a verification process.
- Save the form and click Submit.
- On the OAuth client ID page, perform the following
steps:
- Select the Web application type.
- Enter the name of your application.
- Enter the authorized JavaScript origins and authorized redirect URLs.
- Click Save.The system generates the client ID and client secret code. Copy these details for use in further configuration.
Configuring Pega Sales Automation on premises
Configure Pega Sales Automation to use the Chrome extension.
- In the User portal, from the Explorer panel, select Administration.
- Go to Google Integration, and select either the Default or Custom (SSO) authentication type
- In the Google client ID field, paste the client ID that you generated as part of the "Configuring Google Identity services" procedure, and then click Save.
- In Dev Studio, ensure that the D_LoadAuthorizationConfig
data page has the same client ID as the GoogleClientID
dynamic system setting.If the client ID is not the same, remove this data page and start again from the "Configuring Google Identity services" task.
- In Dev Studio, add the GmailExtension portal to the available portals list.
- Depending on the authentication type that you use, perform one of the following
actions:
- If you use the default authentication type, add the following servlet
entry to the
web.xml
file to support the Google Identity sign-in process.<servlet> <servlet-name>GmailExtension</servlet-name> <display-name>GmailExtension</display-name> <description>Internet Application Composer, using custom authentication techniques</description> <servlet-class>com.pega.pegarules.internal.web.servlet.WebStandardBoot</servlet-class> <init-param> <param-name>PegaEtierClass</param-name><!--COMPONENTS:This was previously com.pega.pegarules.services.HttpAPI --> <param-value>com.pega.pegarules.session.internal.engineinterface.service.HttpAPI</param-value> </init-param> <init-param> <param-name>AuthenticationType</param-name> <param-value>PRCustom</param-value> </init-param> <init-param> <param-name>RuntimeServletName</param-name> <param-value>GmailExtension</param-value> </init-param> <init-param> <param-name>AuthService</param-name> <param-value>GmailExtensionService</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>GmailExtension</servlet-name> <url-pattern>/GmailExtension</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>GmailExtension</servlet-name> <url-pattern>/GmailExtension/*</url-pattern> </servlet-mapping>
- If you are using the custom authentication type, perform the following steps:
- In the header of Dev Studio, search for and select the
GmailExtension.js
text file, and then find the following lines inside the file:var snapstartURL = prpcURL.concat("/prweb").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser"); var clientURL = prpcURL.concat("/prweb").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser&outlookWO=" +insHandle);
- Add your custom servlet to each line, as shown in the following
example:
var snapstartURL = prpcURL.concat("/prweb/SSO").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser"); var clientURL = prpcURL.concat("/prweb/SSO").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser&outlookWO=" +insHandle
- Click Save.
- In the header of Dev Studio, search for and select the
- If you use the default authentication type, add the following servlet
entry to the
Configuring Pega Sales Automation for Pega cloud
Configure Pega Sales Automation to use the Chrome extension.
- In the User portal, from the Explorer panel, select Administration.
- Go to Google Integration, and select either the Default or Custom (SSO) authentication type, and then click Save.
- In the Google client ID field, paste the client ID that you generated as part of the "Configuring Google Identity services" procedure, and then click Save.
- In Dev Studio, ensure that the D_LoadAuthorizationConfig
data page has the same client ID as the GoogleClientID
dynamic system setting.If the client ID is not the same, remove this data page and start again from the "Configuring Google Identity services" task.
- In Dev Studio, add the GmailExtension portal to the available portals
list.The Pega Sales Automation configuration process for Pega Cloud services is different from the process without Pega Cloud services:
- Do not add a servlet manually in the
web.xml
file because Pega Cloud services already adds the servlet. - To find the servlets, in the header of Dev Studio, click .
- Do not add a servlet manually in the
- In the header of Dev Studio, search for and select the
GmailExtension.js
text file, and then find the following lines inside the file:var snapstartURL = prpcURL.concat("/prweb").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser"); var clientURL = prpcURL.concat("/prweb").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser&outlookWO=" +insHandle);
- Add your custom servlet to each line, as shown in the following example:
var snapstartURL = prpcURL.concat("/prweb/SSO").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser"); var clientURL = prpcURL.concat("/prweb/SSO").concat("?pyActivity=").concat("Data-Portal.OutlookViewInBrowser&outlookWO=" +insHandle
- Click Save.
Configuring extension points
Configure the extension points to finalize the process of connecting to Gmail.
- In App Studio, click on Resources, in the upper right-hand corner, and select Complete your setup.
- Select MLP guide.
- In the "Connect to Gmail by using the Chrome extension" section, click on the Generate Gmail URL button.
- Copy the Gmail URL. The Gmail URL is your Environment URL required later in this procedure.
- Open Chrome, and then open the Pega for Google extension.When you open the extension for the first time, the system displays the configuration panel.
- Choose either the Default or
Custom authentication type.
Default authentication uses Google Identity services to log in. After you log in with your credentials and approve the terms and conditions, your Google account is associated with your Pega user account.
Custom authentication is recommended for enterprise purposes.
- In the Environment field, enter your Environment URL (the Gmail URL) that you copied from App Studio in step 4.
- Leave the Enable verbose logs check box cleared.
- Optional: To configure authentication settings for multiple users, perform the following
steps:
For Microsoft Windows users, push registry entities by using the graphics processing unit (GPU).
For more information, refer to the Configuring Apps and Extensions by Policy topic in the documentation for administrators on The Chromium Projects website.
For Mac users, use the plist file or a configuration profile. Add the following code to the plist file:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" ""http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>com.google.Chrome.extensions.acbnognkfggkichjogfmienjabfhedac</key> <dict> <key>authdetails</key> <dict> <key>state</key> <string>always</string> <key>value</key> <dict> <key>auth_type</key> <string>Default/Custom</string> <key>url</key> <string>https://****.***.pega.com/prweb</string> </dict> </dict> </dict> </dict> </plist>
For more information about getting started with Chrome browser on Mac, see the documentation provided in the Google Chrome Enterprise Help.
Previous topic Configuring ON24 Platform integration Next topic Configuring DocuSign