The Microsoft Teams integration enables users to interact with the AIW application through a Teams chatbot. This integration allows both Analysts and End Users to perform the same actions available in the web interface directly within Teams. The setup is performed by a Teams Admin, while usage is available to all supported personas.
This article includes the below:
Setup and Configuration
The Setup and Configuration process enables administrators to integrate the AIW chatbot with Microsoft Teams, making it accessible to all organizational users. This process ensures that the chatbot is properly installed within Teams and ready for use by analysts and end users.
Administrators enable the AIW Teams chatbot for organizational users by installing and configuring the application.
Prerequisites
Teams Admin access (IT Admin / DevOps / Cloud team)
AIW Teams bot package (ZIP file provided by the application team)
Azure Bot Setup
Configuration
The Configuration step involves installing the AIW chatbot in Microsoft Teams by uploading the application package. This step ensures that the chatbot is successfully added to the organization’s Teams environment and becomes available for user interaction. During configuration, the administrator logs into Microsoft Teams, navigates to the app management section, and uploads the provided ZIP file.
To configure AIW to teams, perform the following steps:
Log in as an Administrator and open Microsoft Teams.
Navigate to Apps > Manage your Apps.
Click Upload an App.
Upload the provided .ZIP file.
Complete the installation.
Note
Only Teams Admins can upload the app; normal users do not have permission.
Key Notes for Admin
The app is not published to the Teams App Store; it is distributed as a ZIP file.
Only two actions required:
Upload app
Azure Bot Service Setup
Azure Bot Setup
The Azure Bot setup is a mandatory prerequisite for enabling communication between Microsoft Teams and the AIW platform. This process is performed by the customer’s Azure/IT Admin, who creates and configures the bot within their Azure environment.
Prerequisites
Before proceeding, ensure the following:
User must have Azure Portal access with administrator privileges
Permission to create Azure Bot Service and App Registration
Messaging Endpoint URL (provided by SymphonyAI)
Configuration Steps
To create and configure an Azure Bot resource in order to establish the integration endpoint, perform the following steps:
Log in to the Azure Portal.
Search for and select Azure Bot Service.
Click Create and provide the following details:
Bot Name: Enter a name for the Bot service.
Description: Describe about the bot service (for example: AIW Bot).
Navigate to Configuration and perform the following:
Set Bot Type to Single Tenant.
Create a new App Registration.
Enter the Messaging Endpoint URL (provided by SymphonyAI) .
Click Channels and perform the following:
Select Microsoft Teams.
Enable and save the configuration.
Note
Other fields such as OAuth settings, schema versions, and additional configurations can be left as default.
Figure: Azure
Generate a client secret for secure authentication between the bot and backend services.
Navigate to the App Registration created in Step 1.
Go to Certificates & Secrets.
Click New Client Secret.
Provide:
Description
Expiration duration
Click Add.
Important:
Copy the secret value immediately and store it securely.
Figure: Client Secret
Grant required Microsoft Graph permissions to enable user-level access.
Go to App Registration > API Permissions.
Click Add Permission.
Select Microsoft Graph.
Select User.Read.All and click Add Permissions.
Click Grant Admin Consent to finalize.
Figure: API Permission
After completing the setup, share the following details with the SymphonyAI team:
Application (Client) ID
Client Secret
Tenant ID
These credentials are required to connect the Azure Bot with the AIW backend services.
Notes
The customer fully owns the Azure configuration, removing the need for external approval workflows.
Only the following configurations are required:
Azure Bot setup
Client secret creation
API permission configuration
No additional Azure settings (authentication, token config, OAuth connections) are required.
Outcome
Once the above steps are completed:
The Azure Bot is successfully connected to Microsoft Teams
Secure communication is established with AIW backend services
Users can interact with the AIW chatbot directly within Teams
User Interaction
The Microsoft Teams integration enables analysts to seamlessly interact with the AIW application through a chatbot interface within Teams. Once the integration is set up by the admin, analysts can access the AIW bot directly from Teams and use it for their daily operations without needing to switch to the web application.
To interact with AIW through teams chat, perform the following steps:
Log in and open Microsoft Teams.
Locate the installed AIW chatbot.
Open the chat window and enter the required prompt.
Note
Live Agent Transfer (LAT) will not be supported for MS Teams Integration.