/
Configuring Kyvos Dialogs Bot in Microsoft Teams

Configuring Kyvos Dialogs Bot in Microsoft Teams

✅ Enterprise: AWS, Azure, GCP, and On-Premises

Important

  • This section is intended for administrators only and provides a structured, implementation-focused walkthrough specific to the Dialogs bot deployment.

  • For detailed Azure procedures, refer to official Microsoft documentation.

  • The bot server will be accessible at: <https://<FQDN>:3978

This section outlines the required Azure configuration, bot registration, authentication setup, and Microsoft Teams deployment steps to enable secure, seamless conversational analytics within the Microsoft Teams environment.

Dialogs Bot integrates with Microsoft Teams through Azure Bot Service and Microsoft Entra ID (Azure Active Directory). The configuration process includes:

This setup ensures secure communication between Microsoft Teams, the Kyvos Bot Server, and the Kyvos platform.

Step 1: App registration in Microsoft Azure for Teams bot

To enable secure communication between Microsoft Teams and the Kyvos Dialogs Bot, you must register an application in Microsoft Azure. An app registration provides the bot with a secure digital identity that includes:

  • Application (Client) ID

  • Client Secret

  • Tenant ID

  • Defined API permissions

  • OpenID Connect metadata document

This identity allows Microsoft Teams to authenticate and trust the bot within your organization’s tenant.

Note

To register your application in Microsoft Azure for a Microsoft Teams bot, follow the Microsoft documentation for the topics listed in the table below.

Microsoft Documentation Topic

Description

Microsoft Documentation Topic

Description

Add App Registration

Register the bot application in Azure Active Directory.

Add Web Authentication

Configure web platform settings and redirect URIs for secure authentication.

Create a Client Secret

Generate a client secret to enable secure communication between the bot and Azure.

Add API Permissions

Grant the following Microsoft Graph API permissions (delegated) for bot functionality:
email
offline_access
openid
profile

Add Application ID URI

Define the Application ID URI to expose the bot API.

Add a Scope

Create an access scope to allow Teams to call the bot’s API on behalf of the user.

Add Client Application

Authorize Microsoft Teams client applications to access the bot API.

Update the Manifest

Modify the Azure app manifest to configure the token version and required settings.

Step 2: Creating an Azure Bot Resource

Creating an Azure Bot resource is required to enable secure and seamless integration with Microsoft Teams. It:

  • Registers the bot with the Azure AI Bot Service for channel connectivity

  • Allows Microsoft Teams to verify and trust the bot within your tenant

  • Enables connection to the Kyvos Dialogs bot framework for message processing

  • Is required for deploying the Kyvos Dialogs bot as a Microsoft Teams application

Note

Without an Azure Bot resource, the bot cannot communicate with Microsoft Teams or be deployed within the Teams environment.

To create an Azure resource bot, refer to the section Create an Azure bot resource in Microsoft documentation and follow the instructions mentioned there.

image-20260226-183605.png

Note

Here,

  1. Select the Type of App as Single Tenant.

  2. Provide the App ID and App Tenant ID generated on registering the App in Step 1 above.

 

Once the deployment completes, click Go to resource. You should see the Kyvos Dialogs bot and related resources listed in the resource group you selected.

Step 2.1: Adding a messaging endpoint

Configuring the messaging endpoint specifies the HTTPS URL to which Microsoft Teams sends incoming bot messages. This endpoint enables the Bot Framework Service to securely forward user interactions to your bot application for processing.

  1. Copy the Kyvos Bot Server (https URL) https://FQDN:3978.

  2. On the Microsoft Azure portal, in the left pane, under Settings, select Configuration.

  3. Update the Messaging endpoint in the following format:
    https://FQDN:3978/api/messages

  4. Select Apply.
    You have successfully set up a bot in the Azure Bot Service.

    image-20260331-055029.png

Step 2.2: Adding an OAuth connection settings

Adding OAuth connection settings enables secure Single Sign-On (SSO) authentication between Microsoft Teams and your bot. It allows the bot to access protected resources on the user’s behalf using Azure Active Directory credentials and defined API scopes.

  1. In the left pane, select Configuration.

  2. Select Add OAuth Connection Settings.

  3. Under New Connection Setting, update the following details:

    • Name: Enter a name for your new connection setting. You can use the name in the settings of your bot service code.

    • Service Provider: From the dropdown list, select Azure Active Directory v2.

    • Client Id: Update your Microsoft App ID.

    • Client secret: Update the client secrets Value.

    • Tenant ID: Enter Tenant ID.

    • Scopes: Enter api://botid-<microsoft_app_id>/access_as_user

  4. Select Save.

    image-20260331-055132.png

The OAuth connection will be established on the Bot Server. The Bot framework will use this OAuth token.

Step 2.3: Adding a Microsoft Teams channel

Adding the Microsoft Teams channel connects your Azure Bot resource to the Teams platform, enabling users to interact with the bot within personal chats, group chats, and team channels. This step allows the bot to receive and respond to messages directly in Microsoft Teams.

  1. In the left pane, select Channels.

  2. Under Available Channels, select Microsoft Teams.

    image-20260318-092606.png

     

For more details, refer to the Microsoft Documentation

Step 3: Setting up Kyvos Dialogs app settings and manifest files on Microsoft Teams

Configuring the app settings ensures the Kyvos Dialogs bot is properly configured with the required environment variables, including the Microsoft App ID, client secret, tenant ID, and OAuth connection details. Updating the Teams app manifest defines how the Kyvos Dialogs bot integrates with Microsoft Teams, including scopes, permissions, and SSO configuration. Together, these settings enable secure authentication, correct routing, and successful deployment within Teams.

To configure the Kyvos Dialogs app settings and manifest file for Microsoft Teams, perform the following steps:

  1. Unzip the kyvosteamsapp.zip on your machine.

  2. Open the manifest.json file.

    image-20260330-142230.png

     

  3. In the file, search for the app_id and your_domain keywords. These are the placeholders.

  4. Replace the placeholders with:

    • Replace <app_id> with your Microsoft Application (Client) ID.

    • Replace <your_domain> with your FQDN.

  5. After updating the file, compress the following three files into a .zip file:

    • manifest.json

    • color.png

    • outline.png

  6. Sign in to Microsoft Teams Admin Center using administrator credentials.

  7. Upload the newly created zip file in the Teams Admin Center to publish the app. To do this, perform the following steps:

    1. In the left navigation pane, select Teams apps > Manage apps.

      image-20260302-082800.png

       

    2. On the Manage apps page, select Actions > Upload new app. The Upload a custom app dialog box is displayed.

      image-20260302-082907.png

       

    3. In the dialog box, click Upload to browse to the Kyvos Dialogs bot zipped app package and upload it. The Microsoft Teams app is registered upon successful upload.

      image-20260302-083148.png

       

  8. Search for the Dialogs application. The app details are available under the All apps tab.

    image-20260318-091815.png

     

  9. Navigate to the Users and groups tab and assign permissions to the required Kyvos users.

    image-20260318-092301.png

     

After permissions are granted, the Kyvos Dialogs Bot application appears in the Apps section of Microsoft Teams for authorized users.

On this page:

Copyright Kyvos, Inc. 2026. All rights reserved.