Follow

Integrate Culture Amp with Slack


Note: In July 2020, Culture Amp released an update to the Culture Amp app for Slack introducing new features. If you already have the app installed, you must do a one-time update of the app from within their Culture Amp account settings to receive the new features. 

Overview

All Culture Amp customers can install and use our Slack app. The following features are currently available:

Engagement 

The app delivers news of survey launches, gentle reminders, and reports and insights for our employee engagement, experience, and effectiveness surveys, making it easier to stay updated on important feedback and development opportunities.

  • Receive survey invitations 
  • Receive survey reminders 
  • Get notified when you gain access to reports and insights 

Performance

The app lets you give and receive feedback directly in Slack using slash commands and notifies you of performance cycle launches and reminders. 

  • Give feedback to colleagues
  • View feedback from colleagues
  • Respond to feedback requests from colleagues
  • Share feedback with managers
  • Request feedback from colleagues

Notes about the Slack app

  • Only survey communications will be delivered via both Slack as well as email for any future survey that you launch.
  • The Slack messages are translated into all our supported languages and can be customized.
  • Employees with an active Culture Amp account, an active Slack account, and matching emails across both these accounts will receive survey invites and reminders via Slack and email.
  • Reminders are only sent to people who have not submitted their survey yet.
  • Employees that only have an active Culture Amp account (or non-matching emails) will continue to receive the standard email communications that you expect from Culture Amp. 

Ready to integrate Culture Amp with Slack to bring feedback and insights into the flow of work for your teams? In this article, learn how to: 

  1. Add the Culture Amp app to your Slack app directory
  2. Sync Slack and Culture Amp
  3. Customize messages and manage which users receive messages
  4. Update to the latest Culture Amp app

Step 1: Add the Culture Amp app to your Slack app directory

NOTE: The Slack integration must be set up by an Account Admin for your Culture Amp account.

To get started, go to settings-24px.svgAccount Admin Notifications > Add Neko to Slack.

slack-landing-page.png

What if I'm not a Slack Admin? 

You may need approval from the administrators on your company's Slack account to successfully configure Slack integration. If you are unsure whether or not you need approval, simply select I don't have admin access/I'm not sure, click on the Next step button, and follow the prompts on the next screen.

slack-not-sure-screen.png

Select a role that best describes you

assistance-screen.png

Follow prompts to receive approval for Neko installation. 

Configuring Slack Integration if you're a Slack Admin

If you are a Slack administrator, you can add Neko to your account independently. Go to settings-24px.svgAccount Admin Notifications > Add Neko to Slack.

lets-start-page.png

Upon selecting Iā€™m an administrator on [Your Company's] Slack account and the Add Neko to Slack button, you will be presented with the screen below. Go ahead and authorize the integration!

slack-permission-screen.png

That's it! Once everything is set up, you'll see a confirmation screen and can even send yourself a test message in Slack to see how Neko will communicate with your employees. 

 

Step 2: Sync Slack and Culture Amp 

Once Slack integration has been successfully configured, you will be redirected back to Culture Amp to the Notifications section of Account Admin settings. 

neko-installed-success.png

šŸŽ‰ Slack and Culture Amp will now sync automatically. šŸŽ‰ 

 

When these systems sync, Culture Amp will display the total "matches" found. The Culture Amp platform will attempt to "match" a corresponding Slack user by email address. Users are considered "matched" if an exact match of their email is found in both systems. These "matched" users will be able to receive survey messages via Slack. If a match does not exist, we will flag that employee so you can check their emails in each system and make updates accordingly.

Any users that do not have a successful match will have a warning icon next to their name on the Users page.

neko.png

 

NOTE: You will need to manually sync Culture Amp and this integration in the future as new employees join your company. To manually initiate a sync between the two systems, simply to go to settings-24px.svgAccount Admin Notifications > Resync users.

Step 3: Manage + Customize Messages 

Manage who receives messages 

Once the Neko by Culture Amp integration is enabled on your account, survey communications will be delivered via both Slack as well as email for any future survey that you launch. You can view the default Slack messages or you can customize them. 

If you wish, you can deactivate Slack communications on individual surveys. To do so, simply:

  • Navigate to a survey in Draft mode.
  • Open the Settings tab.
  • Scroll down and select Turn Slack notifications off

There is also a Disable Slack for this survey link to remove Slack on the Communications page for a survey.

Slack_Example.png

NOTE: By default, Slack Notifications for Performance are disabled. If you have previously requested for these notifications to be enabled and you want to re-disable Slack Notifications for Performance, please contact your Customer Success coach or the support team (support@cultureamp.com).

Customize Messages

TIP: You can customize messages for survey invites and reminders for all Engagement, Lifecycle, and Effectiveness surveys. To get started, click on the Surveys tab and select the survey you want to customize, then go to Survey Launch Communications > Customize Slack messages.

slack-communications.png

Update to the latest Culture Amp app for Slack 

Users will still receive notifications without updating their apps, but we recommend you update the app as soon as possible to get the latest features now and in the future. 

Note: This is a big update packed with cool new features. You should only need to do this once and all future updates will roll through without you having to lift a finger.

For existing customers who already have the Slack app installed, there are two ways to update the app for your organization, either from within Culture Amp or from with Slack. 

  • From Culture Amp, delete and reinstall the app via the account main page
  • From Slack, select the one-click update option to install the latest version of the app 

To delete and reinstall the app from within Culture Amp

  1. To get started, go to settings-24px.svgAccount Admin Notifications > Remove Slack
  2. Add the Slack app by selecting Add Neko to Slack 
  3. Follow the install processs

To select the one-click update from with Slack 

  1. From Slack app settings, click the one-click update link to install the latest version of the app
  2. Select Allow to complete the update

Technical Info

The Culture Amp app for Slack is a bot, which means it has a special permission scope called 'bot'.

The list of allowed operations of a bot is listed in the "Limitation" section of this doc https://api.slack.com/bot-users.

Out of all those permissions, we use only 3 of them.

1. users.list to get a list of users that matches employees in our system.
2. im.open to open a direct communication channel between our bot and the user.
3. chat.postMessage to send a direct message



Was this article helpful?
6 out of 8 found this helpful
Have more questions? Submit a request

Comments