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

# Conversation assignment

> Assign conversations to team members, manage workloads, and route contacts to the right person in the HoopAI platform inbox.

Assigning conversations to specific team members ensures accountability, prevents contacts from falling through the cracks, and makes it clear who is responsible for each relationship. Assignments in the HoopAI platform work at both the contact level and the conversation level.

## How assignment works

When a conversation is assigned to a team member, it appears in their **Personal Inbox** — a filtered view of conversations they are directly responsible for. Unassigned conversations appear in the **Team Inbox**, where any permitted user can see and claim them.

Assignment also interacts with:

* **Quick Filters** — filter by assigned user to segment the inbox by team member.
* **Workflows** — automatically assign conversations based on lead source, contact tags, time of day, round-robin rotation, or any other trigger.
* **Notifications** — assigned users receive a notification when a new conversation is assigned to them.
* **Saved views** — create views scoped to specific assignees for team lead oversight.

## Assigning a conversation manually

<Frame caption="The Quick Filters panel for filtering conversations by assigned user">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/conversations-quickfilter-assigned.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=f3cea5b1b57e4a2787819a7a079a0db8" alt="Filters panel with Engagement Score filter dropdown and AND/OR logic options" width="447" height="268" data-path="images/conversations-quickfilter-assigned.png" />
</Frame>

<Steps>
  <Step title="Open the conversation">
    Navigate to **Conversations** and click the contact whose conversation you want to assign.
  </Step>

  <Step title="Open the assignment control">
    Look for the **Assigned To** field in the conversation header or in the **Contact Details** panel on the right side of the conversation. The field shows the current assignee or "Unassigned" if no one has been assigned.
  </Step>

  <Step title="Select a team member">
    Click the **Assigned To** field to open a dropdown list of your team members. Type to search by name. Click the team member you want to assign.
  </Step>

  <Step title="Confirm assignment">
    The conversation is immediately routed to that team member's Personal Inbox. An activity entry appears in the conversation timeline noting who assigned it and to whom.
  </Step>
</Steps>

<Tip>
  You can assign a conversation to yourself by selecting your own name. This is useful when you pick up an unassigned conversation from the Team Inbox and want to claim ownership.
</Tip>

<Frame caption="Contact Details panel showing the Owner and Followers assignment fields">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/evc3PeLCJMLz3iUG/images/conversations-contact-details-panel.png?fit=max&auto=format&n=evc3PeLCJMLz3iUG&q=85&s=24658bed833f2ad21cbd2fabdd7ebc25" alt="Contact Details panel in the Conversations inbox with Owner set to Unassigned, Followers dropdown, Tags, and DND settings" width="1634" height="743" data-path="images/conversations-contact-details-panel.png" />
</Frame>

## Reassigning a conversation

To change the current assignee, follow the same steps as above and select a different team member. The new assignment replaces the previous one. Both the old and new assignees receive a notification (depending on notification settings).

To remove an assignment without assigning to someone else, click the **X** next to the current assignee's name or choose **Unassigned** from the dropdown. The conversation returns to the Team Inbox.

## Assigning via the contact record

Assignment can also be made from the contact record itself. Navigate to **Contacts**, open the contact, and locate the **Assigned To** field in the contact details. Assigning a contact here applies the assignment to all their conversations by default.

## Automated assignment with workflows

Manual assignment works well for small teams, but automating assignment ensures contacts are routed instantly based on predefined rules — no matter when they come in.

Common automated assignment methods:

| Method          | How it works                                                                                 |
| --------------- | -------------------------------------------------------------------------------------------- |
| Round-robin     | Distributes new conversations evenly across selected team members in rotation                |
| Lead source     | Routes contacts based on where they came from (e.g., a specific landing page or ad campaign) |
| Tag-based       | Assigns based on a contact tag applied by a prior workflow step                              |
| Time of day     | Routes to different team members based on working hours or shifts                            |
| Geographic area | Assigns contacts in specific regions to their local team member                              |

To set up automated assignment:

1. Go to **Automation → Workflows** and create or edit a workflow.
2. Add an **Assign User** action.
3. Choose the assignment method (specific user, round-robin, or a custom field).
4. Save and publish the workflow.

<Note>
  Automated assignment through workflows requires the contact to enter the workflow — typically triggered by a form submission, inbound message, or tag being applied.
</Note>

## Viewing conversations by assignee

<Frame caption="Opening Quick Filters from the Team Inbox toolbar">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/conversations-quickfilter-panel.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=cf5680d34f2d1e7b08db02835bfdf011" alt="Team Inbox with the filter icon highlighted to open Quick Filters" width="457" height="395" data-path="images/conversations-quickfilter-panel.png" />
</Frame>

To see all conversations assigned to a specific team member:

<Steps>
  <Step title="Open Quick Filters">
    Click the **three-line icon** next to the search bar in the Conversations inbox.
  </Step>

  <Step title="Apply the Assigned filter">
    Select **Assigned**, then choose **Assigned To** and pick the team member from the dropdown.
  </Step>

  <Step title="Save as a view (optional)">
    Click **Create View** and name the view (e.g., "Sarah's conversations") for instant future access.
  </Step>
</Steps>

<Frame caption="Quick Filters panel in the Conversations inbox for filtering by criteria">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/evc3PeLCJMLz3iUG/images/conversations-overview-filter.png?fit=max&auto=format&n=evc3PeLCJMLz3iUG&q=85&s=d71bc8e7a8beee01ef48e8280fe47b86" alt="Filters panel showing Filter Type, operator, and value dropdowns with AND/OR logic" width="756" height="262" data-path="images/conversations-overview-filter.png" />
</Frame>

To find conversations with no assigned user, select **None** under the **Assigned** filter. This is useful for identifying gaps in coverage and picking up unattended contacts.

## Following a conversation

In addition to assignment, any team member can **follow** a conversation to receive updates without being the primary assignee. Following is useful for managers who want to monitor key accounts, or for team members who collaborated on a conversation and want to stay in the loop.

To follow a conversation, open it and click the **Follow** option in the conversation header or the right-side panel. Followers appear in the contact details and can be filtered using the **Follower** quick filter.

## Assignment notifications

Team members receive notifications when:

* A conversation is assigned to them.
* A conversation previously assigned to them is reassigned to someone else.
* A contact they follow receives a new inbound message.

Notification preferences are configured per user at **Settings → My Profile → Notifications**.

## Personal inbox vs. team inbox

<Frame caption="Conversations inbox showing Team Inbox, My Inbox, and Internal Chat tabs">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/lk-fNTQdNCABKEEU/images/conversations-inbox-panel.png?fit=max&auto=format&n=lk-fNTQdNCABKEEU&q=85&s=74f305166a538788497d4f16f0d9dd04" alt="Conversations inbox header with Team Inbox, My Inbox, and Internal Chat tabs highlighted" width="540" height="304" data-path="images/conversations-inbox-panel.png" />
</Frame>

| Inbox          | Contents                                                   |
| -------------- | ---------------------------------------------------------- |
| Team inbox     | All unassigned conversations and shared queue              |
| Personal inbox | Only conversations assigned directly to the logged-in user |

Switch between views using the inbox selector at the top of the Conversations panel. If you are a team lead or admin, you can also view another team member's personal inbox via saved views or the Assigned filter.
