Microsoft Teams

​

Capabilities

• Direct messaging — interact with the bot in a 1:1 personal chat.
• Channel @mentions — mention the bot in any team channel to ask questions visible to the whole channel.
• Threaded conversations — each @mention in a channel starts a thread; replies within it continue the same conversation and report.
• Rich responses — text and markdown tables directly in Teams.
• Permission-aware — channel mentions query only public agents; DMs also include the user’s private agents.

​

How to integrate

• Admin access to BOW (to manage integrations)
• Access to the Azure Portal (to register a bot)
• Admin access to Microsoft Teams (to sideload the app)

​

Step 1: Register a Bot in Azure

1. Go to the Azure Portal.
2. Search for Azure Bot and click Create.
3. Fill in the required fields:
   • Bot handle: A unique name for your bot (e.g., bow-bot)
   • Subscription: Select your Azure subscription
   • Resource group: Create new or select existing
   • Type of App: Select Multi Tenant
   • Creation type: Select Create new Microsoft App ID
4. Click Review + Create, then Create.
5. Once the resource is created, go to the bot resource.

​

Step 2: Get the App ID and Client Secret

1. In the Azure Bot resource, go to Configuration.
2. Copy the Microsoft App ID — this is your bot’s App ID.
3. Click Manage Password (next to the App ID) to go to the App Registration’s Certificates & secrets page.
4. Click New client secret, give it a description, and click Add.
5. Copy the Value of the secret immediately (it won’t be shown again). This is your Client Secret.

​

Step 3: Configure the Messaging Endpoint

1. In the Azure Bot resource, go to Configuration.
2. Set the Messaging endpoint to your BOW application’s webhook URL:
   https://YOUR-BOW-URL.com/api/settings/integrations/teams/webhook
   
3. Click Apply.

​

Step 4: Enable the Teams Channel

1. In the Azure Bot resource, go to Channels.
2. Click on Microsoft Teams to enable it.
3. Accept the terms and click Apply.

​

Step 5: Connect in BOW

1. In BOW, navigate to Settings > Integrations.
2. Click Integrate (or Settings) for the Microsoft Teams integration.
3. A modal will appear. Enter the following:
   • App ID: The Microsoft App ID from Step 2
   • Client Secret: The client secret value from Step 2
   • Tenant ID: Your Microsoft 365 tenant ID (found in Azure Active Directory > Overview)
4. Click Connect. If successful, the modal will close and the UI will show that Teams is connected.

​

Step 6: Create the Teams App Manifest

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.16",
  "version": "1.0.0",
  "id": "YOUR-APP-ID-HERE",
  "packageName": "com.yourcompany.bot",
  "accentColor": "#4F46E5",
  "developer": {
    "name": "Your Company",
    "websiteUrl": "https://your-domain.com",
    "privacyUrl": "https://your-domain.com/privacy",
    "termsOfUseUrl": "https://your-domain.com/terms"
  },
  "name": {
    "short": "BOW Bot",
    "full": "Bag of Words Bot"
  },
  "description": {
    "short": "Ask questions about your data",
    "full": "Ask questions about your data via Teams"
  },
  "icons": {
    "color": "color.png",
    "outline": "outline.png"
  },
  "bots": [
    {
      "botId": "YOUR-APP-ID-HERE",
      "scopes": ["personal", "team", "groupChat"],
      "supportsFiles": false,
      "isNotificationOnly": false
    }
  ],
  "permissions": ["identity", "messageTeamMembers"],
  "validDomains": ["YOUR-BOW-DOMAIN.com"]
}

​

Step 7: Install the Bot in Teams

1. Zip the three files together:
   cd your-manifest-folder
   zip -r ../bot.zip *
   
2. Open Microsoft Teams.
3. Go to Apps (in the left sidebar) → Manage your apps → Upload an app.
4. Select Upload a custom app and choose the bot.zip file.
5. Click Add to install the bot.

​

How to use

​

Account linking

​

Chat with the bot

1. Open a 1:1 chat with the bot in Teams.
2. Send your query or command.
3. The bot will reply with a link to the new report, followed by the response with text and data.
4. Continue the conversation by sending more messages — follow-up messages will extend the same report.

1. In any team channel, @mention the bot followed by your question (e.g., “@BOW Bot what were last month’s sales?”).
2. The bot will respond in a thread on your message.
3. Reply in the thread (with @mention) to continue the conversation.