What you can do in Teams
The conversation model
Bugzy interacts via the inbox agent conversation model:- An event triggers Bugzy (message, webhook, schedule)
- Bugzy proposes an action in the channel: “I’d like to run smoke tests on the checkout flow. Should I proceed?”
- A team member responds (thumbs up, “yes”, or custom instructions)
- Bugzy executes and posts results in the same thread
Disputed findings
When Bugzy reports a finding that’s incorrect:- Reply to the finding message with your reasoning
- Bugzy’s
handle-messagetask processes the reply - If the dispute is valid, the finding is updated
- Knowledge base adjusted to avoid similar false positives
- Bugzy confirms the resolution in the thread
Setup
1
Ensure bot is installed
Your organization’s Teams admin must install the Bugzy bot in your Teams tenant. This is a one-time setup for the entire organization.
2
Add bot to your team
In Microsoft Teams, go to Apps, find the Bugzy bot, and add it to your team.
3
Get your BUGZY_CONNECT code
In the Bugzy dashboard, go to Dashboard > Projects > [Your Project] > Connections and click Connect Teams. Copy the generated code.
4
Link the channel
In the Teams channel you want to connect, mention the Bugzy bot and paste your
BUGZY_CONNECT code. The bot will confirm the link.Each Teams channel links to exactly one Bugzy project. To connect multiple projects, use different channels.
Admin setup
The Azure Bot registration is a one-time platform-level setup performed by an organization admin:- Register an application in Microsoft Entra (Azure AD)
- Create a client secret for the application
- Create an Azure Bot resource linked to the application
- Enable the Microsoft Teams channel on the bot
- Set the messaging endpoint to the Bugzy webhook URL
- Install the bot in your Teams tenant
End users do not need admin access. After the initial bot setup, connecting projects is as simple as generating and pasting a
BUGZY_CONNECT code.Troubleshooting
Bot not responding — Verify the bot has been added to the team and channel. Check with your Teams admin that the Azure Bot is configured correctly. Channel not linked — Re-run theBUGZY_CONNECT flow from the project connections page. Ensure the code was sent in the correct channel.
Messages not reaching Bugzy — Confirm the channel-to-project link is active in the dashboard. Check that the bot has not been removed from the team.