How to set up Microsoft Teams in Skyone Studio
Esta documentação descreve o processo completo para configurar a integração do Microsoft Teams no Skyone Studio. O objetivo é permitir que agentes inteligentes criados no Skyone Studio se comuniquem diretamente com usuários através de chats e canais no no ambiente Microsoft (Azure e Teams).
This documentation describes the complete process for configuring the Microsoft Teams integration in Skyone Studio. The goal is to allow intelligent agents created in Skyone Studio to communicate directly with users through chats and channels within the Microsoft environment (Azure and Teams).
Benefits:
Centralizes communication with AI agents within the Teams corporate environment.
Allows for proactive messaging and response automation.
Ensures secure integration using Microsoft authentication protocols.
Prerequisites and Permissions
1. Administrative and System Permissions
Administrative permissions in Azure.
Microsoft Teams Administrator profile.
AI Admin permission no Azure (to manage Resource Groups).
Azure Bot Service Contributor Role (mandatory for Bot creation).
Access to Bot Framework / Bot Service / Azure Bot.
2. Microsoft Graph Permissions (Configured in Azure):
During the application registration in Azure, you must provide the following permissions:
AppCatalog.ReadWrite.All: Allows publishing the bot to the Microsoft Teams app catalog.
TeamsAppInstallation.ReadWriteSelfForUser.All: Allows the installation of the bot for specific users.
Chat.ReadWrite.All: Ensures the bot can send and receive proactive messages in chats and channels.
User.Read.All: Allows reading profile information and bot usage logs.
3. Settings in Teams Admin Center:
It is necessary to allow the upload of custom apps (sideloading) by following this path:
Access Teams Admin Center → Teams apps → Setup policies.
Enable the Upload custom apps option.
Ensure the Apps menu is visible by enabling the Show app bar option.
Important Notes:
Accounts: You must use a corporate account with a .com.br domain. Custom domains or personal accounts are not accepted and may prevent bot validation.
Azure Providers: The Microsoft.BotService resource provider must be enabled in the Azure subscription used to avoid failures in bot creation. deve estar habilitado na assinatura Azure utilizada para evitar falhas na criação do bot.
Configuration Steps
To configure Microsoft Teams, you will need to switch between the Azure Portal, the Teams Admin Center, and Skyone Studio.
Steps:
Step 01: Register the application in Azure
Access the Azure Portal and go to App Registrations > New Registration.
In the Name field, enter an identification (e.g., Microsoft_Teams_Integration).
Under Supported account types, select Accounts in this organizational directory only (Single Tenant).
Click Register.
Step 02: Configure the Application
Still in the Azure Portal, go to App Registrations > Owned Applications.
Go to Certificates & Secrets > New client secret.
Define a description and the expiration time (maximum 6 months).
Important: Copy the Secret Value immediately, as it will be displayed only once and will be required in Skyone Studio.
Copy and save the Application (client) ID and the Directory (tenant) ID; we will use them in the next step.
Step 03: Create an Agent Flow
Access Skyone Studio and go to Agent Flow.
Click Create flow.
Add components as needed, ensuring an agent is configured in the
Step 04: Create a Microsoft Teams publication in Studio
Access Skyone Studio and go to Agent Flow.
Click Publish in the upper right corner.
Click Microsoft Teams.
Select a previously created Agent Flow.
Click Manage Accounts.
Click Create Account.
Enter the following data:
Name: Account name
Client ID: Application (client) ID
Client Secret: Secret generated in Step 2
Tenant ID: Directory (tenant) ID
Click Create.
Click Save Publication.
Copy and save the generated Webhook URL.
Step 05: Configure the Webhook URL in Azure
In the Azure Portal, go to App Registrations > Owned Applications.
Acesse Manage → Authentication (Preview).
Add the redirect URI:
Platform Web
Paste the Webhook URL collected from Skyone Studio
Step 06: Configure API permissions
In the side menu of the created application, access API Permissions > Add a permission.
Select Microsoft Graph and add the following application permissions:
AppCatalog.ReadWrite.All.
Chat.ReadWrite.All.
TeamsAppInstallation.ReadWriteSelfForUser.All.
User.Read.All.
Click Grant admin consent to activate permissions or wait for administrator approval.
Step 07: Create the Azure Bot
In the Portal Azure, access Bot Services
Click Create and then Azure Bot.
Fill in the fields according to the table below:
Bot handle: Ex.: teams-integration-bot.
Data residency: Global.
Pricing: Standard.
Microsoft App ID: Single Tenant.
Creation type: Use existing app registration.
App ID: The Application (client) ID from Step 02.
App tenant ID: The Directory (tenant) ID from Step 02.
4. Click Create to finish.
Step 08: Configure the Azure Bot
Access the created bot.
Access Configuration.
n the Messaging endpoint field, paste the Webhook URL generated in Skyone Studio (Step 04).
Click Save.
Step 09: Enable the Microsoft Teams channel
To enable the bot specifically for Teams:
Go to Channels.
Under Messaging, choose Microsoft Teams Commercial
Click Apply.
Step 10: Prepare the Manifest
Sideloading allows you to test the bot internally before its official release to the entire organization.
Sideload = local/individual test
Catalog Publication = official/organizational test
Create a file named
manifest.jsonusing the Microsoft standard template, inserting your Client ID in theidebotIdfields.
Every upload requires a version increment.
The manifest.json file defines how the application will be displayed in Microsoft Teams and what permissions it will use.
Prepare two icon images: color.png ($192\times192$ px) and outline.png ($32\times32$ px).
Select the three files (manifest.json, color.png e outline.png) and compress them into a .zip.
Compress the files directly, not the folder where they are located, to avoid read errors.
Step 11: Upload
As an admin, access the Microsoft Teams Admin Center.
Go to Teams apps > Setup policies
Select Global (Org-wide Default).
Enable Upload custom apps.
Without this activation, it will not be possible to load external applications in the environment.
Log in to Microsoft Teams (Web ou Desktop) using your Azure user account that has an active license.
Click the Applications icon, located in the left sidebar menu.
Select the Manage Your Applications option.
Click Upload an Application and then Upload a Custom Application.
Select the previously created .zip file (containing the manifest.json and images).
Confirm the information displayed on the home screen and click Add.
Step 12: Validate the integration
Open the chat with the bot and send a message like "Hello".
Please confirm that the message was correctly received by the flow configured in Skyone Studio via the registered webhook.
Receiving the response confirms that the integration between Microsoft Teams and Skyone Studio was completed successfully.
FAQ - Microsoft Teams Integrations
Can I use a personal account to set up Teams?
No. You need to use a corporate account with a domain (e.g., .com.br) linked to the organizational environment.
Last updated
Was this helpful?
