---
description: View the Contact assignment activity on the platform.
title: Reports: Assignments
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[New🌍 WhatsApp API Calling is now available globally! Start making calls with respond.io today. Learn more![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](/whatsapp-business-calling-api)

Help me with... ⌘ 

1. [All Collections >](/help)
2. [ Product >](/help/product)
3. [ Dashboard & Reporting >](/help/dashboard-reporting)
4. Reports: Assignments

# Reports: Assignments

![Avatar](https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg)

Joshua Lim

· 28 Aug 2025

2 min read

The Assignments report provides an insight into how Contact assignments are working and if the assignments are done effectively on the platform. You can learn the total number of assignments and number of assignments done by source, as well as gain deeper insights on each Contact assignment that happened within a selected period.

## Getting Here

Navigate to the **Reports** module and click **Assignments**.

## Filters

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/7G2liKuR6jQe4qfp6Bn9CT/b5fc656ac7353718dbc7ddbebaeb4ac1/reports-filter.png?fm=jpg&q=80&w=483) 
* Frequency and date — Select a date range from the drop-down list to be applied to the report. Alternatively, you can define the date range by frequency. The following options are available:  
   * Today  
   * Yesterday  
   * Last 7 Days  
   * Last 14 Days  
   * Last 30 Days  
   * This Month  
   * Last Month
* +Add Filter — You can refine the view of the report components by adding more filter(s). The following filters are available:  
   * Source  
   * Assigned To  
   * Assigned By User  
   * Contact - Search the Contact by Contact name and Contact ID. Use Contact filter to see the assignments for the specified Contact.  
   * Conversation ID - Filter by conversation ID to view the assignments that occurred in one conversation. As a manager, you can use this filter to analyze why certain conversations had many assignments.
* Clear All — You can use this option to reset the filters to the default selections.

> You may encounter a chart with the following message displayed:

\- _The selected filter(s) are not applicable here_: This means the filter(s) you have selected are not applicable to the chart.- _The selected filter(s) have no applicable data_: This means no data is available for the selected filter(s), for e.g. the chart is new and only available at a date later than the selected date range.

## Report Components

### Contact Assignments

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3boqsD3ulPBIURJuMEiKAI/3f1e6f2459977d8bfef362e27dd8390d/assignments-contact-assignments.png?fm=jpg&q=80&w=640) 

**Metric**

The number and percentage of Contact assignments within the selected period by sources.

> Unassignment will also be counted as an assignment.

The ways to assign and unassign a Contact are as follows:

| Source                      | Description                                                                                                                                          |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Developer API               | The Contact was assigned by Developer API.                                                                                                           |
| Workflow                    | The Contact was assigned by Workflow step.                                                                                                           |
| Bot                         | The Contact was assigned by Dialogflow bot.                                                                                                          |
| Zapier                      | The Contact was assigned by Zapier action.                                                                                                           |
| Make                        | The Contact was assigned by Make action.                                                                                                             |
| User                        | The Contact was assigned by user from the Messages module. It applies when a user sends an outgoing message and the Contact is assigned to the user. |
| Contact Import              | The Contact was assigned using the Contact Import feature where the assignee is indicated for the Contact in the Assignee column in the CSV file.    |
| Close Conversation (Legacy) | The Contact was unassigned when a conversation is closed.                                                                                            |
| Click-to-Chat Ad            | The Contact was assigned when they clicked an advertisement and sent a message.                                                                      |

> Different sources will be displayed in this report depending on the selected period.

**Bar Chart**

The number of Contact assignments within the selected period by sources.

**Pie Chart**

The percentage and total number of Contact assignments within the selected period by sources.

### Contact Assignments Log

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3gy1dXmcHgAffUyEd7lGQo/50f75452961683f473952265cb8ef83e/assignments-contact-assignments-log-2.png?fm=jpg&q=80&w=640) 

Here are the insights you can gain from each Contact assignment that happened.

Learn more about each column in the following table:

| Table Headers     | Description                                                                                        |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| Timestamp         | The date and time when the Contact was assigned.                                                   |
| Conversation ID   | The Conversation ID of the Contact where that assignment happened.                                 |
| Contact ID        | The Contact ID of the Contact assigned.                                                            |
| Contact Name      | The name of the Contact assigned.                                                                  |
| Previous Assignee | The previous assignee of the Contact. If there is no previous assignee, this will be shown as “-”. |
| Assigned To       | The new assignee of the Contact.                                                                   |
| Source            | The source of assignment.                                                                          |
| Assigned By       | The user who assigned the Contact to the assignee. Only applicable if the source is User.          |

> Reports table has a limitation of generating a maximum of 10,000 row of results. If you need more data, consider using [Data Export](https://respond.io/help/workspace-settings/data-export).

## FAQ and Troubleshooting

### What happens when a returning Contact already has an assignee?

When a returning Contact with an existing assignee opens a new conversation, it does not prompt an assignment activity. This means that no number will be added to the _Contact Assignments_ chart and no data will be added to the _Contact Assignments Log_.

For example, the conversation with Joe has ended and closed, but it remains assigned to Agent Fox. The same Contact, Joe, returns with another question, opening a new conversation. Because Agent Fox has remained as the assignee from the previous conversation, Joe will automatically appear in Agent Fox’s **Mine** inbox. The platform will consider this as no assignment has happened.

Share this article

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/dashboard-reporting/reports-assignments)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/dashboard-reporting/reports-assignments)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/dashboard-reporting/reports-assignments)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/dashboard-reporting/reports-assignments)

## 

Related articles 👩‍💻

* [Reports: CallsTrack and analyze call performance across your Workspace. ](/help/dashboard-reporting/reports-calls)
* [Reports: Lifecycle Discover how Lifecycle Reports tracks leads from new to paying customers, measuring conversions, drop-offs, and time metrics for an optimized funnel. ](/help/dashboard-reporting/reports-lifecycle)
* [Reports: BroadcastsView the delivery rates of broadcasts to gain insights into the performance and delivery data of the broadcasts. ](/help/dashboard-reporting/reports-broadcasts)
* [Reports: UsersThe Users reports tab consists of all the metrics and information related to Users. ](/help/dashboard-reporting/reports-users)
* [Reports: LeaderboardInstantly identify and analyze top performing users and teams in the Workspace. ](/help/dashboard-reporting/reports-leaderboard)

Can't find what you're looking for? 🔎

[Contact Support](/contact-us)

2025-12-05T03:58:39.785Z

help

```json
[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"View the Contact assignment activity on the platform.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg","name":"Joshua Lim","url":"https://respond.io/author"},"dateCreated":"2023-10-12T09:24:29.000Z","dateModified":"2025-08-28T08:49:58.308Z","datePublished":"2023-10-12T09:24:29.000Z","headline":"Reports: Assignments","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/7G2liKuR6jQe4qfp6Bn9CT/b5fc656ac7353718dbc7ddbebaeb4ac1/reports-filter.png","mainEntityOfPage":"https://respond.io/help/dashboard-reporting","publisher":{"@type":"Organization","logo":"https://respond.io/favicon/favicon.svg","name":"respondio"},"thumbnailUrl":"https://assets2-proxy.respond.io/ph8r57dk1q9w/7G2liKuR6jQe4qfp6Bn9CT/b5fc656ac7353718dbc7ddbebaeb4ac1/reports-filter.png","url":"https://respond.io/help/dashboard-reporting/reports-assignments"},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Help","item":"https://respond.io/help","position":1},{"@type":"ListItem","name":"Product","item":"https://respond.io/help/product","position":2},{"@type":"ListItem","name":"Dashboard &amp; Reporting","item":"https://respond.io/help/dashboard-reporting","position":3},{"@type":"ListItem","name":"Reports: Assignments","item":"https://respond.io/help/dashboard-reporting/reports-assignments","position":4}]}]
```
