Notification Source Integration

Integration for Slack

Beezi is not just a chatbot; it is a full-cycle coding application that integrates directly into your workspace. By connecting Slack, you enable Beezi to report on coding progress, notify you of Pull Requests, and allow you to manage tickets without leaving your chat environment.

Pricing & Availability

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

1. Installation & Configuration

To maintain security and proper workspace mapping, the Slack integration cannot be installed via the Slack Marketplace. It must be initiated directly from the Beezi platform. To maintain security and proper workspace mapping, the Slack integration cannot be installed via the Slack Marketplace. It must be initiated directly from the Beezi platform.

Who Can Configure the Integration

Connecting a Slack workspace to a project requires administrative privileges. This action can be performed by the following roles:

• Owner
• Tenant Admin
• Project Admin

Once connected by an administrator, the integration applies to the project, allowing the entire team to utilize the Beezi application.

How to Connect

There are two ways to activate the integration: during the initial setup or later via the Notifications panel.

Method A: During Onboarding

When setting up a Tenant or a Project, you will reach the Notifications step:

1. Locate the Slack card.
2. Click the Connect button.
3. You will be redirected to the Slack authorization page.
4. Select the target workspace and click Allow to grant Beezi access.

Upon success, the Beezi App will be added to your workspace.

Method B: Via Settings

If you skipped this step during the initial setup, the process depends on the current state of the project integration:

Scenario 1: Workspace Not Connected

If no Slack workspace has been connected to the project yet:

1. Log in to Beezi and navigate to Notifications.
2. On the Slack card, click the Connect button.
3. Follow the authorization flow described in Method A to link the workspace.

Scenario 2: Workspace Connected (Link User Only)

If an admin has already connected the workspace but your user identity was not linked automatically:

1. Log in to Beezi and navigate to Notifications.
2. On the Slack card, click the three-dot menu and select Enter User ID.
3. Paste your Slack Member ID (see instructions below) to manually link your user profile.

NOTE

The "Enter User ID" option appears only when Slack is configured for the project but your user identity is not yet linked (Pending status). The Slack connection is project-scoped, meaning each project maintains its own Slack workspace connection and user mappings.

2. User Identification (Matching Logic)

To ensure Beezi sends notifications to the correct person in Slack, the system matches users by email address.

Automatic Connection

If your email address in Beezi exactly matches the one in your Slack profile, the connection is established automatically. You do not need to perform any additional actions. Once the Owner or Admin connects the workspace, you will start receiving notifications immediately.

Manual Connection (Member ID)

If your email addresses differ (e.g., you use a corporate email for Beezi but a different alias or domain in Slack), you must manually link your accounts using your Slack Member ID.

How to link manually:

1. Open Slack.
2. Click on your profile picture and select Profile.
3. Click the three dots ("More") menu and select Copy Member ID.
4. Log in to Beezi and go to User Profile Settings.
5. Paste the copied ID into the Slack Member ID field and save.

IMPORTANT

If you belong to multiple Slack workspaces, ensure you copy the Member ID from the specific workspace that has been connected to your Beezi project. Member IDs are unique to each workspace.

For Invited Team Members

When an Administrator connects Slack to a project, the setting applies to the entire team. Users with matching emails gain access automatically. Users with non-matching emails must log in to their Beezi profile and add their Slack Member ID manually to enable notifications.

3. Features & Workflow

Smart Notifications

Beezi integrates with your workflow to keep you informed. You will receive Beezi App direct messages in Slack for the following events:

• Task Assignments: When a task is assigned to you.
• Code Generation Updates: Real-time statuses including processing start times (CODE_GEN Started), completion alerts, and implementation results.
• Pull Request Updates: Instant links to review Pull Requests created by Beezi.
• Task Status Changes: Updates when tasks move through the workflow (e.g., To Do → In Progress).

You can customize which notifications you receive by adjusting your preferences in the Notification Settings page.

Interactive Agent Workflow

Beezi interacts with you proactively to ensure high-quality code generation.

1. Clarification Requests (When context is missing)

If a task description lacks sufficient detail, Beezi will pause and ask clarifying technical questions directly in Slack.

• Action: Reply to the thread with the necessary details.
• Benefit: Prevents "hallucinations" and ensures the code meets your specific requirements.

2. Implementation Plan Review (When context is sufficient)

Before writing any code, Beezi generates a high-level Implementation Plan outlining the proposed changes.

• What you receive: A message detailing the files to be modified and the logic Beezi intends to apply.
• Action: Review the plan. This gives you an opportunity to verify the technical approach before the actual coding begins.

Interactive Actions

Beyond notifications, Beezi provides interactive buttons and forms directly in Slack for real-time collaboration:

Plan Management

• Approve Plan: Review and approve the AI-generated implementation plan before code generation begins.
• Modify Plan: Request changes to the proposed implementation approach.

Code Review Actions

• Retry Estimation: Re-run the task estimation if results are unsatisfactory.
• Retry Task: Restart a failed or incomplete task.

Queue Management

• Add to Queue: Add a task to your processing queue.
• Dismiss: Remove a notification from your queue.

Comment Management

• Select Comments: Choose specific PR comments to address.
• Resolve Comments: Mark PR comments as resolved directly from Slack.

These interactive elements appear as buttons within Slack messages, allowing you to manage your development workflow without switching contexts.

Slash Commands

Command: /help

• Aliases: /beezi-help
• Description: Displays a list of available Slack commands and their descriptions. Use this to quickly see what actions you can perform.
• Usage: Type /help in the Beezi App Slack message.

Command: /create-ticket

• Aliases: /ct, /new-ticket
• Description: Create a new ticket directly from Slack. This opens an interactive modal where you can specify ticket details.
• Usage: Type /create-ticket in the Beezi App Slack message.

Features:

• Project Selection: Choose from your assigned projects.
• Title: Required field for the ticket title (max 500 characters).
• Description: Required field for ticket details (max 3000 characters).
• Attachments: Optional file uploads (supports pdf, doc, docx, txt, png, jpg, jpeg, gif; up to 5 files).
• Repository Tag: Select from connected repository labels.
• Board Integration: Option to create the ticket on your project board (JIRA/Azure DevOps).
• Assignee Selection: Assign to a team member or leave unassigned.
• Smart Defaults: Pre-selects the first available project.

Requirements:

• You must be connected to the system (Slack account linked) and have access to at least one project with connected repositories.

4. Permissions & Security

Beezi requests the minimum permissions required to function as an application within your workspace.

Permission	Description	Rationale
channels:history	View messages and other content in public channels that "Beezi AI" has been added to	To understand the context of a task, Beezi needs to read messages in public channels where it has been mentioned or added. This is essential for clarifying ticket requirements.
channels:read	View basic information about public channels in a workspace	To allow users to configure where Beezi sends notifications, our app needs to display a list of available public channels within its settings.
chat:write	Send messages as @Beezi AI	This is the core function of our app. Beezi needs this permission to send messages to users, such as asking clarifying questions, providing status updates on tasks, and sending notifications when a Pull Request is ready.
chat:write.public	Send messages to channels @Beezi AI isn't a member of	This allows Beezi to post results (e.g., a link to a new PR) into a relevant public project channel, even if the task was initiated from a direct message, ensuring team-wide visibility.
commands	Add shortcuts and/or slash commands that people can use	Enables slash commands like /create-ticket to allow fast, in-context ticket creation directly from Slack App conversations.
files:read	View files shared in channels and conversations that "Beezi AI" has been added to	Required to read files shared in channels and conversations that "Beezi AI" has been added to.
files:write	Upload, edit, and delete files as "Beezi AI"	Beezi uses this permission to upload files relevant to a task, such as generated reports, log files, or code snippets, directly into the conversation for the user's convenience.
im:history	View messages and other content in direct messages that "Beezi AI" has been added to	To maintain conversational context, Beezi reads the history of its own Direct Messages with a user. The app exclusively accesses conversations addressed to itself and does not read any private user-to-user DMs.
im:read	View basic information about direct messages that "Beezi AI" has been added to	This permission is used to identify the Direct Message conversations that Beezi is a part of, which is necessary for managing its interactions.
users:read	View people in a workspace	Beezi needs to access a list of users in the workspace to allow users to mention teammates (e.g., "@Beezi, ask @Jane for details") and for correct user mapping.
users:read.email	View email addresses of people in a workspace	We use the user's email address as a unique identifier to reliably map their Slack account to their account in other connected tools, like Jira or GitHub. We are not storing the user's emails and not sending emails to them, only mapping.
pins.write	Pin messages in channels and conversations that "Beezi AI" has been added to	This permission allows Beezi to pin specific messages for the user, ensuring that critical task requirements and key AI-generated updates remain highly visible within the Slack channel.

Data Collection & Privacy

When you connect Slack to Beezi, we collect and process:

• Your Slack user ID and email address (for account matching).
• Access tokens (to send direct messages on your behalf).
• Message delivery status and interaction metadata.

All data is stored securely using industry-standard encryption and is used solely to provide notification services. We do not read or store your Slack messages that are unrelated to specific tasks for which the app was explicitly invoked.

5. Important Information

AI-Generated Content Disclaimer

Beezi uses artificial intelligence (AI) and Large Language Models (LLMs) to assist with code generation and task implementation through our CODE_GEN feature.

IMPORTANT

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

• Generated code should always be reviewed and tested before deployment.
• AI-generated implementations may not follow your specific coding standards or best practices.
• The AI may misunderstand task requirements or generate code with bugs or security vulnerabilities.
• Notifications about task completion or implementation details are based on AI-generated analysis.

Best Practices

• Always review pull requests created by CODE_GEN before merging.
• Run tests and validation checks on AI-generated code.
• Provide clear, detailed task descriptions for better results.
• Use the feedback system to improve future AI responses.

By using Beezi’s AI features, you acknowledge that you understand the limitations of AI-generated content and will exercise appropriate oversight and validation.