> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Permissions & Team Collaboration

> Learn how to assign conversations and collaborate inside Inbox, including manual assignment and automatic distribution across the team.

When multiple people are working in Inbox at the same time, you need a clear way to decide who handles which customer and who is currently working on what. **Assign Conversation** and **Auto Assign** help you do that without constant manual coordination.

## 1. Create an Inbox Team

Before assigning conversations, group your team members first.

**How to create one:**

1. Go to **Settings -> Inbox Team**.
2. Click **Create Inbox Team**, then enter a team name such as "Sales Team" or "Support Team".

   <Frame>
     <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-172.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=8c09d158bf062b24a31a0e130e542176" alt="create_inbox_team" width="3000" height="1175" data-path="images/image-172.png" />
   </Frame>
3. Select the team members and save.

   <Frame>
     <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-173.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=630a70f4bf5742c1526e3c72b9330c6c" alt="select_user_inbox_team" width="2407" height="1228" data-path="images/image-173.png" />
   </Frame>

## 2. Assign a chat manually to a person or team

When you are viewing a conversation and want to assign it to a specific person:

1. Open the conversation in Inbox.
2. Look at the top area and find **Assign Conversation**.
3. Choose the team member or team that should take over.

The assigned person receives a notification and knows the conversation is now theirs to handle.

<Frame>
  <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-174.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=97a79360dfc9ce55eb89b90d1f9ecee5" alt="assign_conversation_manual" width="3014" height="1731" data-path="images/image-174.png" />
</Frame>

## 3. Configure automatic assignment in Flow Builder

If you do not want to assign chats manually one by one, set it up directly in the Flow so the system handles it automatically:

1. In **Flow Builder**, add an **Action** block.
2. Choose **Inbox Actions -> Assign Conversation**.
3. Select the target team member or team.

For example, when a customer chooses "I need pricing support", the Bot can automatically assign that conversation to the Sales team without any manual step.

<Frame>
  <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-175.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=4b8eb3c7c5db74dc5901ddd3b5c39662" alt="assign_conversation_flow" width="3014" height="1731" data-path="images/image-175.png" />
</Frame>

## 4. Distribute chats automatically across the team

**Auto Assign Conversation** helps the system distribute chats fairly across available online team members so no one gets overloaded and no one stays idle.

**Available distribution modes:**

| Mode              | What the system does                                                      |
| ----------------- | ------------------------------------------------------------------------- |
| **All Time**      | Distributes based on each team member's total chat volume over time.      |
| **Last 1 Hour**   | Prioritizes the person who handled the fewest chats in the last hour.     |
| **Last 8 Hours**  | Prioritizes the person who handled the fewest chats in the last 8 hours.  |
| **Last 24 Hours** | Prioritizes the person who handled the fewest chats in the last 24 hours. |

<Frame>
  <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-176.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=11c3f787541cbbbb8e81bc6ab62f569a" alt="auto_assign_conversation_flow" width="3014" height="1731" data-path="images/image-176.png" />
</Frame>

## 5. Handle cases where no one is online

When you use Auto Assign in Flow Builder, you will see 2 result branches:

* **Success**: The system found an available team member and assigned the chat successfully. The Flow continues through this path.
* **Failure**: No team member is online or available, so the Flow moves into the fallback path.

**Practical tip:**\
On the **Failure** branch, add an automatic message such as *"Sorry, our support team is busy right now. We will get back to you as soon as possible."* This prevents customers from waiting with no reply at all.
