Skip to main content
The nao Teams bot brings your analytics agent directly into Microsoft Teams, allowing your team to ask questions and get insights without leaving their workspace.
nao Teams Bot Interface
When configured, the nao Teams bot:
  • Responds to messages in Teams channels and group chats
  • Can also answer from direct messages in Teams
  • Processes questions using the same agent as the web chat interface
  • Returns answers with SQL queries, data tables, and visualizations
  • Maintains conversation context within threads
The Teams bot uses the same agent context, rules, and capabilities as your web chat interface. Any improvements to your agent automatically benefit Teams users.

Setup

Step 1: Create an Azure Bot

  1. Go to https://portal.azure.com
  2. Click “Create a resource”
  3. Search for “Azure Bot” and select it
  4. Click “Create” and fill in:
    • Bot handle: Unique identifier for your bot
    • Subscription: Your Azure subscription
    • Resource group: Create new or use existing
    • Pricing tier: F0 (free) for testing
    • Type of App: Single Tenant (recommended for enterprise)
    • Creation type: Create new Microsoft App ID
  5. Click “Review + create” then “Create”

Step 2: Open the Teams Integration in nao

  1. In nao, click on your profile → “Project”“Microsoft Teams”
  2. Keep this page open — you will paste your credentials here in the next step

Step 3: Get App Credentials

  1. Go to your Bot resource, then “Configuration”
  2. Copy the Microsoft App ID and paste it as App ID in nao
  3. Click “Manage Password” (next to Microsoft App ID)
  4. In the App Registration page, go to “Certificates & secrets”
  5. Click “New client secret”, add a description, select expiry, click “Add”
  6. Copy the Value and paste it as App Password in nao
  7. Go to “Overview”, copy Directory (tenant) ID and paste it as Tenant ID in nao
  8. Click “Save” in nao. Automatically, a file “app.zip” will be downloaded

Step 4: Configure the Bot Endpoint

  1. In nao, Copy the Messaging Endpoint URL
  2. Go back to your Azure Bot resource → “Configuration”
  3. Paste the URL into the Messaging endpoint field
  4. Click “Apply”

Step 5: Enable the Microsoft Teams Channel

  1. In your Azure Bot resource, go to “Channels”
  2. Click on “Microsoft Teams”
  3. Accept the Terms of Service and click “Agree”
  4. Click “Apply”

Step 6: Add API Permissions

  1. In the Azure portal, go to “App registrations” and open your bot’s app
  2. Go to “API permissions”
  3. Click “Add a permission”“Microsoft Graph”“Application permissions”
  4. Search for and add User.Read.All
  5. Click “Grant admin consent” to activate the permission

Step 7: Install the Bot in Teams

  1. In Microsoft Teams, click “Apps” in the left sidebar
  2. Click “Manage your apps”“Upload an app”“Upload a custom app”
  3. Select “app.zip”
  4. Start talking to your bot

Usage

Ask Questions Mention the bot in any channel:
@nao What were our top 5 products by revenue last month?
The bot will:
  1. Process your question using the same agent as the web interface
  2. Generate SQL queries based on your context
  3. Execute queries against your connected databases
  4. Return results in a formatted Teams message
  5. Send you the link to the full conversation to open it in the browser UI
Thread Conversations Follow-up questions in the thread maintain context:
@nao What were our top 5 products by revenue last month?
# ... bot responds ...

@nao Can you break that down by region?
# ... bot responds with regional breakdown ...
The bot replies in threads to keep conversations organized. Use thread replies for follow-ups.
Direct Messages You can also ask the bot via direct message in Teams (no channel mention required). What’s Next?