Skip to content
Last updated

Work the task queue

The task queue is how the CRM distributes work to agents. Tasks appear in the left panel of the CRM main page and represent actions you need to take — answering a call, reviewing a case, replying to a message, or following up on a scheduled interaction. Tasks are routed to you based on your team assignments, queue configuration, and availability.

Availability: All clients Required permissions: taskrouter.task:receive (to receive tasks in the queue)

If you do not have the taskrouter.task:receive permission, the task panel displays: "You do not have permissions to receive tasks. Please reach out to your administrator if you are expecting tasks."

Before you begin

  • Your administrator must assign you to one or more task queues through the Task Worker Pairing Configuration (TWPC). If you have the correct permission but see no tasks, confirm your queue assignments with your administrator.
  • You must be in an active (online) status to receive tasks. The task panel header shows your current activity status.

View your task queue

From the CRM main page, the task queue panel on the left displays your current task assignments. Each task card shows:

  • Task type (what action is needed)
  • Contact name and information
  • Timestamp
  • Case information (if the task relates to a case)

Accept a task

  1. When a new task appears in your queue, review the task card to understand what action is needed.
  2. Select the task card to accept it.

Tasks have a reservation window — shown in a tooltip on the Task Queue panel — before they return to the queue if not accepted. The default is 2 minutes, but this is configurable per workflow by your administrator.

After you accept a task, the CRM navigates you to the relevant page:

  • Case-related tasks (escalations, auto-created cases, snoozed cases, document uploads, scheduled calls, AI case reviews) navigate to /crm/borrowers/:borrowerId/cases/:caseId.
  • Interaction tasks (inbound calls, texts, web chats, voicemails, emails) navigate to the interaction within its case context.

Task types reference

The task router supports 19 task types. The type determines what action you need to take and where the CRM navigates you after acceptance.

Inbound communication tasks

Task typeDescription
answerInboundVoiceCallAn incoming voice call is ringing. This task does not appear in the left task queue panel — it surfaces in the navigation bar at the top of the page with Accept with recording and Accept without recording buttons.
handleInboundInteractionAn inbound interaction (email, text, or other channel) has arrived and needs a response.
handleUnboundInboundInteractionAn inbound interaction has arrived that is not yet associated with a borrower or case. You need to identify the borrower and link the interaction.
replyToNewWebChatA borrower has started a new web chat session and is waiting for a response.
replyToAbandonedWebChatA borrower started a web chat but left before receiving a response. Follow up on the abandoned conversation.
replyToNewTextA borrower has sent a new text message that needs a response.
reviewVoicemailA borrower left a voicemail that needs review and follow-up.

Case review tasks

Task typeDescription
reviewAutoCreatedCaseA case was automatically created by the system (for example, when a loan becomes overdue). Review the case details and take appropriate action.
reviewAutoUpdatedCaseA case was automatically updated by the system with new information. Review the changes and determine next steps.
reviewEscalatedCaseA case has been escalated and assigned to you for review.
reviewEscalatedCaseAgentA case has been escalated to you specifically as an individual agent.
reviewEscalatedCaseAgentUrgentA case has been urgently escalated to you as an individual agent. Treat this with higher priority.
reviewEscalatedCaseTeamA case has been escalated to your team for review.
reviewEscalatedCaseTeamUrgentA case has been urgently escalated to your team. Treat this with higher priority.
reviewCaseInstructionsA case has instructions from a supercase that need your review and action.
reviewSnoozedCaseA previously snoozed case has reached its wake-up time and needs your attention.
smartReviewCaseAn AI-assisted case review is ready. Review the AI-generated summary and take action on the case.

Other tasks

Task typeDescription
reviewDocumentUploadA borrower has uploaded a document that needs review.
makeScheduledCallA call was scheduled for this time. Place the outbound call to the borrower.

Task-specific behavior

Three task types have specialized card displays in the queue:

  • Scheduled call tasks (makeScheduledCall) show the scheduled time range, contact information, and the interaction reason.
  • AI case review tasks (smartReviewCase) show the case summary information and link directly to the AI-generated case analysis.
  • Text conversation tasks (replyToNewText) show the most recent message content for quick context.

All other task types display a standard task card with type, contact info, and timestamp.