# Tasks

Tasks are used in your Scripts to generate **Letters** or send **Emails**, or simply to create **Notes** to convey information to the host or back-office system.

Scripts can collect various items of information for use in Tasks via [Databoxes ](/product-suite/admin/entities/databoxes.md)from either the Host System or entered via the Operator.

<figure><img src="/files/PjzdRmRyCYTtEXjgXOa5" alt=""><figcaption><p>The Tasks tab</p></figcaption></figure>

### User Experience

For Contact Centre or staff use, any Task details will be presented on the Results page and optionally require action to continue:

<figure><img src="/files/44vXbDOWbYVJvZBYQD2e" alt=""><figcaption><p>The Results page showing a Letter task</p></figcaption></figure>

### Properties

**Group** - Tasks can be arranged into groups so that they appear together in the left hand Task Selection list.

{% hint style="info" %}
**TIP** When creating/editing a Task, you can either select a group from the drop down list or type a name to create a new group.
{% endhint %}

**Code** – a unique code for the Task. This code may be alphanumeric up to a maximum 15 characters. If you can, make the code meaningful so that it is easily identified when viewed within your Scripts. Codes must be unique.

**Short description** – a brief description of what the Task will do.

**Full description** - a detailed description of what the Task will do.

**Default priority** – the Default priority assigned to the Task. When this Task code is used within a Script it will be assigned the default priority.

{% hint style="info" %}
**NOTE** For a priority to override the default it must appear in the script *after* the code, rather than before it. If two codes are being picked up, the priority must appear after the code it is overriding, but before the second code.
{% endhint %}

### Task Templates

Templates are used to create Letters, Emails or Notes to be actioned as part of the Task. The Task Templates shows all the Templates attached to the Task.&#x20;

#### Add Template

The drop down list displays the list of ‘base task templates’ to include with your task

To edit the template once you have added it to the task, click the ellipsis button as highlighted below; this will open the Editing pane:

<figure><img src="/files/PjlPTTWrNGuGoRtvSMsL" alt=""><figcaption><p>A Task showing the 'Add Templates' dropdown menu and 'edit' buttons  </p></figcaption></figure>

#### Add Item

Add an attachment, for example, an advice leaflet, to a Template by selecting the '**+**'.

The drop down list contains the options of a Continuation (opens a new blank page with editor) or, an Enclosure if linked to a **Letter** or an Attachment if linked to an **Email**:

<figure><img src="/files/jSdLDOvR4r9oplslyPEu" alt=""><figcaption><p>A Task showing the Add Item dropdown menu</p></figcaption></figure>

{% hint style="info" %}
**TIP** Move multiple Tasks into a group by either holding Shift whilst clicking to select a block of Tasks, or by holding Ctrl whilst clicking to select multiple Tasks and then drag them into the desired group in the Task Selection list.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keyfax.biz/product-suite/admin/entities/tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.