Falaah Falaah AI

Task Management

Track, assign, and complete tasks with Muin's centralized task queue. Workflow-generated and manual tasks land in one inbox and route to the right person.

Tasks are the human side of automation. When a workflow needs a decision, a document requires review, or a team member needs to take action, Muin creates a task and routes it to the right person. The Tasks module gives everyone a single inbox for all their pending work.

Task Concepts

Task Sources

Tasks arrive from two sources:

Source Description
Workflow-generated Created automatically when a workflow reaches a step requiring human input
Manual Created directly by team members for ad-hoc work items

Task Properties

Every task includes:

  • Title and description explaining what needs to be done
  • Priority - low, medium, high, urgent or critical
  • Status - pending, in progress, completed, cancelled, escalated or expired
  • Due date for time-sensitive items
  • Assignee who is responsible
  • Linked entities such as documents, invoices, or vendors

Who a Task Can Be Assigned To

A task is assigned to a specific person or to a role - for example manager or ap_clerk. A role-assigned task is visible to everyone holding that role, and whoever acts on it first resolves it.

There is no separate queue object. A task assigned to a role is the queue.

A task can also carry an escalation target, which is the person it goes to when nobody acts in time. That escalation is automatic and configured on the workflow or approval rule, not chosen in the inbox.

Task Types

Tasks carry a type from a fixed vocabulary rather than free text, which is what lets each type render the right controls. The common ones:

Type What it asks for
approval Approve or reject something
review Look at something and confirm it
decision Choose between options
acknowledgment Confirm you have read something
data_entry / document_upload Supply something missing
verification Confirm a fact against a source
signature Sign a document
needs_information Answer one question an agent needs to continue
heads_up No action. You are being told
compliance_action Close a compliance or readiness gap
follow_up / reminder / escalation Chase something

Alongside those sit module-specific types - volunteer hours and expense approvals, in-kind triage and appraisal, pickup refusals and no-shows, waitlist promotions, refund reviews, board motion follow-ups, form submission reviews and others. The full set is fixed: a task type outside it is rejected rather than silently stored.


Your Inbox

Finding it

Sidebar → Workspace → Inbox. The header reads Inbox - “Everything that needs your attention” - with a count badge of what is pending.

Typing /tasks takes you to the same place.

The tabs

Tab What it holds
Inbox Everything waiting on you, grouped into New, Earlier and FYI
Donors The donor lane, when you have permission for it
My Requests Things you sent to other people, and where each one stands
Overview Your team’s workload - bottlenecks, throughput, auto-approve rates
Audit The record of what was decided and by whom

The list loads more as you scroll. Your tab and filters survive a reload and a shared link, so you can send a colleague the exact view you are looking at.

Filtering and Sorting

Filter Options
Category All Categories, Approval, Review, Action, Follow-up, Escalation, Reminder, Integration, Agent findings, Heads Up, Facility approvals, Event approvals, and the AI Draft categories
Priority All Priorities, Critical, High, Medium, Low
Sort Priority, Due date, Newest first

Clear Filters resets them.


Working with Tasks

Acting on a task

What you can do depends on the task. Most tasks declare their own outcomes and the card shows exactly those buttons, so you are never guessing which action the workflow expects.

For an approval task you get Approve and Reject:

  1. Open the task in your inbox.
  2. Read the description and anything linked to it.
  3. Click Approve. You can add a note - “anything the team should know: a condition, a caveat, why you said yes” - and the approval confirms before it goes through.
  4. Or click Reject, which requires a reason.

A categorization task offers Confirm Classification or Correct Classification, where correcting it asks for the right Document Type and Module.

A needs_information task is a single question from an agent that cannot finish without it. It shows the question, a Your answer field, and two buttons: Answer and Cannot answer. Saying you cannot answer is a real outcome, not a dead end.

Some tasks are decided on another screen. Those show a Review and decide link straight to it rather than pretending the decision can be made from the card.

Doing several at once

Select multiple tasks and use Approve All or Reject All. The result is reported per item, not as a single count: when some are refused you are told how many were done and that the rest “still need you, and they are still selected” - so nothing is quietly skipped.

Creating a task

Click New Task in the header to add an ad-hoc item for yourself or a colleague.

Handing your inbox over

Click Delegate to set up delegation rules - who receives your tasks while you are away, and within what scope. Delegations apply to new tasks from the point you set them, not retroactively. The same mechanism backs the Coverage page.

Chasing something you sent

On My Requests, a request waiting on somebody else offers Nudge. It reminds the approver and tells you “We reminded the approver. You can nudge again tomorrow.” - once a day, so a nudge stays meaningful.


Task Dashboard

The Task Dashboard provides an at-a-glance summary of your team’s workload:

Metric What It Shows
Total open tasks Number of tasks awaiting completion
My tasks count Tasks assigned to you
Overdue tasks Items past their due date
Completion rate Tasks completed vs. created this period
Priority breakdown Distribution across priority levels

Access the dashboard from Tasks > Dashboard.


Creating Tasks Manually

Not all tasks come from workflows. Create tasks for ad-hoc work:

  1. Click New Task from the Inbox header
  2. Fill in the task details:
    • Title (required)
    • Description
    • Priority
    • Due date
    • Assignee - a person, or a role so that whoever is free picks it up
  3. Optionally link to a document, vendor, or other entity
  4. Click Create

The task type vocabulary is listed under Task Types above.


Additional Workflows

Workflow-Generated Tasks

When a workflow reaches a human-decision step, it automatically creates a task with:

  • Pre-filled title and description from the workflow configuration
  • A link back to the triggering document or entity
  • A deadline calculated from the workflow’s timing rules
  • Assignment based on the workflow’s routing logic

Completing or rejecting the task sends the result back to the workflow, which then proceeds to the next step.

Batch Operations

For teams with high task volumes:

  • Filter by category or priority, then select several tasks and use Approve All or Reject All
  • Set up a delegation rule so a colleague receives your tasks while you are away
  • Use the Overview tab to see bottlenecks, throughput and auto-approve rates across the team

Tips

  1. Check your inbox daily. Tasks with due dates generate reminders, but staying proactive prevents backlogs.
  2. Watch the role-assigned items. A task assigned to your role is waiting for whoever gets there first - if everyone assumes somebody else has it, nobody does.
  3. Add completion notes. Future audits and team members benefit from knowing what action was taken and why.
  4. Link tasks to entities. A task linked to a document or vendor record provides instant context when you open it.
  5. Set realistic due dates on manual tasks. Overly tight deadlines erode trust in the system.

Common Issues

What you see Why What to do
“All caught up!” / “Nothing is waiting on you right now.” Your inbox is genuinely empty Things you sent to other people are under My Requests - the empty state links you there
“No items match your filters” A filter is hiding everything Click Clear Filters
“Failed to complete task” / “Failed to approve task. Please try again.” The action did not land Retry. The task is unchanged, so nothing was half-done
“Nothing was changed. None of these could be done:” after a batch Every item in the batch was refused, each for its own reason Read the reasons listed; the items stay selected
“<n> done. <n> still need you, and they are still selected.” A batch partly succeeded Work the remaining ones individually - they are already selected
“We could not record your answer.” on a needs_information task The answer did not save “Nothing was changed, so your answer is still here. Try again.”
“Follow-up is not available…” There is nobody to reply to Resolve it another way
Workflow not advancing after you completed a task The workflow is paused or inactive Open the run from Automation → Overview and check its status
The Donors tab is missing You do not have donor lane permission Ask an admin. A ?tab=donor-lane link falls back to Inbox rather than erroring
Overdue notification but the task is done It was completed after the due date The flag clears after completion; no action needed


Need Help?

If tasks are not appearing or workflows are not advancing after task completion:

  1. Verify the workflow is active and properly configured
  2. Check that your user role has permission to view tasks in the relevant queue
  3. Review the task detail view for error messages or missing links
  4. Contact support through the in-app help widget for further assistance