# Integrating with Slack

Bito AI Assistant brings powerful AI capabilities directly into your Slack workspace. Instead of switching between apps or losing context, you get instant AI assistance right where your team collaborates.

Ask Bito to summarize lengthy threads, analyze code snippets, provide technical guidance, or help with planning. Bito reads the full thread context, understands shared files, and automatically pulls in information from Jira tickets and Confluence pages when you reference them.

With Bito in your Slack channels, you save time catching up on discussions, make faster technical decisions, and keep your team's knowledge accessible.

Click the button to add the Bito AI Assistant to your Slack. [<img src="https://platform.slack-edge.com/img/add_to_slack.png" alt="Add to Slack" data-size="original">](https://slack.com/oauth/v2/authorize?client_id=2061955158613.10908115946784\&scope=users:read.email,app_mentions:read,channels:history,channels:read,chat:write,files:read,files:write,groups:history,groups:read,im:history,im:read,mpim:history,mpim:read,reactions:write,users:read\&user_scope=)

## Prerequisites

Before you install Bito AI Assistant, ensure you have:

* A [**Bito account**](https://alpha.bito.ai/home/welcome) with an active paid plan that includes Bito AI Assistant for Slack
* **AI Architect** set up for your Bito account:
  * [Bito-hosted](https://docs.bito.ai/ai-architect/installation/install-ai-architect-bito-hosted) (Fully managed by Bito — no infrastructure setup required)
  * [Self-hosted](https://docs.bito.ai/ai-architect/installation/install-ai-architect-self-hosted) (Run AI Architect on your own infrastructure for maximum control)
* **Slack admin permissions** to install apps in your workspace

## Installation steps

Installation takes less than 2 minutes. Once complete, every team member in invited channels can interact with Bito.

{% stepper %}
{% step %}

### **Add the app to Slack**

1. Go to [bitoaiassistant.bito.ai/slack/install](https://bitoaiassistant.bito.ai/slack/install)
2. Review the permissions and click **Allow**
3. Connect your Bito account when prompted
   {% endstep %}

{% step %}

### **Invite Bito to channels**

1. Open any Slack channel where you want AI assistance
2. Invite Bito's AI Assistant to a channel by typing `@Bito` followed by your query. Slack will automatically prompt you to add Bito to the channel if it isn't already there, click **Yes** to add it and get your answer, or dismiss the prompt to skip.
3. Repeat for each channel (both public and private channels work)
   {% endstep %}

{% step %}

### **Start using Bito**

1. In any channel where you invited Bito, type `@Bito` followed by your question
2. Bito reads the thread and responds with context-aware answers
   {% endstep %}
   {% endstepper %}

## How to use Bito AI Assistant

#### Basic usage

Mention `@Bito` in any message to get AI assistance. Bito reads the entire conversation thread, not just your message, so it understands the full context.

**Example:**

```
@Bito Based on the above discussion create a plan
```

Bito analyzes the thread and generates a structured, actionable plan based on the discussion.

#### Asking questions

You can ask Bito questions in natural language. Be specific about what you need:

**Good questions:**

* `@Bito PROJ-456 is causing errors in production — here are the logs. Identify the root cause?`
* `@Bito help us break this feature into smaller tasks`
* `@Bito explain the difference between these two approaches`
* `@Bito what are the action items from this thread?`
* `@Bito review the code changes in this thread and suggest improvements`

**Tips for better responses:**

* Ask specific questions rather than general ones
* Reference what you're asking about if the thread contains multiple topics
* Use follow-up questions to dive deeper into a response

#### Working with files

When you share files in a Slack thread, Bito automatically processes them and incorporates their content into its responses.

**Supported file types:**

* Code files (.py, .js, .java, etc.)
* Configuration files (.yaml, .json, .xml)
* Documents (.txt, .md, .pdf)
* Log files

**Example workflow:**

1. Upload a config file to the channel
2. Ask: `@Bito review this configuration and suggest improvements`
3. Bito reads the file and provides specific recommendations

#### Understanding integrations

Bito automatically detects and incorporates information from:

**Jira tickets**

* Mention a ticket ID like `PROJ-123` in your conversation
* Bito recognizes the reference and pulls in context from that ticket

**Confluence pages**

* Paste a Confluence link in your discussion
* Bito reads the linked page and factors it into its response

You don't need to do anything special — just mention or paste the link as you normally would.

## Common use cases

#### Catch up on long threads

You return from vacation to find 100+ messages in a project channel.

**What to do:**

```
@Bito summarize the last 3 days of discussion and highlight any decisions that need my input
```

**What you get:**

* Key points from the conversation
* Decisions already made
* Open questions requiring your attention

#### Review code and technical decisions

Your team discusses two different architectural approaches.

**What to do:**

1. Share code snippets for both approaches
2. Ask: `@Bito compare these two approaches and explain the trade-offs`

**What you get:**

* Analysis of each approach
* Pros and cons
* Recommendations based on the discussion context

#### Extract action items

After a long planning discussion, you need to know what comes next.

**What to do:**

```
@Bito list all action items from this thread with who's responsible
```

**What you get:**

* Organized list of tasks
* Assignments (when mentioned in the thread)
* Priorities or deadlines discussed

#### Break down complex work

Your team needs to implement a new feature but isn't sure where to start.

**What to do:**

```
@Bito help us break down this feature into implementable tasks
```

**What you get:**

* Suggested task breakdown
* Logical sequencing
* Considerations from your team's discussion

#### Pull context from tickets

You're discussing a bug that relates to an existing Jira ticket.

**What to do:**

1. Mention the ticket: "This might be related to PROJ-456"
2. Ask: `@Bito what's the background on PROJ-456 and how does it relate to this issue?`

**What you get:**

* Summary of the referenced ticket
* Connection to current discussion
* Relevant history or context

#### Turn plans into code

Your team has discussed and finalized an implementation plan in a thread and wants to move straight to coding.

**What to do:**

```
@Bito based on the implementation plan above, create a new branch and make the code changes
```

**What you get:**

1. A new branch created from your default branch
2. Code changes implemented following the agreed plan
3. Changes aligned with your existing codebase patterns and conventions

## Best practices

#### Get the most from Bito

**Do:**

* ✅ Ask specific, focused questions
* ✅ Use Bito in threads where team discussions happen
* ✅ Reference files and tickets to give Bito more context
* ✅ Ask follow-up questions to clarify responses
* ✅ Use Bito to document decisions by asking for summaries

**Don't:**

* ❌ Ask multiple unrelated questions in one message
* ❌ Expect Bito to make decisions for you — use it to inform your decisions
* ❌ Share sensitive credentials or secrets in threads (Bito reads all messages)

## Privacy and context

**What Bito can see:**

* All messages in the current thread
* Files shared in the thread
* Content from referenced Jira/Confluence links (if connected)

**What Bito cannot see:**

* Messages in channels where it hasn't been invited
* Direct messages between users
* Private channels where it's not a member

Always invite Bito only to channels where AI assistance is appropriate for your team's privacy requirements.

## Troubleshooting

#### Bito doesn't respond

**Check:**

1. Did you invite Bito to this channel? If not, invite Bito's AI Assistant to a channel by typing `@Bito` followed by your query. Slack will automatically prompt you to add Bito to the channel if it isn't already there, click **Yes** to add it and get your answer, or dismiss the prompt to skip.
2. Did you mention `@Bito` at the start of your message?
3. Is your Bito subscription active and does it include Bito AI Assistant for Slack?

**Solution:** Verify Bito is in the channel members list. If not, invite it again.

#### Bito's response seems incomplete

**Possible reasons:**

* The thread context is very long
* Multiple topics are discussed simultaneously

**Solution:**

* Ask more specific questions that focus on one aspect
* Reference the specific part of the conversation you're asking about
* Break complex questions into smaller parts

#### Bito doesn't see my Jira ticket

**Check:**

1. Is your Bito account connected to Jira?
2. Did you mention the exact ticket ID (e.g., `PROJ-123`)?
3. Do you have access to that ticket in Jira?

**Solution:** Verify integrations are configured in your Bito account settings.

#### I need to remove Bito from a channel

**Steps:**

1. Open the channel
2. Click the channel name to view details
3. Go to the **Integrations** tab
4. Find Bito and click **Remove**

Bito will no longer see messages or respond in that channel.

## Frequently Asked Questions

#### Does Bito read all messages in a channel?

Bito only reads messages in threads where someone mentions `@Bito`. It doesn't process or store messages from conversations where it's not mentioned.

#### Can I use Bito in private channels?

Yes. Invite Bito to private channels the same way you would invite any team member. Only people in that private channel can interact with Bito there.

#### How much does Bito AI Assistant cost?

Bito AI Assistant is included in Bito's paid plans. Check [bito.ai/pricing](https://bito.ai/pricing) for current plan details and features.

#### Does Bito learn from our conversations?

Bito uses conversation context to provide better responses during that discussion. Your team's specific conversations are used to improve responses within your Bito account but are not used to train public AI models.

#### What happens if I exceed my plan limits?

Bito will notify you when you approach plan limits. Responses may be rate-limited if you exceed usage caps. Upgrade your plan to increase limits.

#### Can I use Bito for customer support channels?

Yes, but consider privacy implications. Bito reads all messages in threads where it's mentioned. Only use it in channels where AI assistance is appropriate.

## Next steps

Now that you understand how Bito AI Assistant works:

1. **Invite Bito** to your most active project channels
2. **Try common use cases** like summarizing threads or extracting action items
3. **Share with your team** so everyone knows how to use `@Bito`
4. **Experiment** with different types of questions to discover what works best for your workflow

Welcome to faster, smarter team collaboration with AI assistance right in Slack.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
