Follow the steps below to implement a MS Teams integration with 10KC.

1. Download the 10KC Teams app.
2. Upload the 10KC Teams app to Microsoft Teams Admin Center.
3. Add all members that you want to invite to your 10KC hub to your Teams Channel.
4. Connect your MS Channel to your 10KC Hub.
5. Optional: Send some test notifications to members in Teams

1. Download the 10KC Teams app

1. Login to 10KC as a tenant admin and go to Integration Settings. The URL will be https://yourtenant.tenthousandcoffees.com/admin/integrations
2. Under “Messaging Integration” click on “Set up integration” next to Microsoft Team
3. Click on “Download 10KC app”. This will download the 10KC Teams app in a .zip file to your local device.
   

2. Upload the app to Microsoft Teams Admin Center

1. Login to Microsoft Teams admin center. You must be a Global or MS Teams administrator.
2. Navigate to Teams apps > Manage apps. Then click on + Upload new app.
3. Upload the 10KC MS Teams app.
4. Once the app is installed, 10KC Bot will show up under your apps list.
   
5. Click on 10KC Bot and accept the app permissions and org-wide permissions by clicking on the Review permissions button.
   

3. Add all members to your Teams Channel

Now it’s time to add all members you want to invite to your 10KC hub to your Teams Channel.

• To add members to a team, follow this guide from Microsoft.
• If you want to bulk add members to a channel, you may need to bulk import members to a Team first, by creating a M365 Group.

4. Connect your Teams Channel to your 10KC Hub

All members in the Teams channel will have accounts created for them in your 10KC hub, and receive a message that they've been added to a 10KC Hub. If you aren't sure you should do this, talk to your Customer Success Manager.

1. Go back to 10KC and go to Integration Settings. The URL will be https://yourtenant.tenthousandcoffees.com/admin/integrations
2. Under the Microsoft Teams, paste your Tenant ID, and click on Save. Here’s how to find your Tenant ID.
3. Once you save the Tenant ID, you’ll that, you’ll see that the integration is enabled.
   
4. Next, you’ll want to connect your 10KC hub to your Teams channel. First, search for the Team which the channel is located in. Then, search for the Channel. In this example, we searched for the “10KC” Team, then the “General” channel.
5. Once you are done selecting the Team and Channel, click on Save. This will connect your 10KC hub to your Teams channel. 
   

Now it’s time to add all members you want to invite to your 10KC hub to your Teams Channel.

5. Send some test notifications

10KC will provide next steps for testing the MS Teams Integration via email or in a meeting.

Additional Hub Settings

Microsoft Native Calendar Option

If you want to use the native Microsoft Teams Calendar for notifications sent from 10KC, you can enable that option in the Hub settings.

This option overrides any other calendar integrations that the tenant or hub might have, meaning the user will not be re-directed to the platform to book a meeting, but will remain in MS Teams. This only effects the meeting links embedded in MS Teams notifications.

It can be found in the Advanced settings section of Hub settings.

Hub level enablement

MS Teams has to be enabled at a tenant level. However, after it is enabled and connected to a hub it can be turned on or off at the discretion of the hub admins. When an admin turns notifications off at a hub level, all notifications are sent as emails. Notifications that were previously disabled, such as invite emails, are re-enabled. 

Once MS Teams notifications are turned on users will start to receive notifications through MS Teams immediately. This setting can be found in the Advanced settings section of Hub settings.

Do not disable MS Teams notifications while a development program or introduction cycle is running. The notifications for these features rely on all messages being sent either as MS Teams notifications or as emails. If you have further questions, or a special situation, please talk to your Custom Success Manager.

Security Considerations

Microsoft Partner Network

10KC is a verified Microsoft Partner with access to benefits like comprehensive technical extensibility and secure foundation to build robust solutions for our customers.

Security Measures

10KC has strict security policies and we follow all best practices like annual pen-testing, annual internal audit, third party SOC2 audit and aligning with regional data privacy requirements.

App permissions required 

• Receive messages and data that I provide to it.
• Send me messages and notifications.
• Access my profile information such as my name, email address, company name and preferred language.
• Receive messages and data that team or chat members provide to it in a channel or chat.
• Send messages and notifications in a channel or chat.
• Access information from this team or chat such as team or chat name, channel list and roster (including team or chat member's names and email addresses) - and use this to contact them.

Org-wide permissions required by MS Teams integration