November 2026 release is live Read More

Set up Slack and Microsoft Teams bots

Connect a custom Agent Studio agent to a Slack workspace or a Microsoft Teams team. Each bot answers as one custom agent. Mavvrik admins set up and manage bots in Agent Studio.

Before setting up a bot

Make sure you have Mavvrik admin access and a custom agent. The Agent list shows custom agents. If you want the bot to use a built-in agent, clone that agent first and select the clone.

  • Slack. You need permission to create and install an app in the target Slack workspace. If the workspace requires app approval, request approval from a workspace admin.

  • Microsoft Teams. You need access to create an Azure Bot and a client secret for its Microsoft Entra app registration. You also need permission to install a custom Teams app in the target team, or help from a Teams admin.

Channel access. In a Slack or Teams channel, the bot uses the data and tools configured for its agent. Anyone who can mention the bot can ask it questions, and anyone who can read the channel can see its replies. Add the bot only to channels whose members are authorized to see the data it can return.

Set up a Slack bot

Add the bot in Agent Studio

  1. In Agent Studio, open the user menu at the bottom of the sidebar, select Settings, and then select Bots.

  2. Select Add bot. In Channel type, select Slack.

  3. In Bot name, enter the name to display in Slack, such as FinOps Bot. In Agent, select the custom agent that will answer questions.

  4. Select Create bot, then select Copy manifest. The manifest includes the event URL and the permissions the Slack app needs.

Create and install the Slack app

  1. Open Slack Your Apps. Select Create New App and then From a manifest.

  2. Select the workspace where the bot will run. Paste the Agent Studio manifest into the JSON tab, then select Next and Create.

  3. In the Slack app settings, select OAuth & Permissions and then Install to Workspace. Review and authorize the requested permissions.

  4. Under OAuth & Permissions, copy the Bot User OAuth Token. It starts with xoxb-. Under Basic Information, copy the Signing Secret from App Credentials.

  5. Return to Agent Studio and select Next. Paste the token into Bot token and the signing secret into Signing secret.

  6. Select Verify & activate. After Agent Studio verifies the credentials, select Done. The Status column shows a check mark when the bot is active.

  7. In Slack, add the bot to the intended channel. Mention it in a message and ask a question the selected agent can answer. Confirm that the bot replies in the channel.

To connect another agent in the same Slack workspace, repeat the setup with a separate bot and Slack app.

Set up a Microsoft Teams bot

Add the bot in Agent Studio

  1. In Agent Studio, open the user menu at the bottom of the sidebar, select Settings, and then select Bots.

  2. Select Add bot. In Channel type, select Microsoft Teams.

  3. In Bot name, enter the name to display in Agent Studio. The display name in Teams comes from the Teams app. In Agent, select the custom agent that will answer questions.

  4. Select Create bot, then select Copy endpoint to copy the Messaging endpoint shown in the setup.

Configure the Azure Bot and save its credentials

  1. In the Azure portal, create an Azure Bot with the Single Tenant app type. From the bot’s configuration or associated Microsoft Entra app registration, copy the Microsoft App ID (the Application (client) ID) and the App Tenant ID (the Directory (tenant) ID).

  2. In the Microsoft Entra app registration, open Certificates & secrets and create a client secret. Copy the secret’s Value when it appears. Azure displays the value only once.

  3. In the Azure Bot resource, open Configuration and paste the URL from Agent Studio into Messaging endpoint. Save the change. Open Channels and enable the Microsoft Teams channel.

  4. In Agent Studio, select Next. Enter the Microsoft App ID, App Tenant ID, and Client secret.

  5. Select Verify & activate and then Done. The bot stays pending until it receives its first message from Teams.

Install the Teams app and test the bot

  1. If a Teams app package is already available for this bot, use that package. Otherwise, create an app in the Developer Portal for Teams. Under App features, add a bot, associate it with the Microsoft App ID from Azure, and enable the Team scope. Complete the required app details and download the app package. See Connect a bot to Microsoft Teams for Microsoft’s setup instructions.

  2. In Teams, upload the app package and add the app to the target team. If custom app uploads are restricted, ask a Teams admin to make the app available to the team.

  3. In a channel in that team, mention the bot and ask a test question. Confirm that it replies in Teams and that the Status column in Agent Studio shows a check mark.

Resume an unfinished setup

Select Finish later to leave setup without losing the bot record. To resume, open Settings and select Bots. Select Finish setup in the bot’s row, then select Finish setup in the edit dialog. For Slack, setup resumes at the manifest. For Teams, setup resumes at the messaging endpoint.

Manage a bot

Open Settings, select Bots, and open the three-dot menu next to the bot.

  • Select Edit to change the bot name in Agent Studio or select a different custom agent, then select Save. The channel type is fixed at creation.

  • Select Pause to stop an active bot from answering. Select Resume to reactivate a paused bot.

  • Select Delete to remove the bot from Agent Studio. Enter the bot’s name in the confirmation dialog and confirm the deletion.

Replace Slack credentials

  1. After rotating the credentials in Slack, open the bot’s three-dot menu in Settings > Bots, and select Edit.

  2. Select Replace credentials…. Enter the new Bot token and Signing secret.

  3. Select Verify & save. Then mention the bot in Slack to confirm that it can answer. Agent Studio does not display saved credentials.

Check the bot’s status

  • A check mark indicates that the bot is active.

  • Finish setup indicates that setup is incomplete. If the Teams credentials have already been saved, mention the bot in Teams to complete activation.

  • Disabled indicates that the bot is paused. Select Resume from the bot’s three-dot menu to reactivate it.