Integration for Microsoft Teams

Beezi is a full-cycle AI orchestration platform that integrates directly into your Microsoft Teams workspace. By connecting Teams, you enable Beezi to send real-time notifications about task progress, implementation plans, and Pull Requests — allowing you to collaborate with AI agents without leaving your chat environment.

Pricing & Availability

The Microsoft Teams integration is a core feature included in both Free and Pro plans at no additional cost.

1. Installation & Configuration

To maintain security and proper organization mapping, the Microsoft Teams integration follows a two-stage authorization process: Administrator Consent and User Connection.

Who Can Configure the Integration

• Tenant Administrator: Must grant organization-wide consent to allow the Beezi application to interact with your Microsoft Teams tenant.
• Individual Users: Must connect their personal Beezi account to Microsoft Teams and set up the Beezi AI Agent in a team channel.

How to Connect

Step 1: Organization-Wide Admin Consent (Required First)

IMPORTANT

Before any team member can use Beezi in Microsoft Teams, a Tenant Administrator must grant permissions. This is typically done during the initial Beezi onboarding process.

1. During onboarding or later in the Beezi platform, navigate to Notifications settings.
2. Select Microsoft Teams as your communication channel.
3. Click Grant Admin Consent.
4. You will be redirected to the Microsoft login page. Sign in with a Tenant Administrator account (Global Admin or Privileged Role Administrator).
5. Review the requested permissions and click Accept. This registers Beezi in your Microsoft Entra ID (former Azure AD).
6. Click Continue to proceed.

What This Enables: This permission allows Beezi to send messages and process user commands within your Microsoft Teams environment. Once granted, all team members can connect their individual accounts.

Step 2: Connecting Your User Account

After the administrator has granted tenant-wide consent, individual users must connect their Beezi account to Microsoft Teams.

1. In the Beezi web application, navigate to Notifications.
2. On the Microsoft Teams card, click Connect.
3. Sign into your Microsoft account and follow the prompts to authorize the connection.

Step 3: Setting Up the Beezi AI Agent in Teams

Now that your account is connected, you need to set up a dedicated workspace in Microsoft Teams where Beezi will send notifications and interact with your team.

1. Create a Team: In Microsoft Teams, create a new team. This will serve as the workspace where Beezi collaborates with you.
2. Create a Channel: Inside that team, create a new channel. This channel will be the main communication hub where task updates and Beezi interactions take place.
3. Important: Make sure the channel type is set to Standard.
4. Add the Beezi App: Open the Apps section in Microsoft Teams, search for "Beezi AI Agent", and add it directly to the channel you just created.
5. Activate the Connection: Tag the @Beezi AI Agent in the channel (by typing @ followed by "Beezi"). This activates the connection.

Once activated, the Beezi bot will send you a confirmation message in Teams, and you'll start receiving real-time task updates directly in the channel.

2. User Identification & Matching

Beezi ensures notifications reach the correct person by matching your Beezi email address with your Microsoft Teams account profile.

Automatic Mapping

The system stores a Conversation Reference the moment you connect your account. This allows Beezi to send you proactive notifications (direct messages) even if you haven't interacted with the bot recently.

Troubleshooting Connections

If you are not receiving messages, ensure your email address in Microsoft 365 matches the email used to register your Beezi account. If they differ, you may need to re-run the "Connect" flow from your Beezi Notifications settings.

3. Features & Workflow

Smart Notifications

You will receive Beezi notifications in the Teams channel and direct messages for the following events:

• Task Assignments: When a new ticket is assigned to Beezi in your project management tool.
• Code Generation Updates: Real-time status alerts for AI code generation.
• Pull Request Notifications: Instant links to review Pull Requests created by the AI Agent.

Interactive Agent Workflow

Beezi interacts with you through Adaptive Cards — rich, interactive messages that allow for real-time collaboration:

1. Clarification Requests: If a task lacks sufficient detail, Beezi will ask technical questions directly in the Teams channel.
2. Implementation Plan Review: Review and Approve or Modify the AI's technical approach before any code is written.

Available Commands

You can interact with the Beezi bot using the following commands in the Teams channel:

• hello: Triggers a greeting and verifies that your connection is active.
• /help: Displays a list of all available commands and their descriptions.
• /create-ticket: Opens an interactive modal within Teams to create a new ticket (Title, Description, Priority, and Project selection) without switching apps.

4. Permissions & Security

Beezi requests the minimum permissions required to manage installations and messaging via the Microsoft Graph API.

Permission	Type	Rationale
User.Read	Delegated	Used to identify the user and match their email address.
Chat.ReadWrite	Delegated	Required to send and receive messages and interactive cards.
TeamsAppInstallation.ReadWriteSelfForUser	Delegated	Allows the app to install itself for the user during connection.
TeamsAppInstallation.ReadWriteForUser.All	Application	(Admin Only) Allows the system to manage app installations across the organization.

5. Important Information

AI-Generated Content Disclaimer

Beezi uses Artificial Intelligence (AI) to interpret tasks and generate code.

IMPORTANT

While our AI strives for accuracy, it may occasionally generate incorrect or suboptimal responses. Please be aware:

• Verification: Always review Pull Requests and code generated by Beezi before merging into production.
• Context: Ensure your tickets have clear descriptions and requirements. Better input leads to more accurate AI implementation plans and code generation.

6. Troubleshooting

Common Issues and Solutions

This guide helps resolve the most common issues when connecting and using Beezi with Microsoft Teams.

Issue 1: Not Receiving Notifications in Teams

Symptoms

• Tasks are handed to Beezi in Jira/Azure DevOps but no notifications appear in Teams
• Other team members receive notifications but you don't
• Bot was working before but stopped sending messages

Possible Causes & Solutions

Check 1: Verify Your Account Connection

Problem: Your Beezi account is not connected to Microsoft Teams.

Solution:

1. Log into Beezi platform app.beezi.ai
2. Go to Notifications
3. Check the Microsoft Teams card status
4. If it shows "Not Connected" or "Pending", click Connect and complete the authentication flow
5. After connecting, you should receive a confirmation message in Teams

Check 2: Email Address Mismatch

Problem: Your email address in Beezi doesn't match your Microsoft 365 email address.

Solution:

1. In Beezi: Check your email under Profile (click user avatar)
2. In Microsoft 365: Check your email in Microsoft 365 profile or ask your admin
3. If they don't match:
   • Update your Beezi email to match Microsoft 365 by creating a new account
4. After creating a new account in Beezi, complete the authentication and integration flow

Example:

• ❌ Beezi: john@gmail.com, Microsoft 365: john.doe@company.com → Won't work
• ✅ Beezi: john.doe@company.com, Microsoft 365: john.doe@company.com → Will work

✓ Check 3: Not a Member of the Teams Channel (when your team sets up a shared channel)

Problem: The Beezi bot is installed in a channel, but you're not a member.

Solution:

1. Open Microsoft Teams
2. Navigate to the team where Beezi is installed
3. Check if you can see the channel where the bot is active
4. If not, ask the team owner to add you to the channel
5. Once added, notifications should start appearing

Issue 2: Bot Not Responding to Commands

Symptoms

• You type /help or hello but the bot doesn't respond
• The bot worked yesterday but stopped responding today
• Other users' commands work but yours don't

Possible Causes & Solutions

✓ Solution 1: Wait and Retry

Sometimes there's a delay:

1. Wait 30 seconds after typing the command
2. If no response, try again
3. Make sure you're typing in the correct channel where the bot is installed

✓ Solution 2: Reconnect Your Account

1. Go to Beezi → Notifications
2. Click Reconnect on Teams integration
3. Complete authentication
4. Return to Teams and try the command again

Issue 3: "Access Denied" During Admin Consent

Symptoms

• "You need admin approval to access this app"

Possible Causes & Solutions

✓ Solution 1: Verify Admin Role

Problem: The account doesn't have sufficient permissions.

Who can grant consent:

• ✅ Global Administrator
• ✅ Privileged Role Administrator
• ✅ Cloud Application Administrator
• ❌ Regular users cannot grant tenant-wide consent

Solution:

1. Sign out from Microsoft
2. Sign in with an account that has one of the roles above
3. Retry the consent flow

✓ Solution 2: Check Tenant Settings

Problem: Your organization blocks third-party app consent.

Solution (requires admin):

1. Go to Microsoft Entra ID (Azure AD)
2. Navigate to Enterprise Applications → Consent and permissions
3. Check User consent settings
4. Ensure "Allow user consent for apps" is enabled OR
5. Enable the admin consent workflow so admins can approve

If your org has strict policies:

• Contact your IT security team
• Provide them with Beezi's permission list
• They may need to whitelist Beezi manually

7. Getting Help

If you encounter issues not covered in this troubleshooting guide:

• Support Email: hello@beezi.ai
• Check Beezi Status: Verify no ongoing service issues