> Усі статті WIKI Helomi: /wiki/llms.txt

# Завдання

Завдання (задача) — дія з терміном і відповідальним: подзвонити, надіслати рахунок, перевірити оплату. Задачу можна прив'язати до угоди або клієнта, дати їй тип, пріоритет, чек-лист, нотатки й файли; усі задачі з карток угод і клієнтів збираються в одному розділі «Завдання».

## Можливості
- Один список усіх задач з угод, клієнтів і вільних; блок «Завдання» в картці угоди й вкладка «Задачі» в картці клієнта.
- Три вигляди: «Дошка» (по днях або по статусах, з перетягуванням), «Список», «Архів»; вид за замовчуванням обираєте ви.
- Типи завдань з іконками; тип підставляє назву задачі.
- Статуси «У роботі», «Відкладено», «Виконано»; пріоритети «Терміновий», «Високий», «Звичайний», «Низький».
- Червона цифра біля пункту меню «Завдання»: ваші задачі на сьогодні й прострочені.
- Швидке створення з будь-якої сторінки — Alt+Shift+T.
- Масові дії з вікном прогресу; доступ «лише свої / усі».
- Задача автоматично, коли угода приходить на етап.
- Імпорт і експорт XLSX у форматі KeepinCRM.

## 1. Налаштування
- **Поля й типи** — «Налаштування → Типи даних → Завдання» (з розділу — «⋮ → Налаштувати поля», видно адміністратору). Тут «Типи завдань» (назва й іконка, «+ Додати», порядок перетягуванням; тип, у якого вже є задачі, лише архівується) і «Поля завдань»: вбудовані й власні поля з позначками «обов'язкове», «при створенні», «у списку». Поля клієнта з позначкою «Також відображати у розділах → Завдання» видно в задачі під «Клієнт».
- **Доступи** — у «Налаштування → Розділи меню» (або в картці людини в «Користувачі»): «Завдання» (сам розділ), «Завдання: усі, не лише свої» (без галочки людина бачить лише задачі, де вона відповідальна або автор), «Завдання: масові дії».
- **Задача на етапі** — «Налаштування → Воронки й етапи», кнопка «завдання» в рядку етапу (див. розділ 8).

## 2. Створити завдання
1. У розділі «Завдання» натисніть «+» (або Alt+Shift+T на будь-якій сторінці). У картці угоди — «+» у блоці «Завдання», у картці клієнта — на вкладці «Задачі».
2. Заповніть назву (або виберіть тип — назва підставиться), головного відповідального (типово ви), дату й час завершення, статус, за потреби пріоритет, контакт, коментар і додаткові поля.
3. У розділі «Завдання» в полі «Угода або клієнт» знайдіть, до чого прив'язати задачу, або залиште її вільною.
4. Збережіть. Задача з'явиться в списку, у картці угоди чи клієнта і в журналі.

## 3. Знайти свої задачі: список, фільтри, лічильник
1. Відкрийте «Завдання» → «Список».
2. Швидкі фільтри: «Усі активні», «Прострочені», «На сьогодні». Кнопка «Прострочено: N» у шапці теж відкриває прострочені.
3. Пошук: назва, опис, клієнт, угода, телефон.
4. «Фільтри»: статус, відповідальний, «Лише мої», тип, пріоритет, дата завершення від і до, додаткові поля.
5. У «⋮» шапки: «Налаштування колонок», «Імпорт», «Експорт», «Налаштувати поля», «Зробити «…» видом за замовчуванням».
6. У «⋮» рядка: «Редагувати», «Відкрити», «Завершити», «Видалити».

Прострочена задача позначена червоною смужкою; термін — червоним.

## 4. Дошка
- «Дошка» → «По днях»: колонки «Прострочені», «Сьогодні», «Завтра», наступні дні, «Пізніше», «Без терміну». Перетягніть картку в іншу колонку — дата завершення зміниться.
- «По статусах»: перетягування міняє статус.
- Сортування карток — за терміном або за відповідальними.

## 5. Сторінка завдання
«⋮ → Відкрити» або «Відкрити сторінку завдання →» веде на окрему сторінку: усі поля (значення змінюються на місці), прив'язка до угоди чи клієнта (змінити або «Прибрати угоду» / «Прибрати клієнта»), чек-лист (новий пункт і Enter, порядок перетягуванням), нотатки, файли (квадратики-прев'ю, як в угоді), «Історія» всіх змін.

## 6. Завершити і повернути в роботу
- Галочка в рядку, «⋮ → Завершити» або кнопка «Завершити» з галочкою на сторінці задачі ставить статус «Виконано», і задача переходить в «Архів».
- В «Архіві» — «⋮ → Відновити» або «Відновити» на сторінці задачі повертає її в роботу.

## 7. Масові дії
1. У «Списку» позначте задачі галочками.
2. На панелі: «Завершити», «Статус», «Відповідальний», «Дод. поле» (встановити або очистити), «Видалити». В «Архіві» — лише «Видалити».
3. Вікно прогресу показує «Опрацьовано N з M» і підсумок; задачі з помилками — посиланнями.

Без доступу «Завдання: масові дії» галочок нема, а замість панелі — пояснення.

## 8. Завдання автоматично на етапі угоди
1. «Налаштування → Воронки й етапи» → у рядку етапу кнопка «завдання».
2. Вкажіть тип або назву завдання, термін «через N годин», відповідального (відповідальний угоди, хто перевів угоду, або конкретна людина) і коментар.
3. Щойно угода приходить на цей етап, по ній створюється задача.

## 9. Імпорт і експорт
«⋮ → Імпорт» (потрібен доступ до масових дій) і «⋮ → Експорт». Дублі при імпорті шукаються за назвою завдання. Покроково — стаття «Імпорт і експорт».

Нагадувань і push-сповіщень про задачі поки нема: поле нагадування API приймає і зберігає, але воно ніде не спрацьовує.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Вкажіть назву задачі» | Порожня назва і не вибрано тип | Впишіть назву або виберіть тип |
| «Заповніть обов'язкове поле «…»» | Поле обов'язкове в «Типах даних → Завдання» | Заповніть поле |
| «Відповідального #… нема в довіднику» | Людини нема серед користувачів CRM | Виберіть людину зі списку |
| «Поле «…» не змінюється масово (тип «…»)» | Посилання, формули, мультивибір масово не змінюються | Змініть поле в кожній задачі окремо |
| «Немає доступу до масових дій із завданнями (імпорт)» | Не відкрито «Завдання: масові дії» | Попросіть адміністратора відкрити доступ |
| Видно лише частину задач | Не відкрито «Завдання: усі, не лише свої» | Попросіть адміністратора, якщо потрібні всі |

## Для ШІ-співробітників
Ключ розділу — `tasks` (`describe_section("tasks")`). Потрібен доступ «Завдання».

| Інструмент | Що робить |
| --- | --- |
| `tasks_list` | Список з `q` і фільтрами `status` (`open`, `overdue`, `today`, `done`, `in_work`, `postponed`, `all`), `responsible_id`, `mine`, `overdue`, `due_from`, `due_to`, `deal_id`, `client_id` |
| `tasks_get` | Одна задача |
| `tasks_refs` | Відповідальні, статуси, типи, поля |
| `tasks_create` | Нова задача: `values` з `title`, `due_at`, `assignee_id`, за потреби `deal_id` чи `client_id`, `type_id`, `priority`; передавайте `idempotency_key` |
| `tasks_update` | Змінити або закрити задачу: `status` = `done` завершує, новий `due_at` переносить термін |
| `tasks_delete` | Видалити задачу. **Спочатку запитати** (вид `delete`) |

Задачу по угоді можна створити й інструментом `deals_add_task`. Інструментів для чек-листа, нотаток задачі, масових дій, імпорту й експорту поки нема.

Чого не робити:
- Не ставити задачу людині, якої нема в `tasks_refs`.
- Не видаляти чужі задачі без прохання людини.
- Не повторювати дію з `pending_id` — вона чекає підтвердження.

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md), [Клієнти](clients.md), [Імпорт і експорт](import-export.md).