Метод для создания новго напоминания.
При создании напоминания обязательным условием является указания типа напоминания: звонок, встреча, простое напоминание, событие или письмо. При этом не требуется дополнительное описание - вы просто создадите напоминание с соответствующим текстом. Если вы укажите описание напоминания - то именно оно и станет текстом напоминания.
У напоминания должны быть ответственные, если их не указывать - ответственным назначаетесь вы.
Ответственным для напоминания без привязки к каким-либо сущностям может стать любой сотрудник компании. Актуальный состав сотрудников компании вы можете получить в методе список сотрудников.
Запрос
|
|||
---|---|---|---|
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 | Массив идентификаторов пользователей, привязываемых к напоминанию как «ответственные» (по умолчанию ответственным назначаетесь вы) | |
custom_properties | array of objects | Задаваемые дополнительные поля | |
id | integer | Идентификатор поля | |
value | string | Устанавливаемое значение | |
Ответ
|
|||
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 | Массив идентификаторов пользователей, привязанных к напоминанию как «ответственные» | |
custom_properties | array of objects | Дополнительные поля напоминания | |
id | integer | Идентификатор поля | |
name | string | Название поля | |
data_type | string | Тип поля (string, number, date или link) | |
value | string | Значение | |
Возможные ошибки запроса (errors code)
|
|||
blank | Поле не может быть пустым | ||
too_long | Поле не может содержать более 65535 символов | ||
inclusion | Поле имеет непредусмотренное значение | ||
invalid | Поле имеет неверное значение (например, указаны недопустимые ответственные) | ||
|
{
"task": {
"kind": "reminder",
"content": "Забрать со склада 21 заказ",
"due_at": "2020-06-05T12:00:00.000+0300",
"priority": 2,
"custom_properties": [
{
"id": 78,
"value": "Синий склад"
}
]
}
}
{
"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
],
"custom_properties": [
{
"id": 78,
"name": "Место",
"data_type": "string",
"value": "Синий склад"
}
]
}
}