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

To access company-related information on this page after syncing data from Productboard, follow these steps:

  1. Request the Company data in a CSV file from Productboard by creating a support ticket.
  2. Download the Template file.
  3. Drag-drop the Template file to manually upload the file or click Browse to select the file from the system.

Note:

  • The template file must  have the following fields:
    • Organization Name
    • Organization ID
    • Organization Domain Name (website)

  • The maximum size of the CSV file is 2MB.

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

After uploading the template file, the Company data from Productboard is processed and synced. The data appears as shown in the image below:

Product Requests 2023-10-02 at 12.17.05 PM (1).jpg

  1. The summary ribbon sections show the following number of Companies Mapping:
  • All Companies: Total number of companies.
  • Mapped Companies: Number of companies mapped.
  • Unmapped Companies: Number of companies unmapped.
  1. Click the Upload icon to upload any new company file from the Productboard.
  2. All the objects from Productboard are automatically mapped to the Gainsight objects.
    1. Click the three vertical dots to perform the following actions:
      1. View Company Record
      2. Delete Record

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

  1. Search the records with the Company name in the textbox.
  2. Click Add Productboard Company. 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: Select Company from the search textbox.
  1. Click Save. The Company Mapping page appears.
  2. Click Save.

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.