Contact Us
Microsoft Teams Integration

How to Connect Microsoft Teams to NIVA — Integration Guide

20–30 minutes Medium 6 steps

Connect NIVA to Microsoft Teams via Azure Bot Service. Your AI bot will respond to direct messages and channel mentions in Teams. NIVA uses the Bot Framework REST API with full JWT token validation for security.

Before you begin
NIVA botmaster account with a bot configured
Microsoft Azure account (free tier available)
Microsoft Teams with admin access or permission to add apps
Step-by-step setup

Create an Azure Bot Registration

  • Go to https://portal.azure.com
  • Search for Azure Bot and click Create
  • Enter a bot handle, select your subscription and resource group
  • Under Microsoft App ID choose Create new Microsoft App ID
  • Click Review + Create → Create
  • Wait for deployment (~1 minute)

Get App ID and Create Client Secret

  • Open your bot resource → Configuration
  • Copy the Microsoft App ID
  • Click Manage Password — this opens the App Registration
  • Go to Certificates & secrets → New client secret
  • Set description and expiry (24 months recommended) → Add
  • Copy the secret Value immediately — it is only shown once
Copy the Value, not the Secret ID.

Configure in NIVA Botmaster

  • Open your NIVA botmaster → Omnichannel
  • Click Configure on the Microsoft Teams card
  • Paste Microsoft App ID and Client Secret
  • Leave Tenant ID as botframework.com for multi-tenant
  • Click Save & Activate
  • Copy the Webhook URL

Set Messaging Endpoint in Azure

  • Back in Azure → your bot resource → Configuration
  • Paste your NIVA Webhook URL into Messaging endpoint
  • Click Apply

Enable the Microsoft Teams Channel

  • In your bot resource → Channels
  • Click the Microsoft Teams tile
  • Accept terms → Agree → Apply
  • Status should show Running

Test in Microsoft Teams

  • Open Microsoft Teams
  • Search for your bot by the handle name used in Azure
  • Click → Open → type a message
  • Bot should reply within 2–3 seconds
To add the bot to a channel, use + in the channel and search for your bot.
Troubleshooting
No reply at all
Check Channels → Teams shows Running in Azure.
401 Unauthorized in logs
Client Secret wrong or expired — regenerate.
JWKS key not found in logs
App ID mismatch between Azure and NIVA config.
Teams says "Bot is not responding"
Server not publicly reachable — must use HTTPS with valid cert.
Ready to connect Microsoft Teams?
Open your NIVA botmaster → Omnichannel → Configure
Open Omnichannel