Skip to main content
Gainsight Inc.

Admin Configuration for Sally

Gainsight NXT

 

This article explains how Admins can configure Sally users for Slack. 

Overview

To access Gainsight Sally in Slack, Sally must be added to the Slack team. The members of the Slack team are then brought into Gainsight and given access permissions to Sally. After Sally is added to your Slack team, you can manage users (give/revoke access to users in Slack to Gainsight) and also provide access to users outside of your org.

Note: Sally welcome emails will only be sent to active users when the feature is enabled for the first time.

For end-user instructions, refer to Use Gainsight Sally in Slack article.

Prerequisite

You must be Gainsight admin to enable/setup users to Sally for Slack in Gainisght.

Configure Users to Sally

To add Sally to your Slack team: 

  1. Navigate to Administration > Gainsight AI > Gainsight in Slack.
  2. Click the Add New Workspace button.
  3. A pop-up appears with options to select an app:
    • Gainsight's AI Agent in Slack (default selection)
    • Sally

Modal to select Gainsight Slack app: choose between AI Agent for CS insights or Sally for company and relationship queries

  1. Click Continue to proceed.
    Note: If you have already logged into a Slack team, this dialog displays the list of Slack teams at the top-right corner, and you can select a team to grant access.  

Slack authorization message showing workspace selector and error: user not authorized to install Sally Integration on Gainsight Sally

  1. Enter a team name and click Continue.
    Note: A Slack team can be authorized in only one tenant (Gainsight Org). You cannot authorize a Slack team with more than one Gainsight org. For testing purposes, it is recommended to create a dummy Slack team and authorize it with Gainsight. 
  2. Review the information and click Allow. If authorization is successful, a success message appears.
  3. After successful authorization, your team will be visible in the Administration > Gainsight AI > Gainsight in Slack screen.

Slack authorization screen requesting permissions for Gainsight Sally to access user, channel, and workspace data

  1. Hover over your team’s name and the admins can see the following four options: 

  • Settings - Click this option to configure the following privacy and security settings for Sally in Slack. For more information on how to configure channel level settings, refer to the Configure Channel-Level Settings for Sally section.
  • Manage Users - Click on this option to manage users in Gainsight. Users are navigated to the Administration > User Management screen. 
  • Re-authorize - Click on this option to re-authorize Gainsight Sally with your Slack team. This option is useful if a Slack Admin’s credentials are no longer valid, so a new Slack Admin can use this option to re-authorize Sally. 
  • Revoke - Click on this option to remove access to Gainsight Sally for your team.

Admin menu.jpg

  1. Click Manage Users. The User Management > The Add User to Gainsight page is displayed in a new tab.
  2. From the Connection Type dropdown, select Slack workspace type.
  3. From the Connection dropdown, select the type of Slack workspace. The users are automatically loaded in the right panel.
  4. (Optional) Click Load Users.  Users from the Slack workspace type who are not in Gainsight already are loaded.
    Note: 
  • An Email/Slackbot notification is automatically sent to users who are having a Gainsight license when they click Load Users.
  • While adding users to Gainsight, users with Full, Viewer, Viewer + Analytics, and Internal Collaborator licenses can access Sally. Inactive users cannot access Gainsight Sally. For more information about the new Gainsight license types, refer to the User License Management article. 
  1. Select the checkbox adjacent to the users to move to specified Slack avatar.
    Note: When you sync users from external systems, If more than one users are already added in Gainsight with the same email ID, Gainsight will display a Conflict button in the Status column. For more information on how to resolve a conflict, refer to the Gainsight User Management article.
  2. Click Confirm. Confirmation dialog box is displayed.
  3. Click Done. The selected users are added to the avatar list.
  4. Click Cancel. The User Management screen appears.
  1. Select an avatar of type Slack from the dropdown at the top left corner of the page.
  2. Select the required users to grant Sally access for specific Slack workspace.
  3. Click three dots and select Enable Sally Access. The Sally Enabled status of the selected user is changed to True.

Add Sally App to a Slack Channel

Follow the steps below to add the Sally app to a slack channel:

  1. Open the Slack Channel where you want to add the Sally app.
  2. Add the sally app in either of the two ways mentioned below:
    • From the channel details: 
      1. From the channel details Integrations tab, click the Add an App option.
        Channel details in Integrations tab, and the Add an App option.
      2. Search for the app in the search bar.
      3. Click Add. The app is added to the slack channel.
        Add option in manage apps view slack workspace..
    • From the channel
      1. Mention @<App name> in the slack channel. 
      2. Press Enter. A dialog box appears.
      3. Click Add to Channel
        Note: If you click Send This Message without first adding the app to the channel, a notification appears indicating that the app is not part of the channel.
        Add to Channel option in the dialog box.

Once the app is added to the channel, it appears under the Integrations tab in the channel details. 
Integration tab in channel details with the Apps list.

You must @ mention the bot name (@GainsightSally) to interact with Sally within a channel.

Slack sally-core Gainsight 1 new item 2022-02-25 at 11.44.31 AM.jpg

Remove Sally App to a Slack Channel

Follow the steps below to remove the Sally app to a slack channel:

  1. Open the Slack Channel where the Sally app is currently added.
  2. Type /remove @<App Name> command in the message box. A confirmation message appears.
  3. Click Remove to proceed. The app is removed silently and no notification is posted in the channel.
    Note: If you click Cancel, no changes will be made.
    Remove option in the dialog box.

Once the app is removed, it no longer appears under Integrations in the channel settings.

Note

  • Any channel member can typically remove the app, depending on slack admin workspace settings.
  • If the remove command does not work, the issue may be related to Slack admin settings. In such cases, users must contact their Slack administrator, who controls the app removal permissions.

Configure Channel Settings for Sally

Admins can configure channel-level access settings for Sally within Slack channels. These settings allow blocking or showing warnings in public, private, or external channels, based on organizational needs.

Follow the steps below to block Sally or display a warning message in a Slack channel:

  1. Navigate to Administration > Gainsight AI > Gainsight in Slack.
  2. From your workspace, click the three-dots vertical menu and select Channel Settings. The Channel Settings dialog box appears. 
    Channel Settings option in three dot menu
  3. In the Sally tab, you can either block Sally or display a warning message when someone interacts with Sally app in Slack. By default no restrictions are applied.
    Sally tab with block Sally and display a warning message options
    1. Select the checkboxes next to the channels if you want to block Sally. Channels are grouped into three categories:
      • Public Channels: Open channels where any member in the organization can join.
      • External Channels: Channels shared with customers or external stakeholders.
      • Specific Channels: Channels identified using a common prefix, suffix, or keyword for targeted blocking. Perform the steps below to block sally in specific channels:
        1. In the Specific Channels text field, type a keyword to identify channels and press Enter. Example: Type Tech to target all channels containing Tech in their name. 
          Specific Channels text field to type a keyword and identify channels.
        2. Press Enter to create the tag. For example, if 10 out of 20 channels include release in their name, such as release-update, Sally gets blocked in all of them.
        3. Click Save. Block settings are applied immediately after configuration.
          Note: When a user questions Sally in a blocked channel, a message is shown which is visible only to the user.
          behavior of sally in public channel
    2. Turn on the Enable Warning Message toggle to display a warning when someone interacts with Sally in a channel. Here, channels are grouped into three categories:
      • Public Channels: Open channels where any member in the organization can join.
      • External Channels: Channels shared with customers or external stakeholders.
      • All Channels: Channels including both public and private slack channels. 
        Note: By default, the Public Channels option is selected. 
        Enable warning message toggle in Sally tab.
        Perform the steps below to enable warning messages in a channel:
        1. Select the radio button next to the channel type where you want to display warning messages.
        2. Click Save. Warning settings are applied immediately after configuration.
          Note: When a user questions Sally in a warning-activated channel, a message delivery option is shown:
          Behavior of Sally in a warning-activated channel.
          • Proceed: Select this if you want Sally to reply in the Channel.
            Sally posts a response in the channel after the user selects the Proceed option.
          • DM the information: Select this if you want Sally to send a reply as Direct Message (DM).
            Sally posts a response in the direct message after the user selects the DM option.
  • Was this article helpful?