Skip to main content

Microsoft Teams 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​

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.

PermissionTypeRationale
User.ReadDelegatedUsed to identify the user and match their email address.
Chat.ReadWriteDelegatedRequired to send and receive messages and interactive cards.
TeamsAppInstallation.ReadWriteSelfForUserDelegatedAllows the app to install itself for the user during connection.
TeamsAppInstallation.ReadWriteForUser.AllApplication(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.

Troubleshooting Guide​

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

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