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

# Create and manage Tasks

> Track follow-up work, create tasks automatically from calls and texts, and assign work to people or groups.

Tasks is your team's list of follow-up work, like calling a customer back. You can add tasks yourself, and Avoca can create them for you when something happens on a call or in a text conversation.

Find it at **Channels → Tasks**. It has three tabs: **Task List**, **Automations** and **User Groups**.

## Add a task

**1. Start a new task**

On **Task List**, select **Create Task**.

**2. Fill in the details**

Enter a **Title**. It starts as "New Task", and you need one to publish. A new task starts as To Do with Medium priority. You can change the **Priority** (Urgent, High, Medium or Low) and the **Status** (To Do, In Progress, Hold, Complete or Canceled). Add a **Description** if you want more detail.

**3. Assign it**

Choose a person or a user group under **Assignee**, or leave it unassigned. To take a task yourself, select **Assign to me**.

**4. Link calls and conversations (optional)**

Select **Link call** or **Link conversation** to attach the related call or text conversation.

**5. Publish it**

Select **Publish Task**.

## Work on a task

Select a task to open it. Changes to an open task save as you make them, and a **Saved** message confirms it.

* Change the status or priority in the panel. To finish a task from the list, select the circle on its row (**Mark complete**). To reopen a closed task, open it and select **Reopen**.
* When you move a task to Complete, Canceled or Hold, or move a closed task back to In Progress, an **Update Status** window asks you to explain the change.
* Write in the **Activity** section and select **Post Comment**.
* Select **Archive** to move a task out of the active list. **Unarchive** brings it back.
* In the **Support** section, select **Report issue** to file a support ticket about the task. Tickets filed for the task's linked calls and conversations are listed there too.

If you use ServiceTitan, the panel also links to the task and the customer in ServiceTitan.

## Find the tasks you need

Search by title, or narrow the list by status, priority, assignee, source (AI or Manual), automation, template or trigger. You can also filter by the date a task was created, and by how long it has been waiting (12 hours, 24 hours or 7 days). Turn on **Archived tasks** to see archived ones. Select **Filters** to find these options.

Use the scope buttons at the top to switch between **All**, **Mine**, **My groups** and **Unassigned**. **My groups** only appears if you belong to a user group.

To save the current list, open **More actions** and select **Export CSV**. The file includes the tasks that match your filters.

## Complete or cancel many tasks at once

**1. Turn on selection**

Open **More actions** and select **Select tasks**.

**2. Choose the tasks**

Tick the tasks you want. Only active tasks that aren't archived can be closed. The bar shows how many you selected and how many of them can be closed.

**3. Complete or cancel them**

Select **Complete** or **Cancel**. A window asks for a note that applies to every selected task. Confirm with **Complete tasks** or **Cancel tasks**.

> [!WARNING]
>
> The action and the note apply to every task you selected. Select **Clear** to start over, or **Done selecting** to leave selection mode.

## Create tasks automatically

Use the **Automations** tab to have Avoca create tasks when something happens. An automation has a trigger and one or more tasks to create.

> [!WARNING]
>
> A new automation is on as soon as you create it. Use its switch, or **Automation enabled** in the editor, to pause it.

**1. Create the automation**

Select **Create Automation**, choose the **Trigger**, and enter a **Name**. Triggers you can choose include "When a Responder call is complete", "When a messaging conversation needs attention", "When a messaging conversation reaches an outcome", and "When a lead's outbound text fails to send".

**2. Choose which calls count**

For call triggers, narrow when a task is created by **Booking outcome** (Booked, Unbooked or Excused) and **Transfer status** (Transferred or Not transferred). For messaging triggers, you can narrow by **Agent** and, for outcome triggers, **Messaging outcome**. Leave a filter on "Any" to include everything.

**3. Describe the task**

Open the task template. For **Title**, **Priority**, **Status**, **Assignee** and **Description**, enter a fixed value or turn on **Generate with AI** and tell it how to fill the field in from the call or conversation. The assignee can be a person or a user group.

**4. Choose who is told**

Turn on the checkbox to email the assignee, or each member of an assigned group, when a task is assigned. Use **Also notify by email** to pick other people who get an email whenever the automation creates a task. Select **Save**.

If an automation creates more than one task, **How to handle multiple tasks** lets you choose between Create all applicable tasks and Create one task. With the second, AI picks the highest-priority or most urgent task. Select **Add task template** (or **Add another task**) to add more tasks to an automation.

## Use user groups

Open **User Groups** to organize your team for assignment. Select **Create Group**, enter a **Name** and select **Create**. On the group's card, use **Add member...** to add people, or the X beside a name to remove someone. To rename a group, edit its name and select the save icon. The trash icon deletes a group, and a deleted group can't be restored.

Groups appear in the **Assignee** list on tasks and task templates.

## More options

> [accordion] Add an Avoca call link to a ServiceTitan task
>
> If you use ServiceTitan, a task template can also create a task in ServiceTitan. This works for tasks that have a call linked to them. Turn on **Include public Avoca call link** to add a signed call details link to the ServiceTitan task description, under "\[Avoca Call Details]". The link is valid for 30 days. If Avoca can't create the link, the ServiceTitan task is still created without it.

> [accordion] Follow up when a text to a lead fails
>
> Choose "When a lead's outbound text fails to send" to get a task when an outbound text in a workflow campaign, like Speed to Lead, can't be sent. Texts that aren't part of a workflow campaign don't create a task.
>
> The task includes the customer's name and phone number, the lead source, the use case, why the text failed and the conversation ID.
>
> > [!WARNING]
> >
> > If the customer has opted out of texts, the task says so and tells you to follow up with a phone call instead of texting.

> [accordion] My Tasks pages look different
>
> Your pages can show the same tools with different labels.
>
> * **Task List**: the older layout has a date range picker, quick buttons (**All active**, **My active tasks**, **My group active tasks**, **Active unassigned**, **Stale active**, **Closed**, **All Archived** and **No filters**), summary cards, and **Select tasks**, **Export** and column controls at the top of the table. The task panel is titled **Create Task** for a new task and **View & Edit Task** for an existing one. The assignee is called **Assigned to**.
> * **Automations**: the older layout lists every automation with an **Enabled** or **Disabled** switch. Task creation filters sit under **Task Creation Filters**, and the AI option is called **AI-Generated**.
> * On newer layouts, **Create Automation** offers **From a template** and **From scratch**. Both take you through a short guided setup, with a trigger called **When this happens**, and the new automation is turned on at the end.
> * **Link call** and **Link conversation** are called **Add call** and **Add conversation**.
> * The older layout has no scope buttons, no **Mark complete** circle and no **Reopen** button. Change a task's status in its panel instead. Filters are shown above the list instead of under **Filters**. The older task panel also has no **Support** section.

> [accordion] I don't see Tasks, or I can't change automations
>
> You need the **View Tasks Page** permission to see Tasks. To create, edit or delete automations, task templates and user groups, you need the **Edit Task Automations** permission. Without it you can still look at them, but the create, edit and delete controls are hidden or locked. An admin on your team can change permissions. If Tasks is missing from your sidebar, ask your Avoca contact to turn it on for your account.
