Метод для создания новой задачи.
При создании задачи обязательным условием является указания типа задачи: звонок, встреча, напоминание, событие или письмо. При этом не требуется дополнительное описание - вы просто создадите задачу с соответствующим текстом. Если вы укажите описание задачи - то именно оно и станет текстом задачи.
У задачи должны быть ответственные, если их не указывать - ответственным назначаетесь вы.
Ответственным для задачи без привязки к каким-либо сущностям может стать любой сотрудник компании. Актуальный состав сотрудников компании вы можете получить в методе список сотрудников.
Запрос
|
|||
---|---|---|---|
task | object* | Собранный объект параметров создаваемой задачи | |
kind | string* | Тип: call (позвонить контакту), meeting (встреча), reminder (напоминание), event (событие), email (написать письмо) | |
content | string | Описание (по умолчанию - название типа) | |
due_at | string | Срок выполнения задачи (ISO-8601) в формате YYYY-MM-DDThh:mm:ss.sssTZD. Если указано время 23:59:59.000, то задача будет создана на весь день (без указания времени). | |
priority | integer | Приоритет: 1 (по умолчанию), 2 (важно) или 3 (очень важно). | |
performer_ids | array of integers | Массив идентификаторов пользователей, привязываемых к задаче как «ответственные» (по умолчанию ответственным назначаетесь вы) | |
Ответ
|
|||
data | object | Созданная задача | |
id | integer | Идентификатор созданной задачи | |
kind | string | Тип | |
content | string | Описание | |
due_at | string | Срок выполнения задачи (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ | |
priority | integer | Приоритет | |
user_id | integer | Идентификатор пользователя-создателя задачи | |
status | string | Статус задачи (активная - undone) | |
created_at | string | Дата и время создания задачи (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ | |
performer_ids | array of integers | Массив идентификаторов пользователей, привязанных к задаче как «ответственные» | |
Возможные ошибки запроса (errors code)
|
|||
blank | Поле не может быть пустым | ||
too_long | Поле не может содержать более 65535 символов | ||
inclusion | Поле имеет непредусмотренное значение | ||
invalid | Поле имеет неверное значение (например, указаны недопустимые ответственные) | ||
|
{
"task": {
"kind": "reminder",
"content": "Забрать со склада 21 заказ",
"due_at": "2020-06-05T12:00:00.000+0300",
"priority": 2
}
}
{
"data": {
"id": 22283,
"kind": "reminder",
"content": "Забрать со склада 21 заказ",
"due_at": "2020-06-05T09:00:00.000Z",
"priority": 2,
"user_id": 12,
"status": "undone",
"created_at": "2020-06-04T10:37:57.000Z",
"performer_ids": [
12
]
}
}