Install Teams Bot

To get started with notifications via teams the company need to install our Ignos teams bot. It needs to be installed to a teams channel with all cnc operators.

For private distribution outside of the Teams store we need each company to install the teams bot via a zip file. The zip file consists of 3 files, manifest.json, ignos-color.png and ignos-outline.png. The manifest specifies a botId, which is the client id for our in bot in Azure Active Directory.

Download: ignos_teams_bot.zip

Install Procedure

Adding the app to admin center

1. Go to Teams Admin Center.
2. Navigate to Team Apps and Manage Apps.
3. Press Actions, then Upload new app.
4. Upload the ignos_teams_bot.zip file.

It takes some time before the app shows up in Teams and is ready to install without App not available or permission errors. ~20 minutes and it should show up if you search for the bot.

Now we go to teams to install to a channel

1. Go to Teams.
2. Navigate to Apps then search for Ignos Bot[^1].
3. Select Add to a team and select a channel for everyone that needs access to the bot.

[^1] There is an issue with Teams where apps that was recently added in admin center doesn't show under Built for your org. It will show up eventually, but it may take up to 2 hours.

Verify the bot works as expected

1. Message the bot @Ignos sync to synchronize new members.
2. The bot will reply with a list over all the members that was synchronized.

Synchronization

For the bot to be able to send a user a private message in teams, we need to retrieve the users teams id. To synchronize, Teams triggers events from the channel where the bot is installed. On these events we retrieve information on the members of the channel and synchronize their teams id to our database.

To trigger sync manually we have the @Ignos sync command, where you also see who has been synchronize again.

Data Storage

The bot stores the users: Name, Email, Tenant id, Teams id, Azure active directory id and Conversation id.