Installation Guide

@Kudozza is a Microsoft Teams application which focuses on increasing appreciation within an organization with the help of kudos. All with the goal of strengthening the team culture. If you want to read more about how @Kudozza is helping you with your team culture, visit our WHY Kudozza webpage.

This guide will explain the “technical” setup of @Kudozza within an organization, typically done by an IT admin.
Please follow it step by step to the end. Especially the addition of further administrators and the granting of Teams permissions are important steps that should be performed after the installation.


Teams apps have different modes and thus possibilities to interact with the team members and users.
For the various modes of @Kudozza see the Anatomy of Kudozza .

Install in a team (required)

@Kudozza can not work without being installed in at least one team.
This is because @Kudozza only supports public kudos given in the context of a team and channel.

To install @Kudozza in a team, please find @Kudozza in the Microsoft Teams Appstore and choose the “Add to a team” option.
Afterwards choose a team&channel from the selection box and click the “Set Up” button.

Installation to a team

You’ll see a short introduction dialog and with the press of Save the @Kudozza bot is installed in the corresponding team.
In addition, the channel tab of @Kudozza is installed.

You can verify the successful installation by checking for the small @Kudozza button in the toolbar below the message box:

Message extension

This process does not need to be repeated for other channels in the same team as the @Kudozza bot is installed team wide.

Rollout to multiple teams

Installing @Kudozza in one team is sufficient for a test run. However, for a company wide usage, it is recommended to install @Kudozza in as many teams as possible so it is omnipresent to the user.
Microsoft Teams has no good support for this at the moment, so it must be done manually for each team or by script using the Microsoft Graph API.

Install team tab

The “Team tab” is optional and not required for @Kudozza to work (only the above described team bot install is absolutely mandatory).
However, it is highly recommended to install it in at least one channel of a team as it provides team specific user and kudos statistics.

To install a @Kudozza tab in any channel, just select the + sign next to a channel tab list and search for Kudozza.

Tab installation

Setup personal mode

@Kudozza can be opened in personal mode as well. This gives access to some personal user settings but also to the administration area of Kudozza.
To open in personal mode, @Kudozza needs to be opened from the left sidebar.
To add it there, select the three dots, and search for Kudozza.

Personal mode

To keep it always visible, you can right click the @Kudozza symbol in the left sidebar and select Pin.

If you want to add @Kudozza to all users' sidebars by default, visit the Teams Admin Center->Teams App->Setup policies section and change your policy to add @Kudozza into the sidebar of all users.

Add additional administrators

@Kudozza has its own administration section which can be found when opening @Kudozza in personal mode and selecting the “Administration” tab.
This section has limited access as it shows org wide statistics and allows to configure some global settings (like categories and challenges).

By default, everyone who has installed @Kudozza to a Teams team is added to the @Kudozza administrator list and has access to this section.
However, it is possible to manually add people here (e.g. the HR manager who configures the non technical parts of @Kudozza).

To do so, go to “Administration->Permissions” within the personal mode of @Kudozza and select “Add a new administrative user”

Add an administrator

Grant Teams permissions ⚠️

@Kudozza is initially installed with a minimal set of Microsoft Teams permissions. This is sufficient for its evaluation and for the usage within few and small teams. However, for more advanced and better performing operations @Kudozza needs some more permissions.
It is heavily recommended that these are granted by a Teams administrator for the whole organization.
These permissions then allow the display of user avatar images in the user overview and also a much more performant query for the user’s teams membership.

To grant these permissions, the most simple way for a Microsoft Teams Administrator is to use the “Grant Teams Permissions” button on the “Administration->Permissions” page.

Grant permissions

The alternative for an administrator is to visit the Kudozza configuration in your organizations Teams Admin center, select “Go to Azure Directory” and “Grant admin consent” there.

Next steps

@Kudozza benefits from being tailored to your organization. If you are an admin, check the configuration guide .