Skip to main content
Gainsight Inc.

Configure Product Requests

  1. Last updated
  2. Save as PDF 
Gainsight NXT

 

This article explains how admins can configure the Product Requests Feature for Customer Success Managers (CSMs) and Product Managers (PMs).

Overview

Customer Success Managers (CSMs) and Product Managers (PMs) can leverage Product Requests as a platform to collaborate and work on the enhancement requests received from customers.

The Product Requests consist of an Enhancement Request Form that CSMs can leverage to create the enhancement request and submit it to the Product Managers for approval.

For more information on the workflow of Product Requests, refer to the Product Requests Overview article.

To access the Product Requests:

  • Admins must create a connection between Gainsight and Productboard.
  • Admins must add the Product Requests to C360 Layout. For more information on how to add the C360 layout, refer to the Configure 360 Layouts article.

Create a Productboard Connection

Admins must create a connection between Gainsight and Productboard to add the Product Request layout to C360.

To create a Productboard connection:

  1. Navigate to Administration > Connectors 2.0.
  2. Click Create Connection. The Create Connection window appears.
  3. From the Connector dropdown, select Productboard.
  4. In the Name of the connection field, enter the connection name.
  5. In the Access Token field, enter the token details of the Product Board.
    Note: Admin must reach out to Product Management for the token details.
  6. Click Save. The Connection Successful message appears.
  7. Click Done. 
  8. Click the Jobs tab.
  9. Click the three-vertical dots that appear beside the created connection name.
  10. Click Edit. The Preparation tab appears.
  11. Click Configure. The Configure tab appears.
  12. Configure the Job schedule. To configure the job schedule, refer to the Configuration of Job or Job Chain Schedule article.

Screenshot 2023-11-30 at 8.29.15 PM.png

Add Product Requests to C360 Layout

After the Productboard connection is established, admins must add the Product Requests tab to the C360 layout.

For more information on how to add a C360 layout, refer to the Configure 360 Layouts article.

Modify an Enhancement Request Form

Gainsight provides a standard Enhancement Request Form for CSMs. Admins can work with Product Managers to modify the form according to their needs. This helps the Product Managers to make informed decisions for their Products.

To modify the enhancement request form:

  1. Navigate to Administration > Product Requests.
  2. (For the first time configuration)
    1. The Create Connection tab appears with Connection Established message.
    2. Click Next. The Add Product Requests to C360 Layout tab appears.
    3. Click Complete. The Enhancement Requests Form appears.
  3. Drag and drop the fields from the Fields section into the Canvas section.
  4. (Optional) Hold and drag the added fields in the canvas section to arrange the fields.
    Note: The following are the standard fields that cannot be edited or deleted.
    • Company
    • Enhancement Request Title
    • Priority
    • Summary
    • Contact Email
  5. Click the Settings icon to access the settings page of the field.
    1. In the Title field, enter the name of the field.
    2. Toggle the Required Field button to make the field mandatory.
    3. Click Save.

  6. Click Save to save the enhancement request form.

For more information on how to create custom fields, refer to the Basic Operations in Gainsight Data Management article.

Note: Additional fields can be added to the Enhancement Request object.

Configure Gainsight Data Points

Gainsight data points are the customizable fields from the Company object in Enhancement Request Form. Admins can add, delete or rename the Data Points. By selecting Gainsight Data Points, users are selecting the information to be shared with the product managers. The configured data points are added to the Enhancement Request page as a new field.

To configure Gainsight Data Points:

  1. Navigate to Administration > Product Requests.
  2. Drag and drop the Gainsight Data Points field from the Fields section into the Canvas section.
  3. Click the Settings icon. The Gainsight Data Points slide-out panel appears.
  4. In the Title field, enter the name of the field.
  5. Toggle ON the Required Field button to make the field mandatory.
  6. In the Customize Data Points section,
    1. Click +Add to select and add relevant Data Points.
      Notes:
      • A maximum of 15 data points can be added.
      • A minimum of one data point must be added.
    2. (Optional) Click the Delete icon to delete the Data Points. 
    3. (Optional) Click the Data Point title to rename it.
  7. Click Save.

Note: Only those Data Points which are added in the Customize Data Points section are visible on the New Enhancement Request page to CSMs with data obtained from Gainsight.

RN-Product Requests Data Points.jpg

Settings

Admins can adjust and tailor settings to align with their specific requirements.

When you integrate their Product Requests with the Productboard, on the Settings page an option to synchronize Productboard data into Gainsight appears.
Note: The historical data sync from Productboard once enabled, cannot be undone.

Product Settings

To synchronize non-Gainsight data, you need to follow the below steps:

  1. Navigate to Administration > Product Requests > Settings.
  2. Select the checkbox to synchronize Productboard data into Gainsight. A confirmation message appears.
  3. Click Confirm Sync.

Product Requests 2023-10-05 at 10.37.06 AM.jpg

  1. Click Save.

Product Requests 2023-09-27 at 11.22.08 AM.jpg

Company Mapping

Once the Productboard integration is established, you can upload company-related information in the product request to access the company information from Gainsight. 

Prerequisites:

  • The Productboard connection must be established.
  • Request the Company data in a CSV file from Productboard by creating a support ticket.
  • Download the template file shared by the Productboard team.

Note:

The template file must  have the following fields:

  • Organization Name 
  • Organization Domain Name (Example: companyname.com)
  • Organization ID (UUID format from Productboard)

To configure company mapping:

  1. Navigate to Administration > Product Requests > Settings tab.
  2.  Click the Company Mapping sub-tab.

Product Requests 2023-10-06 at 11.00.26 AM.jpg

  1. Drag-drop the template file that is downloaded from the Productboard or click Browse to select the file from the system. The uploaded file is processed and all the matching company records in Gainsight are automatically mapped to the Productboard company records.

Note: 

  • The CSV file must not exceed 2 MB in size. 
  • The headers of CSV file should be:
    • Organization Name -> name
    • Organization Domain Name -> domain
    • Organization ID -> id
  1. For unmapped Productboard company records, click the Select Company search box and enter the required company name. The companies with matching names in Gainsight appear in the dropdown. Select the required company to map.

Note: The unmapped company records are marked with the Caution icon. 

Screenshot 2024-04-24 at 8.34.16 PM.png

  1. Click the Upload icon to upload any new company file from the Productboard. The Companies will be appended to the existing company records.

Note:

  • If the organization ID in the uploaded file matches an existing record, that entry will be excluded.
  • If the organization ID is the same but other details differ, the entry will be updated with the information from the recently uploaded file.
  1. (Optional) Click the three horizontal dots to view or delete the company records.
  2. (Optional) In the Search textbox, search the records with the Company name.

Product Requests 2023-10-03 at 10.20.05 AM.jpg

  1. Click Add ProductBoard Company to manually add a company record. The Add Productboard Company slide-out panel appears.

Product Requests 2023-10-03 at 10.21.18 AM.jpg

  1. Enter the following details:
  • Company Name: Enter the Company Name.
  • Company Domain: Enter the Company Domain.
  • Company Id: Enter the Company Id.
  • Gainsight Company Record: Enter the required company name. The companies with matching names in Gainsight appear in the dropdown. Select the required company.
  1. Click Save. The Company is added and will appear on the Company Mapping list page.
  2. Click Save on the Company Mapping page to update the changes.

Productboard Data Management

To manage the Productboard data to be synced to Gainsight, follow these steps:

  1. Raise a support ticket in Productboard to receive the data file with the following details:
  • Note ID (In UUID format - example: 8a66991a-0050-455f-a957-35448f301c01)
  • Note Title
  • Note Content
  • Note Email
  • Note Organization
  • Note Organization ID (In UUID format)
  • Note Tags
  • Note Created Date
  • Note Updated Date
  1. Use the bulk API connector to sync the Productboard data to Gainsight.

For more information on how to use the bulk API connector, refer to the Gainsight Bulk API article.

Product Requests 2023-10-03 at 10.22.57 AM.jpg

  1. Click Open Connectors. The Connectors page appears.
  2. From the GS Bulk API Connection, select View Jobs. The Jobs page appears.
  3. Click Create Job.
  4. Enter the Job Name.
  5. Click Next.
  6. From the Data Source dropdown menu, select a data source.

Rahul Prayakarao's Personal Meeting Room - Zoom 2023-10-10 at 10.49.32 AM.jpg

Preparation of Job

To add job details:

  1. Enter Job Name.
  2. Click Save.
  3. In the Field Mapping dialog box, Enter the following details:
    1. Target Object: From the dropdown menu, select Enhancement Request.
    2. Click Browse and select the data file that is sent by Productboard.
    3. Data Load Operation: Select Upsert.
    4. Key Fields: Enter External ID in the text field.

Rahul Prayakarao's Personal Meeting Room - Zoom 2023-10-10 at 10.02.56 AM.jpg

  1. Click FETCH MAPPINGS.
  2. Mappings should be done as per the image below

High level Workflow of Bulk API (PB Non-GS Sync) - Gainsight Engineering - Confluence 2023-10-10 at 10.05.07 AM.jpg

  1. Lookup Mappings should be done as per the image below

High level Workflow of Bulk API (PB Non-GS Sync) - Gainsight Engineering - Confluence 2023-10-10 at 10.08.14 AM.jpg

  1. In the cURL API section, click GENERATE. The cURL API command is generated.

Rahul Prayakarao's Personal Meeting Room - Zoom 2023-10-10 at 10.14.41 AM.jpg

  1. Copy the cURL command and navigate Postman.
  2. Under the Import section, paste the cURL command.
  3. Under the Headers section, enter the access key.

Note: The bulk API access key that is generated during the creation of the bulk API connection is used here.

Rahul Prayakarao's Personal Meeting Room - Zoom 2023-10-10 at 10.23.10 AM.jpg

  1. From  the Body section, select the file that has the data.
  2. Click Send. The syncing process is initiated.