Book a free demo
Enji.ai
Book a Demo
  1. Home
  2. Help Center
  3. How to Connect the Enji.ai Bot in MS Teams
Updated: October 11, 2024

How to Connect the Enji.ai Bot in MS Teams

This guide helps users create and register the stand-up bot in MS Teams for quick and easy stand-up submission.

Bots, Standups and Alerting

How to set up the bot

Copy link

Create an application

Copy link
  1. Go to Apps.
  2. Click Import app and upload the Enji.zip. The file contains the application manifest and bot icons.

Create a bot

Copy link
  1. Go to Bot management.
  2. In Configure, specify the bot webhook (https:///api/webhook), which the Microsoft Teams API will use to send incoming events.
  3. In Channels, ensure that the Microsoft Teams checkbox is selected.
  1. Return to the application in Apps.
  2. Inside the app, navigate to App features → Bot → Identify the bot → Select an existing bot, and choose the bot that was previously created.

Find, copy, and provide the following environment variables to the DevOps team (responsible for setting up Enji):

Copy link
  1. MICROSOFT_TENANT_ID – Go to Microsoft Entra ID of the organization → Basic information → Tenant ID.
    This is required to get a user's personal chat ID so that the bot can send autonomous messages (e.g., alerts).
  2. MICROSOFT_APP_ID – Go to Bot management → Bot ID.
  3. MICROSOFT_APP_PASSWORD – Go to Bot management → Client secrets → Add a secret.
    This is required to authenticate requests between the bot and the Bot Connector service.
  4. BACKEND_API_URL – The root URL of the backend API.
    The default value in a local development environment is http://localhost:5000/api/v1.
  5. MICROSOFT_BOT_BASE_URL – The bot's base URL.
    The default value in a local development environment is http://localhost:3978.

How to deploy the bot in an organization

Copy link
  1. Go to the bot in Apps → Publish to org → Publish your app.
  2. The IT admin must approve the app (bot) publication request.
  3. Publishing the app typically takes around 5 minutes.

If any changes have been made to the bot's app information in Apps, a new version of the bot will need to be deployed in the organization:

  1. Go to the bot in Apps.
  2. Update the bot version in Basic information → Version.
  3. Go to Publish to org → Submit app update.

How to add the bot to a team

Copy link

The bot cannot be used in private channels, as Microsoft Teams does not support this feature.

Adding an MS Teams Enji bot to a project

Copy link

1. Open Enji -> Settings -> Project List and click ID of the desired project.

2. In Chat Workspace, select Microsoft Teams. Click Save.

3. In Team Channel, select a corresponding MS Teams channel. The one the team will use to communicate within the project. Click Save.