Skip to content

Kudos Boards On-Premise in Microsoft Teams

example


Prerequisites

  1. Office 365 Tenant admin account.

  2. Office 365 OAuth client. See instructions

  3. Notification bot (optional). See instructions

    Note: notifications are optional as the bot cannot be configured for internal Kudos Boards deployments


Configure Application

Download from Boards

  1. Login to Kudos Boards with your Microsoft Tenant Admin account

  2. Click the Configuration icon and then Manage Org

    example

  3. Click on your Organisation

    example

  4. Click on your Microsoft client

    example

  5. Click the download button for your configuration

    • App with Notifications (if you can and have enabled the notification bot)

    • App for Internal Boards Deployment (if you do not want notifications)

    example

Install in Teams

  1. Open the Teams App

    Click Apps -> Upload a custom app -> Upload for [COMPANY_NAME]

    where [COMPANY_NAME] is the name of your company

    example

  2. Upload the Zip file you downloaded above

    example

  3. The Kudos Boards app will now appear under the section Built for [COMPANY_NAME]

    example


Configure App ID

  1. Open Team Apps in your web browser

    Click on Built for [COMPANY_NAME] => Kudos Boards

    example

  2. Click Add

    example

  3. Kudos Boards personal will now open

    Copy the App ID from the URL. We will use this shortly.

    example

  4. Open the Boards Helm Chart config used for deployment

    Add the following environment variable to provider (uncomment or add the section as required):

    provider:
      env:
        MSGRAPH_TEAMS_APP_ID: "<your_app_id>"
    
  5. Redeploy Boards helm chart as per command for Kudos Boards:

    HCL Component Pack

    helm upgrade kudos-boards-cp https://docs.kudosapps.com/assets/config/kubernetes/kudos-boards-cp-1.0.0.tgz -i -f ./boards-cp.yaml --namespace connections
    

    for Docker - Kubernetes

    helm upgrade boards https://docs.kudosapps.com/assets/config/kubernetes/kudos-boards-2.0.2.tgz -i -f ./boards.yaml --namespace boards
    

    Note: --recreate-pods is not required this time as this is only an env variable change


How To Use

For a full guide on using Kudos Boards in Microsoft Teams, please see our documentation.